🚀 Intercom MCP 服务器
这是一个符合 MCP 协议的服务器，允许 AI 助手访问和分析 Intercom 的客户支持数据。项目文档托管在 GitHub 上，为客户支持数据的处理和分析提供了强大的工具。
🚀 快速开始
本服务器允许 AI 助手访问和分析 Intercom 的客户支持数据，你可以按照以下步骤进行安装和使用。
✨ 主要特性
- 具有高级过滤功能的对话和票务搜索，让你更精准地找到所需信息。
- 票务分类和筛选，有效整理客户问题。
- 客户关联的票务搜索，方便查找特定客户的票务记录。
- 符合 MCP 协议，兼容 Claude Desktop 和其他 AI 工具，具有良好的通用性。
📦 安装指南
先决条件
- Node.js（推荐使用版本 14 或更高）
- 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 工具接口：
- 对话搜索：支持高级过滤功能，如时间范围、标签和内容关键字。
- 票务分类：根据预设规则对客户问题进行分类。
- 客户关联的票务：通过唯一标识符（如电子邮件或用户 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 文件。
⚠️ 重要提示
- 本项目为独立集成，与 Intercom Inc. 无任何关联。
- "Intercom" 是 Intercom Inc. 的注册商标。