Intercom MCP 服务器

项目描述

这是一个符合 MCP 协议的服务器，允许 AI 助手访问和分析 Intercom 的客户支持数据。项目文档托管在 GitHub 上。

特性

• 具有高级过滤功能的对话和票务搜索
• 票务分类和筛选
• 客户关联的票务搜索
• 符合 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

注意事项

1. 本项目为独立集成，与 Intercom Inc. 无任何关联。
2. "Intercom" 是 Intercom Inc. 的注册商标。

许可证

本项目遵循 Apache License 2.0 协议，具体条款见 LICENSE 文件。