项目简介

Intercom MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在让LLM应用能够安全、便捷地访问和分析Intercom平台的对话数据。通过该服务器，LLM可以查询Intercom中的客户对话，获取有价值的上下文信息，从而提升客户服务和业务分析能力。

主要功能点

查询Intercom对话: 支持根据日期范围、客户ID、对话状态等多种条件过滤查询Intercom会话。
安全访问: 使用Intercom API密钥进行安全身份验证，确保数据访问安全。
丰富的数据: 提供包括对话详情、联系人信息、统计数据（回复数、重开次数）以及状态和优先级等全面的会话数据。
易于集成: 通过标准的MCP协议与LLM客户端通信，方便集成到支持MCP协议的LLM应用中，如Claude for Desktop。

安装步骤

克隆仓库:

git clone https://github.com/fabian1710/mcp-intercom.git
cd mcp-intercom

安装依赖:
```
npm install
```

配置环境变量: 复制 '.env.example' 文件并重命名为 '.env'，然后编辑 '.env' 文件，填入你的 Intercom API 密钥。

cp .env.example .env

在 '.env' 文件中添加：

INTERCOM_API_KEY=你的_Intercom_API_密钥

构建服务器:
```
npm run build
```

服务器配置

要将 Intercom MCP Server 与 MCP 客户端（例如 Claude for Desktop）连接，您需要在客户端的配置文件中添加服务器信息。以下是 Claude for Desktop 的配置示例 ('claude_desktop_config.json')：

{
  "mcpServers": {
    "intercom": {
      "command": "node",
      "args": ["/path/to/mcp-intercom/dist/index.js"]
    }
  }
}

配置参数说明:

'"intercom"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行时环境。
'"args": ["/path/to/mcp-intercom/dist/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'dist/index.js' 的绝对路径。请将 '/path/to/mcp-intercom' 替换为您的 'mcp-intercom' 仓库在您本地文件系统中的实际路径。

请确保您已安装 Node.js 环境。配置完成后，重启您的 MCP 客户端使其加载新的服务器配置。

基本使用方法

启动服务器后，LLM客户端可以通过调用以下工具来查询Intercom对话数据：

'search-conversations': 根据多种过滤条件搜索Intercom对话。
- 可选参数包括：
  - 'createdAt': 创建时间，可以设置操作符（如 ">", "<", "="）和 UNIX 时间戳值。
  - 'updatedAt': 更新时间，用法同 'createdAt'。
  - 'sourceType': 对话来源类型（例如 "email", "chat"）。
  - 'state': 对话状态（例如 "open", "closed"）。
  - 'open': 是否为打开状态。
  - 'read': 是否已读。
- 示例查询:
  - "搜索 2024 年 1 月 1 日之后创建的所有对话"
  - "查找上周之前更新的对话"
  - "列出所有打开的邮件对话"
  - "获取所有未读对话"
'list-conversations-from-last-week': 获取过去一周内的所有对话。
- 无需参数。

LLM客户端可以通过自然语言指令调用这些工具，并利用返回的Intercom对话数据进行分析和处理。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息