MCP Server For Intercom

🚀 Intercom MCP サーバー

このプロジェクトは、MCP プロトコルに準拠したサーバーで、AI アシスタントが Intercom のカスタマーサポートデータにアクセスし、分析することを可能にします。プロジェクトのドキュメントは GitHub でホストされています。

🚀 クイックスタート

このサーバーは、AI アシスタントが Intercom のカスタマーサポートデータにアクセスし、分析するための MCP プロトコルに準拠したサーバーです。以下に、インストール方法と使用方法を説明します。

✨ 主な機能

• 高度なフィルタリング機能を備えた会話とチケット検索
• チケットの分類とフィルタリング
• 顧客に関連するチケット検索
• MCP プロトコルに準拠し、Claude Desktop やその他の AI ツールと互換性があります

📦 インストール

前提条件

1. Node.js（バージョン 14 以上を推奨）
2. Docker（コンテナ化デプロイ用、オプション）

クイックインストール（NPM を使用）

# リポジトリをクローンし、ディレクトリに移動
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom

# 依存関係をインストール
npm install

# サービスを起動
npm start

クイックインストール（Docker を使用）

# イメージを取得して実行
docker pull raoulbianet/mcp-server-intercom:latest
docker run -it --rm -p 3000:3000 raoulbianet/mcp-server-intercom:latest

検証手順

# サービスが正常に動作していることを確認
curl http://localhost:3000/health

💻 使用例

基本的な使用法

このサーバーは、以下の MCP ツールインターフェースを提供します。

1. 会話検索：時間範囲、タグ、内容キーワードなどの高度なフィルタリング機能をサポートします。
2. チケット分類：事前に設定されたルールに基づいて、顧客の問題を分類します。
3. 顧客関連のチケット：一意の識別子（メールアドレスやユーザー ID など）を使用して、特定の顧客のチケット記録を検索します。

高度な使用法

claude_desktop_config.json に以下の内容を追加します。

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "intercom-mcp",
      "args": [],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
      }
    }
  }
}

📚 ドキュメント

実装について

• Intercom REST API と Webhooks を使用してデータをやり取りします。
• データ処理は GDPR とプライバシー保護の要件に準拠しています。
• 詳細なログ記録と監視機能を提供します。

詳細な技術ドキュメントは src/services/INTERCOM_API_NOTES.md を参照してください。

開発ガイド

# リポジトリをクローンし、依存関係をインストール
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom
npm install

# 開発環境を構築して実行
npm run build
npm run dev

# テストを実行
npm test

🔧 技術詳細

実装説明

• Intercom REST API と Webhooks を使用したデータのやり取り
• GDPR とプライバシー保護の要件に準拠したデータ処理
• 詳細なログ記録と監視機能の提供

詳細な技術ドキュメントは src/services/INTERCOM_API_NOTES.md を参照してください。

📄 ライセンス

このプロジェクトは Apache License 2.0 に従います。詳細な条項は LICENSE ファイルを参照してください。

⚠️ 重要提示

このプロジェクトは独立した統合であり、Intercom Inc. とは一切関係がありません。"Intercom" は Intercom Inc. の登録商標です。