ConnectWise Manage MCP

ConnectWise Manage + AI - ChatGPT、Claude、GitHub Copilot、Microsoft 365 Copilot、Gemini、および MCP に対応するあらゆるエージェント向け

非公式です。ConnectWise Manage API 向けにコミュニティが開発した Claude Code スキルおよび MCP サーバーです。 ConnectWise, LLC とは提携関係になく、同社の承認や後援も受けていません。

_{▶ 30 秒のデモを見る - デモデータはシミュレーションです。表示されるコマンドはすべて、実際の CLI で使用できます。}

ConnectWise PSA のあらゆるワークフローをターミナルから実行できます。型付き条件クエリビルダー、オフラインの SQLite 同期、エンティティを横断するビュー（未請求作業、アカウント 360、ボードのトリアージ）を備え、PSA のウェブ UI では実現できない機能を提供します。すでにお使いの AI で動作します。ChatGPT（Plus/Pro+）、Claude Desktop、Codex、Claude Code、Claude Cowork、GitHub Copilotに加え、リモート接続経由でMicrosoft 365 Copilot / Copilot StudioおよびGoogle Geminiにも対応しています。無料のオープンソースで、ノートパソコン上で動作します。MSP オーナー向けに開発されており、コードは不要です。

エージェントに対応

MSP オーナーが実際に使っている 6 つのエージェント（セルフサービスですぐに利用できます）：

使用する AI エージェント	ConnectWise Manage スキルのインストール方法
Claude Desktop	インストーラーを実行し、Settings > Extensions で connectwise-manage-mcp を登録します（JSON の編集は不要です）。
ChatGPT（有料プラン）	インストーラーを実行し、connectwise-manage-mcp を HTTPS 経由で公開して、Developer Mode コネクターとして登録します。
Codex CLI	以下のインストール用プロンプトを貼り付けます。
Claude Code	以下のインストール用プロンプトを貼り付けます。
Claude Cowork	以下のインストール用プロンプトを貼り付けます。
GitHub Copilot（VS Code）	インストーラーを実行し、mcp.json の servers キーの下に connectwise-manage-mcp を追加してから、Agent モードを選択します。

ChatGPT の場合は、connectwise-manage-mcp --transport http を実行して HTTPS 経由で公開します。ブリッジパッケージは不要です。mcp-install.md を参照してください。

Microsoft および Google の環境にも対応

導入先は多いものの、率直にお伝えすると、これらはリモート／エンタープライズ向けの方法であり、インストールしたばかりのローカルバイナリを使う方法ではありません。

エージェント	必要な作業
Microsoft 365 Copilot / Copilot Studio	セルフサービスではありません。 connectwise-manage-mcp を HTTPS 経由でホストし、Copilot Studio（Tools > Add a tool > Model Context Protocol > Server URL）または宣言型エージェントに接続します。Copilot Studio ライセンスとテナント管理者の権限が必要です。mcp-install.md を参照してください。
Google Gemini	Gemini CLI はローカルで動作し、Claude Code と同様です。Gemini アプリはリモートで動作し、ChatGPT と同じ HTTPS 接続方法を使います。mcp-install.md を参照してください。

スキルネイティブなエージェント（こちらも対応）： Hermes と OpenClaw は、このスキルの SKILL.md を直接読み取り、MCP にも対応しています。詳しくは以下のインストール手順を参照してください。MCP 経由で Cursor、Windsurf、Cline、Continue.dev、Zed にも対応しています。各ツールの詳細な接続方法は、docs/which-agent.md を参照してください。

複数のエージェントを使っていますか？ 1 つのコマンドで、対応する 51 以上のエージェントすべてにインストールできます：npx skills add Servosity/msp-skills@latest（Node.js が必要です。その後、CLI／MCP バイナリ用のスキル別インストーラーを実行してください）。docs/which-agent.md を参照してください。

60 秒でインストール

Claude Desktop に最速でインストール — ワンクリックの .mcpb

Claude Desktop バンドル： .mcpb は macOS（Intel および Apple Silicon）、Windows x64、Linux x64 で起動します。各ツールは、付属の connectwise-manage-cli をシェルから呼び出します。2026-09-18 以降にリリースされたバンドルには、この CLI が同梱されています。それ以前のバンドルに含まれるのは MCP サーバーのみです。お使いのバンドルに CLI が含まれていない場合は、先に以下の Path A または Path B のインストーラーを実行するか、CONNECTWISE_MANAGE_CLI_PATH に既存のバイナリのパスを設定してください。詳細： #331。

