MCP Server for Intercom

对讲机的 MCP 服务器

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

特征

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

安装

先决条件

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

快速设置

使用 NPM

使用 Docker

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

验证步骤：

替代标准版本

如果您更喜欢没有 Glama 特定依赖项的轻量级版本：

默认版本包含与 Glama 平台集成所需的特定依赖项和配置，而标准版本则更加轻量级。

可用的 MCP 工具

1. list_conversations

使用内容过滤检索某个日期范围内的所有对话。

参数：

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

笔记：

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

例子：

2. search_conversations_by_customer

查找特定客户的对话。

参数：

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

笔记：

• 即使没有联系人，也可以通过电子邮件内容查找对话
• 将电子邮件解析为联系人 ID，以便高效搜索

例子：

3. 按状态search_tickets_by_status

根据票证状态检索票证。

参数：

• status （字符串）——“打开”、“待定”或“已解决”（必需）
• startDate (DD/MM/YYYY) – 可选开始日期
• endDate (DD/MM/YYYY) – 可选结束日期

例子：

4. search_tickets_by_customer

查找与特定客户相关的票证。

参数：

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

例子：

使用 Claude Desktop 进行配置

添加到您的claude_desktop_config.json ：

实施说明

有关此服务器如何与 Intercom API 集成的详细技术信息，请参阅src/services/INTERCOM_API_NOTES.md 。本文档介绍了我们的参数映射、Intercom 端点使用方法以及面向开发者的实现细节。

发展

免责声明

该项目是一个独立集成项目，与 Intercom Inc. 没有任何关联、官方联系或认可。“Intercom”是 Intercom Inc. 的注册商标。

执照

该项目根据 Apache License 2.0 获得许可 - 有关详细信息，请参阅 LICENSE 文件。