supportchat

supportchat

Intercom のサポート会話を、Intercom REST API と連携する MCP ツールとして提供します。supportchat は、Intercom MCP サーバーのコア機能を新しい名前でクリーンルーム方式で再構築したものです。コードは新規に作成され、ブランド表記もコピーしていません。オリジナルは Intercom がホストするリモート MCP（OAuth）ですが、ホスト型 OAuth は再現していません。この再構築版は、同じ API を利用するトークンベースの REST クライアントです。

ツール（コア機能の一部、12 個）

list_conversations、get_conversation、reply_to_conversation、 close_conversation、search_conversations、list_contacts、 get_contact、create_contact、update_contact、list_tags、 tag_contact、list_articles。

この機能範囲に含まれないもの：記事の詳細（12 個に収めるため get_article を除外）、企業、チームとチームメイトの管理、イベントとデータ属性、メモ、チケット、ワークフロー、訪問者のコンバージョンツール、件数およびレポートのエクスポート。

セットアップ

Intercom ワークスペース用のアクセストークンを作成して設定します。

export INTERCOM_ACCESS_TOKEN=dG9r...

必要に応じて、INTERCOM_API_BASE_URL で API のベース URL を変更できます（デフォルトは https://api.intercom.io）。すべてのリクエストには Intercom-Version: 2.11 ヘッダーが付与されます。トークンが設定されていない場合、すべてのツール呼び出しは、不足している変数名を示すエラーで失敗します。会話への返信とクローズには、操作を行う管理者の admin_id が必要です。

CLI

npx @reneturcios/supportchat list_conversations '{"state":"open"}'
npx @reneturcios/supportchat mcp        # stdio MCP server

各ツール名はサブコマンドであり、1 つの JSON オブジェクト引数を受け取ります。

MCP クライアントの設定

{
  "mcpServers": {
    "supportchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/supportchat", "mcp"],
      "env": { "INTERCOM_ACCESS_TOKEN": "dG9r..." }
    }
  }
}

Docker

docker run -i -e INTERCOM_ACCESS_TOKEN ghcr.io/cloudcorprecords/supportchat

開発

npm install
npm run build
npm test

ライセンス

MIT