ConnectWise Manage MCP をダウンロード（.mcpb） - ダウンロード後、Claude Desktop > Settings > Extensions を開き、ファイルを選択してください。ワンクリックで完了し、JSON もシェルも不要です。（ConnectWise Manage のすべてのリリースはリリースページで確認できます。）

Claude Code プラグインを使いますか？マーケットプレイスを一度追加してからインストールしてください。ディレクトリの一覧表示は不要で、すぐに使えます。

/plugin marketplace add Servosity/msp-skills
/plugin install connectwise-manage@msp-skills

Path A — AI エージェントにプロンプトを 1 つ貼り付ける（推奨）

これを Claude Code、Codex CLI、または Claude Cowork にコピーしてください。

このエージェントのワークスペースに、Servosity/msp-skills から ConnectWise Manage Skill と MCP サーバーをインストールしてください。このワークスペースが POSIX シェル（macOS、Linux、WSL、または Bash）を使う場合は、bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.sh) を実行してください。Windows PowerShell を使う場合は、iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.ps1 | iex を実行してください。次に、README に従って認証し、connectwise-manage-cli --help を実行して機能を確認してください。

シェルを実行できるエージェントであれば、同じプロンプトを使用できます。

Path B — 自分でインストーラーを実行する

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.ps1 | iex

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.sh)

インストーラーは、connectwise-manage-cli（CLI）と connectwise-manage-mcp（MCP サーバー）の両方を、ユーザーの bin パスに配置します。Claude Code、Codex、Cowork は、このディレクトリ内の SKILL.md を使って Skill を検出します。

確認：

connectwise-manage-cli --version

最新バージョンにアップグレードする

インストーラーは常に最新リリースを取得します。アップグレードするには、再度実行してください。

macOS / Linux：

bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.sh)

Windows（PowerShell）：

iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/connectwise-manage/install.ps1 | iex

Claude Desktop の .mcpb ユーザー：このセクションの上部から最新の .mcpb をダウンロードし、Settings > Extensions で再度選択してください。Claude Code プラグインのユーザー：/plugin update connectwise-manage@msp-skills。

Claude Desktop、GitHub Copilot、Gemini CLI、Microsoft 365 Copilot、またはその他の MCP クライアントに追加する

インストーラーの実行後、エージェントごとの接続方法（GitHub Copilot の servers キーや、リモートの Microsoft 365 Copilot / Copilot Studio の手順を含む）については、mcp-install.md と docs/which-agent.md を参照してください。Claude Desktop では Settings > Extensions パネルが最も簡単な方法です。MCP の設定ブロック（JSON の編集を希望するユーザー向け）は mcp-install.md に記載されています。

Hermes にインストールする

Hermes CLI から：

hermes skills install servosity/msp-skills/skills/connectwise-manage --force

Hermes のチャットセッション内で：

/skills install servosity/msp-skills/skills/connectwise-manage --force

Hermes はネイティブで MCP に対応しているため、connectwise-manage-mcp サーバーを直接使用することもできます。インストール方法と環境変数は同じです。

OpenClaw にインストールする

OpenClaw エージェントに次の内容を伝えてください（コピーして使用できます）。

https://github.com/servosity/msp-skills/tree/main/skills/connectwise-manage から connectwise-manage スキルをインストールしてください。このスキルには、必須 CLI（connectwise-manage-cli）を openclaw: frontmatter ブロック経由でインストールする方法が定義されています。

OpenClaw はまだ一般公開されていません。frontmatter の接続設定はあらかじめ用意されており、OpenClaw の公開と同時に有効になります。

認証する

CLI に必要な認証情報を設定します。Manage インスタンス（System > Members > API Members）で作成した公開鍵と秘密鍵を持つAPI Memberと、ConnectWise の開発者ポータルで取得したclientIdが必要です。

export CW_COMPANY_ID=<your company id>
export CW_PUBLIC_KEY=<api member public key>
export CW_PRIVATE_KEY=<api member private key>
export CW_CLIENT_ID=<clientid from developer.connectwise.com>
export CW_SITE=<region host, e.g. api-na.myconnectwise.net, or your on-prem host>
connectwise-manage-cli doctor

