ConnectWise Manage MCP Server

AIアシスタントにConnectWise Manageを直接操作させましょう。 チケットの検索、時間の記録、会社や連絡先の参照、プロジェクトの管理 — CWMの画面をクリックして操作する代わりに、自然な会話で行えます。

これはModel Context Protocol (MCP)サーバーで、ConnectWise Manageを導入している組織が日々の運用で依存している業務をカバーする51のツールをClaude（またはMCP互換の任意のAI）に提供します。クラウドホスト型とセルフホスト型の両方のCWMインスタンスに対応しています — サーバーを指定するだけで使えます。

MSP Claude Pluginsエコシステムの一部です — Autotask、Datto RMM、IT Glue、HaloPSA、NinjaOne、Huntressなどを含む、MSPスタック向けAIインテグレーションの成長を続けるスイートです。MSPによって、MSPのために構築されています。

ワンクリックデプロイ

レジストリ認証に関する注意: このサーバーは公開npmパッケージのみに依存しているため、CloudflareおよびDigitalOceanのクラウドビルダーは依存関係を匿名でインストールします — ワンクリックデプロイにトークンは不要です。（将来のリリースでプライベートな@wyre-ai/*依存関係が追加された場合は、ビルド変数としてread:packages権限を持つGitHub PATを指定してください — Cloudflare Workersの場合はNODE_AUTH_TOKEN、DigitalOceanの場合はビルド時のGITHUB_TOKENシークレットです。）

公開パッケージのインストール: リリースされたパッケージはGitHub Packagesのnpmレジストリに公開されており、インストールのたびに認証が必要です（公開パッケージでも同様）。インストールするには、read:packages権限を持つGitHub PATを使用してnpmをnpm.pkg.github.comに認証してください:

export NODE_AUTH_TOKEN=$(gh auth token)
npm install @wyre-ai/connectwise-manage-mcp

Entra ID OAuth 2.1を使用したAzure Container Appsへのデプロイについては、AZURE_ACA_DEPLOYMENT.mdを参照してください。

Related MCP server: Autotask MCP Server

設定

環境変数

APIベースURL（CW_MANAGE_URL）

セルフホストインスタンスの場合は、CW_MANAGE_URLをサーバーのベースURLに設定します。URLにそのパスがすでに含まれていない限り、サーバーは自動的に/v4_6_release/apis/3.0を追加します。

セルフホストインスタンスが自己署名証明書を使用している場合は、CW_MANAGE_REJECT_UNAUTHORIZED=falseも設定してください。

APIキーの取得

1. ConnectWise Manageインスタンスにログインします

2. システム > メンバー > APIメンバーに移動します

3. 適切な権限を持つ新しいAPIメンバーを作成します

4. メンバーのAPIキーを生成します

5. ConnectWise Developer PortalからクライアントIDを取得します

利用可能なツール

インタラクティブなチケットカード（MCPアプリ）

cw_get_ticketはMCPアプリのホスト（Claude Desktop/web）ではインタラクティブカードとして表示され、カード内でcw_add_ticket_noteによる「メモを追加」のラウンドトリップが可能です。このメモは常に内部専用（internalAnalysisFlag）として投稿されます。他のホストでは通常のJSON動作のまま変更されません。カードはデフォルトでニュートラルなデザインで、window.__BRAND__の注入またはMCP_BRAND_*環境変数（MCP_BRAND_NAME、MCP_BRAND_LOGO_URL、MCP_BRAND_PRIMARY_COLOR、MCP_BRAND_ACCENT_COLOR、MCP_BRAND_BG、MCP_BRAND_TEXT）でブランド設定を変更できます。再ビルドは不要です。

チケット

• cw_search_tickets — 条件を指定してサービスチケットを検索

• cw_get_ticket — IDでチケットを取得

• cw_create_ticket — 新しいサービスチケットを作成

• cw_update_ticket — チケットを更新（JSONパッチ）

• cw_get_ticket_notes — チケットのすべてのメモを取得（子チケットのメモを含む）

• cw_add_ticket_note — チケットにメモを追加（ディスカッション、内部、または解決）

会社

• cw_search_companies — 会社を検索

• cw_get_company — IDで会社を取得

• cw_create_company — 新しい会社を作成

• cw_update_company — 会社を更新（JSONパッチ）

連絡先

• cw_search_contacts — 連絡先を検索

• cw_get_contact — IDで連絡先を取得

• cw_create_contact — 新しい連絡先を作成

プロジェクト

• cw_search_projects — プロジェクトを検索

• cw_get_project — IDでプロジェクトを取得

• cw_create_project — 新しいプロジェクトを作成

• cw_search_project_tickets — プロジェクト配下のチケットを検索

• cw_get_project_ticket — IDで特定のプロジェクトチケットを取得

• cw_get_project_ticket_notes — プロジェクトチケットのすべてのメモを取得（子チケットのメモを含む）

• cw_add_project_ticket_note — プロジェクトチケットにメモを追加（ディスカッション、内部、または解決）

時間入力

• cw_search_time_entries — 時間入力を検索

• cw_get_time_entry — IDで時間入力を取得

• cw_create_time_entry — 新しい時間入力を作成

メンバー

• cw_search_members — メンバー/技術者を検索

• cw_get_member — IDでメンバーを取得

構成アイテム

• cw_search_configurations — 構成アイテム（資産）を検索

• cw_get_configuration — IDで構成アイテムを取得

サービス参照データ

• cw_list_boards — サービスボードを一覧表示

• cw_list_priorities — チケットの優先度を一覧表示

• cw_list_statuses — ボードのステータスを一覧表示

アクティビティ

• cw_search_activities — アクティビティを検索

• cw_get_activity — IDでアクティビティを取得

• cw_create_activity — 新しいアクティビティを作成

契約

• cw_search_agreements — 契約を検索

• cw_get_agreement — IDで契約を取得

• cw_get_agreement_additions — 契約の追加項目（ラインアイテム）を取得

請求書

• cw_search_invoices — 請求書を検索

• cw_get_invoice — IDで請求書を取得

商談

• cw_search_opportunities — 商談を検索

• cw_get_opportunity — IDで商談を取得

• cw_search_opportunity_forecasts — 商談の予測ラインを検索

• cw_search_opportunity_notes — 商談のメモを検索

• cw_search_sales_stages — 営業パイプラインのステージを一覧表示

カタログ（製品）

• cw_search_catalog_items — 製品カタログアイテムを検索

• cw_get_catalog_item — IDでカタログアイテムを取得

• cw_create_catalog_item — 新しいカタログアイテムを作成

• cw_update_catalog_item — カタログアイテムを更新（JSONパッチ）

• cw_list_catalog_categories — カタログカテゴリを一覧表示

• cw_list_catalog_subcategories — カタログサブカテゴリを一覧表示

• cw_list_manufacturers — メーカーを一覧表示

ヘルスチェック

• cw_test_connection — 接続をテスト（/system/infoにアクセス）

使い方

Claude Desktopの場合

claude_desktop_config.jsonに追加します:

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id"
      }
    }
  }
}

セルフホストインスタンスの場合:

{
  "mcpServers": {
    "connectwise-manage": {
      "command": "npx",
      "args": ["@wyre-ai/connectwise-manage-mcp"],
      "env": {
        "CW_MANAGE_URL": "https://cwm.yourcompany.com",
        "CW_MANAGE_COMPANY_ID": "your-company-id",
        "CW_MANAGE_PUBLIC_KEY": "your-public-key",
        "CW_MANAGE_PRIVATE_KEY": "your-private-key",
        "CW_MANAGE_CLIENT_ID": "your-client-id",
        "CW_MANAGE_REJECT_UNAUTHORIZED": "false"
      }
    }
  }
}

Dockerの場合

docker compose up -d

HTTPトランスポート（ゲートウェイモード）

マルチテナントのゲートウェイデプロイでは、HTTPトランスポートで実行します:

MCP_TRANSPORT=http AUTH_MODE=gateway node dist/index.js

認証情報はリクエストごとにヘッダーで渡します: X-CW-Company-Id、X-CW-Public-Key、X-CW-Private-Key、X-CW-Client-Id、およびオプションでX-CW-URL。

開発

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

# Type check
npm run typecheck

# Run tests
npm test

コントリビューション

1. リポジトリをフォークします

2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）

3. 変更をコミットします（git commit -m 'Add amazing feature'）

4. ブランチにプッシュします（git push origin feature/amazing-feature）

5. プルリクエストを開きます

ライセンス

Apache-2.0

WYRE Technologyによって構築 — MSP Claude Pluginsエコシステムの一部です