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. 的注册商标。