doctor を実行すると、データに触れる処理を実行する前に認証情報が機能するか確認できます。認証情報が拒否された場合でも終了コードは 0 になるため、スクリプトでは --fail-on error を追加してください。API Member のセキュリティロールが権限の境界となるため、AI にアクセスさせたい範囲に限定してください。製品カタログの読み取り（procurement get-catalog、sync --resources procurement-catalog）には、そのロールで Procurement > Product Catalog の参照権限が必要です。ない場合、ConnectWise はカタログへの呼び出しを拒否します。

このスキルでできること

MSP でよく聞かれる質問	コマンド
今週対応したチケットのうち、作業時間がまったく記録されていないものは？	connectwise-manage-cli unbilled --since 7d
ブロック時間契約の上限に達しそうなクライアントは？	connectwise-manage-cli agreement-burn --period 30d
ヘルプデスクボードの現在の状況（経過日数、担当者、優先度）は？	connectwise-manage-cli board "Help Desk"
5 日間誰も対応していない未完了チケットは？	connectwise-manage-cli stale --days 5
次のチケットに対応できる余裕があるのは誰ですか？	connectwise-manage-cli workload
担当者が割り当てられていないチケットは？	connectwise-manage-cli board "Help Desk" --unassigned
あるクライアントの情報（連絡先、契約、構成、未完了チケット）をまとめて確認するには？	connectwise-manage-cli account AcmeCorp
API で使える正しい条件フィルターを作成するには？	connectwise-manage-cli condition build --field board/name --op = --value "Help Desk"

各種ビューに加えて、ConnectWise PSA の REST API 全体（service、time、company、finance、project、sales、procurement、system）を、型付きサブコマンドとして利用できます。service get-tickets、time post-entries、company get-companies など数百のコマンドがあり、すべて MCP ツールとしても利用できます。

コマンドの全リファレンスについては、guide.md をご覧ください。AI エージェントの運用契約（--agent、--dry-run、変更を行う前に確認すべきタイミング）については、AGENTS.md をご覧ください。

このスキルの特長

ConnectWise Manage の多くの連携や MCP サーバーは、質問ごとに API をリアルタイムで呼び出します。1 件のレコードなら問題ありません。しかし、「今月、すべてのクライアントでクローズしたチケットのうち、作業時間が記録されていないものは？」のような質問をすると、規模が大きくなるにつれて対応できなくなります。さらに、リアルタイムの呼び出しでは、厳密な条件構文を毎回組み立てる必要があり、引用符を 1 つ間違えるだけで、結果が空でもエラーにならないことがあります。

このスキルは ConnectWise Manage のデータを、全文検索機能を備えたローカルの SQLite ミラーに同期します。集計に関する質問は、1 回のローカル SQL 結合で処理できます。即座に、オフラインで実行でき、AI には生データではなく回答が渡されます。unbilled、account、agreement-burn などの複合コマンドでは、チケット、作業時間エントリー、会社、連絡先、契約、構成を結合できます。これはステートレスな API ラッパーではできません。また、ライブクエリで条件による絞り込みが必要な場合は、condition build で検証済みの条件式を組み立てられるため、API 呼び出しを最初から正しく行えます。

この問題を解決します

記録されていない作業時間は、そのまま収益の流出につながります。MSP コンサルティング会社の Bering McKinley は、その代償を率直に「請求可能時間の損失、収益性の低下、不完全なデータによる誤った意思決定、そして顧客の不満」と表現しています。また、第三者によるレビューでは、MSP コミュニティで最も一貫して報告されている ConnectWise の問題点は時間入力だとされています。技術者は時間を入力しないままチケットを完了し、Manage には完了済みチケットと記録済み時間を結び付けて確認できる単一のビューがないため、請求書の発行時まで誰も気付きません。同じように、契約の消化状況やクライアントの全体像を確認する際にも、Excel にエクスポートする習慣が見られます。データは PSA にありますが、複数のエンティティをまたいでまとめるには、ポータルの画面を次々に開くか、有料の BI アドオンを使う必要があります。

このスキルでできること：

• connectwise-manage-cli unbilled --since 7d - 今週対応または完了したチケットのうち、記録済み時間がゼロ（またはしきい値未満）のものを表示します。請求締めの前に毎回実行してください。
• connectwise-manage-cli agreement-burn --period 30d - 契約ごとの消費時間と割当時間を、上限超過フラグとともに表示します。契約枠を使い切る前に、採算の取れないクライアントを見つけられます。
• connectwise-manage-cli stale --days 5 - 更新のないまま放置されている未完了チケットを、古いものから表示します。毎日のボード整理に使えます。
• connectwise-manage-cli workload - 技術者ごとの未完了チケット数と最も古いチケットの経過日数を表示するため、次のチケットを最も余裕のある技術者に割り当てられます。
• connectwise-manage-cli account AcmeCorp - クライアントの5画面分の情報を1つのカードにまとめて表示します。

