Intercom 的 MCP 服务器

<a href="https://glama.ai/mcp/servers/@raoulbia-ai/mcp-server-for-intercom"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=809263405,316326213&fm=3081&app=3081&f=PNG?w=760&h=400" /> </a>

这是一个符合 MCP 标准的服务器，使 AI 助手能够访问并分析来自 Intercom 的客户支持数据。

特性

• 使用高级过滤搜索对话和工单
• 按客户、状态、日期范围和关键词进行筛选
• 即使没有联系信息，也可以通过电子邮件内容进行搜索
• 通过 Intercom 的搜索 API 实现高效的服务器端过滤
• 无缝集成到符合 MCP 标准的 AI 助手中

安装

预备条件

• Node.js 18.0.0 或更高版本
• 具有 API 访问权限的 Intercom 账户
• 您的 Intercom API 令牌（可在您的 Intercom 账户设置中找到）

快速设置

使用 NPM

# 全局安装包
npm install -g mcp-server-for-intercom

# 设置您的 Intercom API 令牌
export INTERCOM_ACCESS_TOKEN="your_token_here"

# 运行服务器
intercom-mcp

使用 Docker

默认的 Docker 配置优化了与 Glama 的兼容性：

# 启动 Docker（如果尚未运行）
# 在 Windows 上：启动 Docker Desktop 应用程序
# 在 Linux 上：sudo systemctl start docker

# 构建镜像
docker build -t mcp-intercom .

# 使用您的 API 令牌和端口映射运行容器
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom:latest

验证步骤：

# 测试服务器状态
curl -v http://localhost:8080/.well-known/glama.json
# 测试 MCP 端点
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"mcp.capabilities"}' http://localhost:3000

替代标准版本

如果您偏好一个不依赖于 Glama 的轻量级版本：

# 构建标准镜像
docker build -t mcp-intercom-standard -f Dockerfile.standard .

# 运行标准容器
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom-standard:latest

默认版本包括特定的依赖项和配置，以实现与 Glama 平台的集成，而标准版本则更轻量级。

可用的 MCP 工具

1. list_conversations

检索指定日期范围内的对话，并进行内容过滤。

参数：

• startDate (DD/MM/YYYY) – 开始日期（必需）
• endDate (DD/MM/YYYY) – 结束日期（必需）
• keyword (字符串) – 包含此文本的对话过滤器
• exclude (字符串) – 排除此文本的对话过滤器

注意事项：

• 日期范围不得超过 7 天
• 使用 Intercom 的搜索 API 实现高效的服务器端过滤

示例：

{
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keyword": "billing"
}

2. search_conversations_by_customer

查找特定客户的对话。

参数：

• customerIdentifier (字符串) – 客户电子邮件或 Intercom ID（必需）
• startDate (DD/MM/YYYY) – 可选开始日期
• endDate (DD/MM/YYYY) – 可选结束日期
• keywords (数组) – 可选关键词，用于按内容过滤

注意事项：

• 即使没有联系信息，也可以通过电子邮件内容找到对话
• 解析电子邮件以联系 ID，实现高效搜索

示例：

{
  "customerIdentifier": "customer@example.com",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keywords": ["billing", "refund"]
}

3. search_tickets_by_status

根据状态检索工单。

参数：

• status (字符串) – "open", "pending" 或 "resolved"（必需）
• startDate (DD/MM/YYYY) – 可选开始日期
• endDate (DD/MM/YYYY) – 可选结束日期

示例：

{
  "status": "open",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025"
}

4. search_tickets_by_customer

查找与特定客户相关的工单。

参数：

• customerIdentifier (字符串) – 客户电子邮件或 Intercom ID（必需）
• startDate (DD/MM/YYYY) – 可选开始日期
• endDate (DD/MM/YYYY) – 可选结束日期

示例：

{
  "customerIdentifier": "customer@example.com",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025"
}

与 Claude Desktop 集成配置

添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "intercom-mcp",
      "args": [],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
      }
    }
  }
}

实施说明

有关此服务器如何与 Intercom 的 API 集成的详细技术信息，请参阅 src/services/INTERCOM_API_NOTES.md。该文档解释了我们的参数映射、Intercom 端点的使用以及开发人员的实施细节。

开发

# 克隆并安装依赖
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

声明

本项目是一个独立的集成，与 Intercom Inc. 无关，未经其正式连接或认可。“Intercom”是 Intercom Inc. 的注册商标。

许可证

本项目采用 Apache 许可证 2.0 - 详情见 LICENSE 文件。