MCP Intercom 服务器

这是一个提供访问Intercom对话和聊天的Model Context Protocol (MCP)服务器。此服务器允许LLMs查询并分析您的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