詳しい説明は問題点の背景をご覧ください。

よくある質問

ConnectWise Manage 用の MCP サーバーはありますか？

はい。これは ConnectWise Manage（現在の名称は ConnectWise PSA）用の無料のオープンソース MCP サーバーです。お使いのマシン上で動作し、クラウド版とオンプレミス版の Manage に対応しており、Claude Desktop、Claude Code、その他の MCP 対応エージェントに接続できます。すべてのインストール方法は60秒でインストールに記載されています。また、エージェントのセットアップガイドに従えば、ほかのエージェントにも接続できます。テーブルをまたいだ質問を初めて行う前に、connectwise-manage-cli sync を一度実行するか、エージェントに ConnectWise の同期を依頼してください。

ConnectWise Manage 用のその他のコミュニティ製 MCP サーバーには、WYRE の connectwise-manage-mcp と MSPStack の mcp-connectwise-psa があります。このサーバーは PSA のローカル SQLite コピーを保持するため、チケット、時間、契約を結合する質問には、クラウド版でもオンプレミス版でも API を再度呼び出すことなく、ローカルコピーから回答できます。MSPStack のサーバーも、Manage データベースに対する読み取り専用 SQL でテーブルをまたいだ質問に回答できます。README に記載されているとおり、これはオンプレミスのインストール向けです。一方、このサーバーに必要なのは API アクセスだけで、データベースのログイン情報は不要です。また、有効な conditions フィルターを書き出す condition build コマンドも備えています。

ChatGPT で使えますか？

はい。Plus、Pro、Team、Business、Enterprise、Education の各プランで利用できます（Free プランでは、まだ Developer Mode を利用できません）。ChatGPT はローカルの stdio バイナリではなく、HTTPS 経由でリモート MCP サーバーに接続します。ConnectWise Manage MCP サーバーはローカルで動作しますが、標準で HTTP に対応しています。connectwise-manage-mcp --transport http --addr :7777 で起動し、HTTPS トンネルまたは独自のリバースプロキシの背後に配置してください。ブリッジパッケージは不要です。詳しい手順は mcp-install.md をご覧ください。

Codex、Cursor、Windsurf、Cline、Copilot、Gemini でも使えますか？

はい。どれも MCP に対応しています。各ツールへのインストールコマンドは上の一覧表に、詳細な説明は docs/which-agent.md に記載されています。

コーディングの知識は必要ですか？

いいえ。推奨するインストール方法は、Claude Code または Codex に1文貼り付けることです。エージェントが SKILL.md を読み、インストールを実行します。代替方法として、OS ごとのワンラインインストーラー（bash または PowerShell）もあります。どちらの方法でも、コードを書く必要はありません。ConnectWise Manage の認証情報を一度入力するだけです。

ConnectWise Manage のデータは安全ですか？

データはお使いのマシン上に保存されます。CLI と MCP サーバーはローカルバイナリです。SQLite ミラーはユーザーアカウント配下のディレクトリに保存されます。AI エージェントが参照するのは CLI の返す内容のみで、通常はクエリ結果であり、未加工の一括データではありません。認証情報は環境変数またはエージェントの設定から読み込まれます。MSP Skills に含められたり、どこかへ送信されたりすることはありません。

ConnectWise API のレート制限に達しますか？

ローカルミラーがあるため、読み取りで API にアクセスする必要はありません。初回の同期後、エンティティをまたぐビュー（unbilled、account、agreement-burn、board、stale、workload）は API を一切呼び出さず、ローカルの SQLite に対して実行されます。ライブ呼び出しには --rate-limit によるスロットリングが適用されます。注意：ConnectWise のリストエンドポイントには「変更日時以降」を指定するパラメーターがないため、通常の sync では変更分だけでなく、各リソース全体を再取得します（resource_not_incremental の警告が表示されます）。数年分の履歴があるテナントでは、以下のように条件フィルターを使って同期対象を絞り込んでください。

数年分の履歴があります。同期と読み取りを高速に保つにはどうすればよいですか？

