Intercom Mcp Server

Intercom MCP サーバー

AI エージェントが Intercom の主要なサポートワークフローにフルアクセスできる、ホスト型 MCP サーバーです。連絡先の検索、会話の管理、返信、割り当て、チケットのクローズ、メモの記録を行えます。

公式の @modelcontextprotocol/sdk を使用し、Model Context Protocol 上に構築されています。

---

ツール

ツール	機能
search_contacts	メールアドレス、名前、電話番号で連絡先を検索します
create_or_update_contact	新しい連絡先を作成するか、既存の連絡先を更新します
search_conversations	ステータス、連絡先、担当者で会話を絞り込みます
reply_to_conversation	顧客への返信または内部メモを送信します
close_conversation	未解決の会話を解決してクローズします
assign_conversation	会話を管理者またはチームに割り当てます
create_contact_note	連絡先のプロフィールに内部監査メモを追加します

---

クイックスタート

1. Intercom API トークンを取得する

1. app.intercom.com にアクセスします
2. Settings → Developer Hub → Your App → Authentication に移動します
3. Access Token をコピーします

テストする場合は、app.intercom.com/developers で無料の開発者ワークスペースを作成できます。有料プランは不要です。

---

2. クローンしてインストールする

git clone https://github.com/your-username/intercom-mcp-server.git
cd intercom-mcp-server
npm install

---

3. 環境変数を設定する

cp .env.example .env

.env を開いて、トークンを追加します。

INTERCOM_API_TOKEN=your_token_here

---

4. Claude Desktop に接続する

Claude Desktop の設定ファイルに以下を追加します。

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/absolute/path/to/intercom-mcp-server/index.js"],
      "env": {
        "INTERCOM_API_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Desktop を再起動します。Intercom のツールが利用可能になっているはずです。

---

5. MCP Inspector でテストする

npx @modelcontextprotocol/inspector node index.js

ブラウザー UI が http://localhost:5173 で開き、各ツールを手動で呼び出して応答を確認できます。

---

Railway へのデプロイ

1. このリポジトリを GitHub にプッシュします（プライベートリポジトリでもかまいません）
2. railway.app で新しいプロジェクトを作成します
3. GitHub リポジトリを接続します。Railway が Node.js を自動検出します
4. 環境変数 INTERCOM_API_TOKEN = your_token を追加します
5. デプロイすると、Railway から公開 URL が提供されます

---

環境変数

変数	必須	説明
INTERCOM_API_TOKEN	はい	Intercom の Bearer トークン

---

要件

• Node.js 18 以降
• Intercom アカウント（テストには無料の開発者ワークスペースを利用できます）

---

ライセンス

MIT