インターコム用MCPサーバー
AI アシスタントが Intercom からの顧客サポート データにアクセスして分析できるようにする MCP 準拠のサーバー。
特徴
高度なフィルタリングで会話やチケットを検索
顧客、ステータス、日付範囲、キーワードでフィルタリング
連絡先が存在しない場合でもメールの内容で検索
Intercomの検索APIによる効率的なサーバー側フィルタリング
MCP準拠のAIアシスタントとのシームレスな統合
Related MCP server: Claude AI Documentation Assistant
インストール
前提条件
Node.js 18.0.0以上
APIアクセス可能なIntercomアカウント
Intercom APIトークン（Intercomアカウント設定で利用可能）
クイックセットアップ
NPMの使用
# Install the package globally
npm install -g mcp-server-for-intercom
# Set your Intercom API token
export INTERCOM_ACCESS_TOKEN="your_token_here"
# Run the server
intercom-mcpDockerの使用
デフォルトの Docker 構成は Glama との互換性のために最適化されています。
# Start Docker (if not already running)
# On Windows: Start Docker Desktop application
# On Linux: sudo systemctl start docker
# Build the image
docker build -t mcp-intercom .
# Run the container with your API token and port mappings
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom:latest検証手順:
# Test the server status
curl -v http://localhost:8080/.well-known/glama.json
# Test the MCP endpoint
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"mcp.capabilities"}' http://localhost:3000代替標準バージョン
Glama 固有の依存関係のない軽量バージョンを希望する場合:
# Build the standard image
docker build -t mcp-intercom-standard -f Dockerfile.standard .
# Run the standard container
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom-standard:latestデフォルト バージョンには、Glama プラットフォームとの統合に必要な特定の依存関係と構成が含まれていますが、標準バージョンはより軽量です。
利用可能なMCPツール
1. list_conversations
コンテンツ フィルタリングを使用して、日付範囲内のすべての会話を取得します。
パラメータ:
startDate(DD/MM/YYYY) – 開始日（必須）endDate(DD/MM/YYYY) – 終了日（必須）keyword（文字列） – このテキストを含む会話を含めるフィルターexclude(文字列) – このテキストを含む会話を除外するフィルター
注記:
日付範囲は7日を超えてはなりません
Intercomの検索APIを介して効率的なサーバー側フィルタリングを使用します
例：
{
"startDate": "15/01/2025",
"endDate": "21/01/2025",
"keyword": "billing"
}2. search_conversations_by_customer
特定の顧客に関する会話を検索します。
パラメータ:
customerIdentifier(文字列) – 顧客のメールアドレスまたはインターコムID (必須)startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日keywords（配列） – コンテンツでフィルタリングするためのオプションのキーワード
注記:
連絡先が存在しなくても、メールの内容で会話を見つけることができます
効率的な検索のためにメールを連絡先IDに解決します
例：
{
"customerIdentifier": "customer@example.com",
"startDate": "15/01/2025",
"endDate": "21/01/2025",
"keywords": ["billing", "refund"]
}3. チケットsearch_tickets_by_status
ステータス別にチケットを取得します。
パラメータ:
status（文字列） – 「open」、「pending」、または「resolved」（必須）startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日
例：
{
"status": "open",
"startDate": "15/01/2025",
"endDate": "21/01/2025"
}4. search_tickets_by_customer
特定の顧客に関連付けられたチケットを検索します。
パラメータ:
customerIdentifier(文字列) – 顧客のメールアドレスまたはインターコムID (必須)startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日
例：
{
"customerIdentifier": "customer@example.com",
"startDate": "15/01/2025",
"endDate": "21/01/2025"
}Claude Desktopによる構成
claude_desktop_config.jsonに追加します:
{
"mcpServers": {
"intercom-mcp": {
"command": "intercom-mcp",
"args": [],
"env": {
"INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
}
}
}
}実装ノート
このサーバーがIntercomのAPIとどのように統合されるかに関する詳細な技術情報については、 src/services/INTERCOM_API_NOTES.mdをご覧ください。このドキュメントでは、パラメータマッピング、Intercomエンドポイントの使用方法、開発者向けの実装の詳細について説明します。
発達
# Clone and install dependencies
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom
npm install
# Build and run for development
npm run build
npm run dev
# Run tests
npm test免責事項
このプロジェクトは独立した統合であり、Intercom Inc. と提携、公式接続、または承認されていません。「Intercom」は Intercom Inc. の登録商標です。
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。