インターコム用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の使用
Dockerの使用
デフォルトの Docker 構成は Glama との互換性のために最適化されています。
検証手順:
代替標準バージョン
Glama 固有の依存関係のない軽量バージョンを希望する場合:
デフォルト バージョンには、Glama プラットフォームとの統合に必要な特定の依存関係と構成が含まれていますが、標準バージョンはより軽量です。
利用可能なMCPツール
1. list_conversations
コンテンツ フィルタリングを使用して、日付範囲内のすべての会話を取得します。
パラメータ:
startDate(DD/MM/YYYY) – 開始日(必須)endDate(DD/MM/YYYY) – 終了日(必須)keyword(文字列) – このテキストを含む会話を含めるフィルターexclude(文字列) – このテキストを含む会話を除外するフィルター
注記:
日付範囲は7日を超えてはなりません
Intercomの検索APIを介して効率的なサーバー側フィルタリングを使用します
例:
2. search_conversations_by_customer
特定の顧客に関する会話を検索します。
パラメータ:
customerIdentifier(文字列) – 顧客のメールアドレスまたはインターコムID (必須)startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日keywords(配列) – コンテンツでフィルタリングするためのオプションのキーワード
注記:
連絡先が存在しなくても、メールの内容で会話を見つけることができます
効率的な検索のためにメールを連絡先IDに解決します
例:
3. チケットsearch_tickets_by_status
ステータス別にチケットを取得します。
パラメータ:
status(文字列) – 「open」、「pending」、または「resolved」(必須)startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日
例:
4. search_tickets_by_customer
特定の顧客に関連付けられたチケットを検索します。
パラメータ:
customerIdentifier(文字列) – 顧客のメールアドレスまたはインターコムID (必須)startDate(DD/MM/YYYY) – オプションの開始日endDate(DD/MM/YYYY) – オプションの終了日
例:
Claude Desktopによる構成
claude_desktop_config.jsonに追加します:
実装ノート
このサーバーがIntercomのAPIとどのように統合されるかに関する詳細な技術情報については、 src/services/INTERCOM_API_NOTES.mdをご覧ください。このドキュメントでは、パラメータマッピング、Intercomエンドポイントの使用方法、開発者向けの実装の詳細について説明します。
発達
免責事項
このプロジェクトは独立した統合であり、Intercom Inc. と提携、公式接続、または承認されていません。「Intercom」は Intercom Inc. の登録商標です。
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、LICENSE ファイルを参照してください。