MCP Server for Intercom

Intercom MCP 服务

符合 MCP 规范的服务，可让 AI 助手访问和分析 Intercom 中的客户支持数据。

功能

• 使用高级筛选条件搜索对话和工单
• 按客户、状态、日期范围和关键词筛选
• 即使联系人不存在，也可按邮件内容搜索
• 通过 Intercom 的搜索 API 高效地在服务端筛选
• 与符合 MCP 规范的 AI 助手无缝集成

安装

前提条件

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

快速设置

使用 NPM

# Install the package globally
npm install -g mcp-server-for-intercom

# Set your Intercom API token
export INTERCOM_ACCESS_TOKEN="your_token_here"

# Run the server
intercom-mcp

使用 Docker

默认 Docker 配置针对 Glama 兼容性进行了优化：

# Start Docker (if not already running)
# On Windows: Start Docker Desktop application
# On Linux: sudo systemctl start docker

# Build the image
docker build -t mcp-intercom .

# Run the container with your API token and port mappings
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom:latest

验证步骤：

# Test the server status
curl -v http://localhost:8080/.well-known/glama.json
# Test the MCP endpoint
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"mcp.capabilities"}' http://localhost:3000

另一个标准版本

如果你更喜欢不含 Glama 专属依赖项的轻量版本：

# Build the standard image
docker build -t mcp-intercom-standard -f Dockerfile.standard .

# Run the standard container
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 (string) – 筛选出包含此文本的对话
• exclude (string) – 筛选掉包含此文本的对话

注意：

• 日期范围不得超过 7 天
• 通过 Intercom 的搜索 API 高效地在服务端筛选

示例：

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

2. search_conversations_by_customer

查找特定客户的对话。

参数：

• customerIdentifier (string) – 客户邮箱或 Intercom ID（必填）
• startDate (DD/MM/YYYY) – 可选的开始日期
• endDate (DD/MM/YYYY) – 可选的结束日期
• keywords (array) – 可选的关键词，用于按内容筛选

注意：

• 即使联系人不存在，也可以按邮件内容查找对话
• 将邮箱解析为联系人 ID，以便高效搜索

示例：

{
  "customerIdentifier": "[email protected]",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keywords": ["billing", "refund"]
}

3. search_tickets_by_status

按状态检索工单。

参数：

• status (string) – “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 (string) – 客户邮箱或 Intercom ID（必填）
• startDate (DD/MM/YYYY) – 可选的开始日期
• endDate (DD/MM/YYYY) – 可选的结束日期

示例：

{
  "customerIdentifier": "[email protected]",
  "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 端点的使用方式，以及面向开发者的实现细节。

开发

# Clone and install dependencies
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom
npm install

# Build and run for development
npm run build
npm run dev

# Run tests
npm test

免责声明

本项目是独立集成项目，与 Intercom Inc. 无关联、无官方关系，也未获其认可。“Intercom”是 Intercom Inc. 的注册商标。

许可证

本项目采用 Apache License 2.0 许可。详情请参阅 LICENSE 文件。