MCP Intercom

🚀 MCP 聯絡服務器

MCP 聯絡服務器是一個模型上下文協議（MCP）服務器，它為您提供對 Intercom 對話和聊天的訪問權限。藉助該服務器，大型語言模型（LLMs）能夠通過多種過濾選項，對您的 Intercom 會話進行查詢和分析，為您的業務溝通數據挖掘提供有力支持。

🚀 快速開始

MCP 聯絡服務器允許大型語言模型（LLMs）通過各種過濾選項查詢和分析您的 Intercom 會話。以下是使用該服務器的基本步驟：

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

6. 啟動服務器：

npm start

✨ 主要特性

• 靈活查詢：支持使用過濾選項查詢 Intercom 對話，過濾選項包括日期範圍（開始和結束日期）、客戶 ID、會話狀態等。
• 安全訪問：使用 Intercom API 密鑰進行安全訪問，保障數據安全。
• 豐富數據：提供豐富的對話數據，涵蓋基本對話信息、聯繫人信息、統計信息（響應數、重新打開次數）、狀態和優先級信息等。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

環境設置

cp .env.example .env

將您的 Intercom API 密鑰添加到 .env 文件中：

INTERCOM_API_KEY=your_api_key_here

構建服務器

npm run build

💻 使用示例

運行服務器

啟動服務器：

npm start

與 Claude for Desktop 配合使用

1. 將服務器添加到您的 Claude for Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json macOS 或 %AppData%\Claude\claude_desktop_config.json Windows）：

{
  "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 請求均通過適當的身份驗證進行，防止非法訪問。

開發

• 啟動開發模式（自動重新編譯）：

npm run dev

• 運行代碼檢查：

npm run lint

🤝 貢獻

如果您想為 MCP 聯絡服務器做出貢獻，可以按照以下步驟進行：

1. 叉克此倉庫
2. 為您的功能創建新分支
3. 進行修改
4. 提交拉取請求

📄 許可證

本項目採用 MIT 許可證。