MCP Intercom

🚀 MCP 連絡サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を用いて、Intercom の会話やチャットにアクセスできるようにします。大型言語モデル（LLMs）が様々なフィルターオプションを使って、Intercom の会話をクエリし、分析することが可能です。

✨ 主な機能

• フィルターオプションを使った Intercom 会話のクエリ：
  • 日付範囲（開始日と終了日）
  • 顧客 ID
  • 会話状態
• Intercom API キーを使用した安全なアクセス
• 豊富な会話データの提供：
  • 基本的な会話情報
  • 連絡先情報
  • 統計情報（応答数、再オープン回数）
  • 状態と優先度情報

📦 インストール

1. リポジトリをクローンします：

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom

2. 依存関係をインストールします：

npm install

3. 環境を設定します：

cp .env.example .env

4. .env ファイルに Intercom API キーを追加します：

INTERCOM_API_KEY=your_api_key_here

5. サーバーをビルドします：

npm run build

💻 使用例

サーバーの起動

サーバーを起動します：

npm start

Claude for Desktop との連携

1. サーバーを Claude for Desktop の設定ファイル（macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %AppData%\Claude\claude_desktop_config.json）に追加します：

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"],
      "env": {
        "INTERCOM_API_KEY": "your_api_key_here"
      }
    }
  }
}

2. Claude for Desktop を再起動します。

利用可能なツール

search-conversations

フィルターオプションを使って Intercom の会話を検索します。

パラメータ：

• createdAt（任意）：operator（例：">"、"<"、"="）と value（UNIX タイムスタンプ）を含むオブジェクトで、作成日でのフィルタリングに使用します。
• updatedAt（任意）：operator（例：">"、 "<"、"="）と value（UNIX タイムスタンプ）を含むオブジェクトで、更新日でのフィルタリングに使用します。
• sourceType（任意）：会話のソースタイプ（例："email"、"chat"）。
• state（任意）：フィルタリングする会話状態（例："open"、"closed"）。
• open（任意）：ブール値で、オープン状態でのフィルタリングに使用します。
• read（任意）：ブール値で、既読状態でのフィルタリングに使用します。

クエリ例：

• "2024 年 1 月 1 日以降に作成されたすべての会話を検索"
• "昨年更新された会話を検索"
• "すべてのオープンなメール会話をリストアップ"
• "すべての未読会話を取得"

🔧 技術詳細

• サーバーは Intercom API キーが必要です。
• API キーは安全に保管する必要があります。
• サーバーは会話への読み取り専用アクセスのみを提供します。
• すべての API リクエストは適切な認証を通じて行われます。

🛠 開発方法

1. 開発モードを起動します（自動再コンパイル）：

npm run dev

2. コードチェックを実行します：

npm run lint

🤝 貢献方法

1. このリポジトリをフォークします。
2. 新しい機能のためのブランチを作成します。
3. 変更を加えます。
4. プルリクエストを送信します。

📄 ライセンス

MIT