MCP Server for Intercom

インターコム用MCPサーバー

AI アシスタントが Intercom からの顧客サポート データにアクセスして分析できるようにする MCP 準拠のサーバー。

特徴

• 高度なフィルタリングで会話やチケットを検索
• 顧客、ステータス、日付範囲、キーワードでフィルタリング
• 連絡先が存在しない場合でもメールの内容で検索
• Intercomの検索APIによる効率的なサーバー側フィルタリング
• MCP準拠のAIアシスタントとのシームレスな統合

インストール

前提条件

• 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 ファイルを参照してください。