MCPインターコムサーバー

Intercomの会話やチャットへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、LLMは様々なフィルタリングオプションを使用してIntercomの会話をクエリおよび分析できます。

特徴

• フィルタリング オプションを使用して Intercom の会話を照会します。

  • 日付範囲（開始日と終了日）

  • 顧客ID

  • 会話状態

• Intercom APIキーを使用した安全なアクセス

• 以下を含む豊富な会話データ:

  • 基本的な会話の詳細

  • 連絡先

  • 統計（回答、再開）

  • 状態と優先順位の情報

Related MCP server: MCP Toolbox

インストール

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

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

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

npm install

3. 環境を設定します。

cp .env.example .env

4. Intercom API キーを.envに追加します。

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を再起動する

利用可能なツール

検索会話

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

パラメータ:

• createdAt (オプション): 作成日でフィルタリングするためのoperator (例: ">"、"<"、"=") とvalue (UNIX タイムスタンプ) を持つオブジェクト。

• updatedAt (オプション): 更新日でフィルタリングするためのoperator (例: ">"、"<"、"=") とvalue (UNIX タイムスタンプ) を持つオブジェクト。

• sourceType (オプション): 会話のソース タイプ (例:「メール」、「チャット」)。

• state (オプション): フィルタリングする会話の状態 (例: 「open」、「closed」)。

• open (オプション): オープンステータスでフィルタリングするブール値。

• read (オプション): 読み取りステータスでフィルタリングするブール値。

クエリの例:

• 「2024年1月1日以降に作成されたすべての会話を検索」

• 「先週以前に更新された会話を見つける」

• 「開いているメールの会話をすべて一覧表示する」

• 「未読の会話をすべて取得する」

安全

• サーバーが機能するにはIntercom APIキーが必要です

• APIキーは環境変数に安全に保存する必要があります

• サーバーは会話への読み取りアクセスのみを提供します

• すべてのAPIリクエストは適切な認証で行われます

発達

1. 自動再コンパイルによる開発モードを開始します。

npm run dev

2. リンティングを実行します:

npm run lint

貢献

1. リポジトリをフォークする

2. 機能用の新しいブランチを作成する

3. 変更を加える

4. プルリクエストを送信する

ライセンス

マサチューセッツ工科大学