ConnectWise のリストエンドポイントには時間によるフィルターパラメーターが定義されていないため、通常の sync ではすべてのリソースを毎回全件再取得します。また、--since は同期自体には影響しません。データ量の多いテナントでも高速に保つには、次の 2 つの方法があります。

• 条件フィルターで同期対象を絞り込みます。 sync ではリソースを位置引数として指定できません。--resources でリソース名を指定し、--resource-param <resource>:<key>=<value> で条件を設定します（対象を絞り込むリソースごとに、この組み合わせを繰り返します）。まず condition build を使って有効な式を作成してください。

  connectwise-manage-cli sync --resources service-tickets --resource-param "service-tickets:conditions=lastUpdated > [2025-01-01T00:00:00Z]"
  

  これにより、履歴全体ではなく、指定した範囲だけを取得できます。
• 読み取りはローカルで行います。 エンティティをまたぐビューはローカルミラーを読み取ります。search のデフォルトは自動モード（まずライブ API を試します）です。完全にオフラインで利用するには --data-source local（必要に応じて --type <resource> も）を追加し、時間のかかるコマンドには --timeout 2m を指定して猶予を増やしてください。MCP の search ツールはもともとローカルのみを使うため、MCP サーバー上のエージェントがライブ検索の経路を使うことはありません。

ConnectWise PSA と ConnectWise Manage のどちら向けですか？

同じ製品です。ConnectWise は Manage を ConnectWise PSA に名称変更しました。このスキルは Manage REST API（v4_6_release/apis/3.0）を対象としており、どちらの名称でも同じ API を指します。ConnectWise Automate は対象外です。これは別の API を持つ別製品です。

オンプレミスの ConnectWise Manage でも使えますか？

はい。CW_SITE にはクラウドリージョンのホストだけでなく、お使いのサーバーのホスト名も指定できます。どちらの場合も、CLI は標準の v4_6_release/apis/3.0 ベース URL を構築します。

ConnectWise ポータルに取って代わりますか？

いいえ、そのようなことは目指していません。ドラッグ＆ドロップによるディスパッチや請求書の編集など、アプリ内のワークフローには引き続きポータルが最適です。このスキルを使うと、すでに利用している AI エージェントから PSA のデータを扱えます。また、単一のポータル画面では組み合わせられない、エンティティをまたぐ質問にも回答できます。

費用はいくらですか？

無料です。Apache-2.0 ライセンスで提供されています。費用が発生するのは、利用する AI エージェント（Claude、ChatGPT、Codex など）のみで、その料金は当社ではなく AI プロバイダーに支払います。

安全モデル

ティア	例	推奨されるエージェントポリシー
読み取り	unbilled、account、agreement-burn、board、stale、workload、search、すべての get-*	許可
書き込み（定型）	time post-entries、service post-tickets、service patch-tickets-by-id、company patch-companies-by-id	--dry-run でプレビュー（オプトインであり、デフォルトではありません）してから、レビュー済みの書き込みを実行
破壊的操作	service delete-tickets-by-id、company delete-companies-by-id、company delete-configurations-bulk	必ず人間の確認を挟む
認証情報／セキュリティ	system post-members-by-member-identifier-tokens、company post-contacts-request-password	必ず人間の確認を挟む

書き込みは、デフォルトではバイナリによって制限されません。--dry-run は送信せずにリクエストをプレビューしますが、エージェントが渡す必要のあるフラグです。エージェントのポリシーにゲートを設けてください。プレビューし、正確なコマンドを表示して、承認を得てから実行します。

最も強力な制御は、ConnectWise Manage の認証情報に付与するスコープです。CLI で実行できるのは、その認証情報で許可されている操作に限られます。制限方法を含む詳細は、governance.md をご覧ください。

ステータス

ベータ版です。ConnectWise Manage API の仕様に照らして検証済みで、毎週開催している Build Sessions では、実稼働環境のテナントで運用する MSP とともに検証を進めています。compoundingteams.com/build-sessions から参加登録してください。

---

標準規格。 オープンな Agent Skills spec（Anthropic、2025 年 12 月；40 以上のエージェント）に準拠しています。MCP 互換で、Hermes を含む MCP 対応エージェントで動作します。OpenClaw 対応済みです（frontmatter の事前配線済み。OpenClaw のローンチ待ち）。

Servosity が保守しています。Apache-2.0 ライセンスです。CLI Printing Press で構築されています。最終更新日：2026-06-05。