MCP Intercom Server

MCP Intercom 服务

一个提供 Intercom 对话和聊天访问能力的模型上下文协议（MCP）服务。此服务允许大模型通过各种筛选选项查询和分析你的 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. 将 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 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