MCP Server For Intercom

🚀 Intercom MCP 服務器

這是一個符合 MCP 協議的服務器，允許 AI 助手訪問和分析 Intercom 的客戶支持數據。項目文檔託管在 GitHub 上，為客戶支持數據的處理和分析提供了強大的工具。

🚀 快速開始

本服務器允許 AI 助手訪問和分析 Intercom 的客戶支持數據，你可以按照以下步驟進行安裝和使用。

✨ 主要特性

• 具有高級過濾功能的對話和票務搜索，讓你更精準地找到所需信息。
• 票務分類和篩選，有效整理客戶問題。
• 客戶關聯的票務搜索，方便查找特定客戶的票務記錄。
• 符合 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"
      }
    }
  }
}

📚 詳細文檔

本服務器提供了豐富的 MCP 工具接口，具體包括對話搜索、票務分類和客戶關聯的票務查詢等功能，可根據需求靈活使用。

🔧 技術細節

實現說明

• 使用 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

📄 許可證

本項目遵循 Apache License 2.0 協議，具體條款見 LICENSE 文件。

⚠️ 重要提示

1. 本項目為獨立集成，與 Intercom Inc. 無任何關聯。
2. "Intercom" 是 Intercom Inc. 的註冊商標。