使用说明

内部通信MCP服务器

用于帮助中心内容管理和CS工作流自动化的内部通信MCP服务器。

版本

v0.9.0版本 -已添加 send_outbound_email --通过电子邮件地址向联系人发起新的出站电子邮件（解析/创建联系人，在创建404传播延迟后重试）。补足物 reply_conversation，它仅在现有对话中回复。

v0.8.4 -内部清理：删除未使用的 zod 附属国；提取共享 ok() （工具结果包装器）和 clamp() （分页）助手可以减少约140行重复；掉了四个装饰性的直通接口。没有工具、模式或输出更改。

v0.8.3 - get_conversation 不再丢失消息承载 open 零件（重新打开已关闭对话的客户电子邮件回复）或 assignment 部分（第一个管理员回复）；每个零件的表面 attachments 并将票单内容提升为明确 ticket.title / ticket.description --修复了分流遗漏最新客户消息或屏幕截图的问题

v0.8.2 - get_conversation 保留分诊要点（来源/交付日期、工单属性、联系人、每个零件 from_quick_reply 标志）而不是剥离它们——需要将“键入回复”与“点击快速回复按钮”区分开来

v0.8.1 -修复： search_conversations 接受 query 即使MCP客户端将对象序列化为JSON字符串（Intercom拒绝了字符串化形式）

v0.8.0 -已添加 search_conversations & get_conversation；精简了所有操作工具响应（回复/关闭/注释/文章/票证），仅返回确认字段，而不是完整的内部通信对象——防止MCP客户端的上下文窗口被淹没

v0.7.0 -添加了delete_article、create_collection、list_admin；优化搜索文章响应

特征

条款

✅ get_article -按ID获取一篇文章
✅ list_articles -按页码列出文章
✅ search_articles -按关键字搜索文章，并支持突出显示
✅ create_article -创建包含多语言内容的新文章
✅ update_article -用部分更新更新现有文章
✅ delete_article -永久删除文章

集合

✅ list_collections -列出所有帮助中心集合
✅ get_collection -按ID获取单个集合
✅ update_collection -更新收藏信息和翻译
✅ delete_collection -删除收藏（永久）
✅ create_collection -创建新的帮助中心集合

管理员

✅ list_admins -列出工作区管理员（用于查找有效的author_id）

对话

✅ search_conversations -搜索对话（精简列表：id/state/contact/时间戳，无部分）
✅ get_conversation -获取一个包含消息历史记录的对话（slim：保留注释/笔记/快速回复以及任何包含打开/分配部分+附件的消息；过滤掉纯系统事件）

CS工作流程

✅ reply_conversation -以管理员身份回复对话（返回微弱确认）
✅ send_outbound_email -通过电子邮件地址向联系人发送新的出站电子邮件（解析/创建联系人，返回新的对话_id）
✅ add_conversation_note -在对话中添加内部注释
✅ close_conversation -结束对话
✅ update_ticket_state -更新票证的状态

安装

克隆存储库：

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

安装依赖项：

npm install

构建项目：

npm run build

配置

获取内部通信访问令牌

转到对讲机设置→ 开发者→ 开发者中心
创建新应用程序或使用现有应用程序
通过以下方式获取访问令牌条款和对话读写权限

环境变量

变量	必填	描述
`INTERCOM_ACCESS_TOKEN`	✅ 始终	您的对讲机API访问令牌
`INTERCOM_ADMIN_ID`	✅ 对于CS工具	用于 `reply_conversation`, `add_conversation_note` 和 `send_outbound_email` 当 `admin_id` 未提供参数

使用Claude代码配置（推荐）

如果您使用的是Claude Code CLI，则可以轻松添加MCP服务器：

claude mcp add --transport stdio intercom-mcp \
  --env INTERCOM_ACCESS_TOKEN=<your_token> \
  --env INTERCOM_ADMIN_ID=<your_admin_id> \
  -- node /ABSOLUTE/PATH/TO/intercom-mcp/dist/index.js

替换：

<your_token> 使用您的对讲机接入令牌
/ABSOLUTE/PATH/TO/ 使用您的实际项目路径

要验证是否已配置：

claude mcp list

手动配置Claude桌面

或者，编辑您的Claude Desktop配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加此配置：

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/intercom-mcp/dist/index.js"
      ],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_access_token_here",
        "INTERCOM_ADMIN_ID": "your_admin_id_here"
      }
    }
  }
}

重要:

替换 /ABSOLUTE/PATH/TO/intercom-mcp 使用您的实际项目路径
替换 your_intercom_access_token_here 用你的真实代币
替换 your_admin_id_here 使用您的对讲机管理员ID（CS工具需要）

重新启动克劳德桌面

完全退出Claude Desktop并重新启动。

用法

配置后，您可以在Claude Desktop中使用这些命令：

列出文章

List Intercom articles

或

Show me the first 20 Intercom articles

获取文章详细信息

Get Intercom article with ID 9876543

搜索文章

Search for Intercom articles about "subscription"

或

Search published articles containing "播客" with highlighted matches

或

Find articles with keyword "訂閱" in Chinese

创建文章

Create a new Intercom article titled "Getting Started Guide" with content "Welcome to our platform" by author ID 123456, save as draft

更新文章

Update article 9876543 and change its state to published

列出收藏

List all Intercom Help Center collections

获取集合

Get collection with ID 14608214

更新收藏

Update collection 14608214 and add Japanese translation

删除收藏

Delete collection 16036040

用例：翻译管理

v0.4.0的一个关键特性是能够高效地管理多语言集合。

添加缺失的翻译

您可以轻松地将翻译添加到缺少某些语言的集合中：

Update collection 14608214 and add the missing Japanese translation: name "アカウント管理", description "アカウント設定を管理する"

批量翻译更新

检查哪些收藏缺少翻译：

List all collections and show me which ones are missing Japanese translations

然后逐一更新它们，或者创建一个计划来更新多个集合。

验证翻译

更新后，验证更改：

Get collection 14608214 and show me all available translations

工具参考

`get_article`

按ID获取一篇文章。

参数：

id （字符串，必填）：文章ID

例子：

{
  "id": "9876543"
}

`list_articles`

按页码列出文章。

参数：

page （数字，可选）：页码（默认值：1）
per_page （数量，可选）：每页文章数（默认值：10，最大值：50）

例子：

{
  "page": 1,
  "per_page": 20
}

`search_articles`

使用关键字搜索文章。支持跨文章内容的全文搜索，支持多语言（英语、中文、日语等）。

参数：

phrase （字符串，可选）：在文章中搜索关键字/短语
state （字符串，可选）：按文章状态筛选-“已发布”、“草稿”或“全部”（默认值：“全部”）
help_center_id （字符串，可选）：按特定帮助中心ID筛选

示例（按关键字搜索）：

{
  "phrase": "subscription"
}

示例（列出所有草稿，不需要关键字）：

{
  "state": "draft"
}

示例（中文关键字搜索）：

{
  "phrase": "訂閱制",
  "state": "all"
}

答复包括：

total_count：匹配文章总数
articles：每篇文章的摘要字段数组（id、标题、描述、状态、url、author_id、created_at、updated_at、parent_id、parent_type）

使用 get_article 获取特定文章的全部内容。

使用案例：

查找有关特定主题的所有文章
在多语言帮助中心搜索中文/日文内容
查找需要更新的文章
发现交联的相关内容

`create_article`

创建具有多语言支持的新文章。

参数：

title （字符串，必填）：文章标题
body （字符串，必填）：HTML格式的文章内容
author_id （数字，必填）：作者ID（必须是有效的内部通信团队成员）
description （字符串，可选）：文章描述
state （字符串，可选）：“draft”或“published”（默认值：“draw”）
parent_id （字符串，可选）：集合或节ID
parent_type （字符串，可选）：“collection”（默认）
translated_content （对象，可选）：多语言内容

示例（简单）：

{
  "title": "Getting Started Guide",
  "body": "<p>Welcome to our platform</p>",
  "author_id": 123456,
  "state": "draft"
}

示例（多语言）：

{
  "title": "Getting Started Guide",
  "body": "<p>Welcome to our platform</p>",
  "author_id": 123456,
  "state": "published",
  "translated_content": {
    "zh-TW": {
      "title": "入門指南",
      "body": "<p>歡迎使用我們的平台</p>",
      "author_id": 123456,
      "state": "published"
    },
    "ja": {
      "title": "スタートガイド",
      "body": "<p>プラットフォームへようこそ</p>",
      "author_id": 123456,
      "state": "published"
    }
  }
}

`update_article`

更新现有文章。只有提供的字段才会更新。

参数：

id （字符串，必填）：文章ID
title （字符串，可选）：更新标题
body （字符串，可选）：更新内容
description （字符串，可选）：更新的描述
state （字符串，可选）：“草稿”或“已发布”
author_id （数字，可选）：更新的作者ID
translated_content （对象，可选）：更新的翻译

示例（更改状态）：

{
  "id": "9876543",
  "state": "published"
}

示例（更新内容）：

{
  "id": "9876543",
  "title": "Updated Title",
  "body": "<p>Updated content</p>"
}

示例（添加翻译）：

{
  "id": "9876543",
  "translated_content": {
    "zh-TW": {
      "title": "更新的標題",
      "body": "<p>更新的內容</p>"
    }
  }
}

`list_collections`

列出所有帮助中心集合（顶级类别）。

参数：

page （数字，可选）：页码（默认值：1）
per_page （数量，可选）：每页收藏数（默认值：50，最大值：150）

例子：

{
  "page": 1,
  "per_page": 50
}

`get_collection`

按ID获取单个集合。

参数：

id （字符串，必填）：集合ID

例子：

{
  "id": "14608214"
}

`update_collection`

更新现有集合。只有提供的字段才会更新。非常适合添加缺失的翻译！

参数：

id （字符串，必填）：集合ID
name （字符串，可选）：更新集合名称（更新默认语言）
description （字符串，可选）：更新描述（更新默认语言）
parent_id （字符串，可选）：父集合ID（顶级为null）
translated_content （对象，可选）：更新的翻译

示例（更新名称和描述）：

{
  "id": "14608214",
  "name": "Account Management",
  "description": "Manage your account settings"
}

示例（添加缺失的日语翻译）：

{
  "id": "14608214",
  "translated_content": {
    "ja": {
      "name": "アカウント管理",
      "description": "アカウント設定を管理"
    }
  }
}

示例（更新多语言翻译）：

{
  "id": "14608214",
  "translated_content": {
    "ja": {
      "name": "アカウント管理",
      "description": "アカウント設定を管理する"
    },
    "id": {
      "name": "Manajemen Akun",
      "description": "Kelola pengaturan akun Anda"
    }
  }
}

`delete_collection`

永久删除收藏。 警告：此操作无法撤消！

参数：

id （字符串，必填）：要删除的集合ID

例子：

{
  "id": "16036040"
}

⚠️ 重要提示：

已删除的收藏无法恢复
收藏中的所有内容都可能受到影响
删除前始终备份重要数据

`delete_article`

永久删除一篇文章。 警告：此操作无法撤消！

参数：

id （字符串，必填）：要删除的文章ID

例子：

{
  "id": "9876543"
}

`create_collection`

创建新的帮助中心集合。

参数：

name （字符串，必填）：集合名称
description （字符串，可选）：集合描述
parent_id （字符串，可选）：嵌套的父集合ID（顶级省略）
translated_content （对象，可选）：按区域设置代码显示多语言内容

示例（简单）：

{
  "name": "Getting Started"
}

示例（带翻译）：

{
  "name": "Getting Started",
  "translated_content": {
    "zh-TW": {
      "name": "入門指南",
      "description": "開始使用我們的平台"
    }
  }
}

`list_admins`

列出所有工作区管理员。有助于查找有效 author_id 创建或更新文章时的值。

参数： 无

答复包括：

id：管理员ID（将其用作 author_id)
name：显示名称
email：电子邮件地址
has_inbox_seat：管理员是否有收件箱席位

`search_conversations`

使用Intercom查询对象搜索对话。返回a 苗条的 列表（无对话部分）--呼叫 get_conversation 为了获得完整的内容。

参数：

query （object，必填）：对讲机搜索查询对象，例如。 {"operator":"AND","value":[{"field":"state","operator":"=","value":"open"}]}.添加 {"field":"admin_assignee_id","operator":"=","value":<id>} 按受让人筛选，或 source.author.email 通过接触。还接受序列化为JSON字符串的对象。
per_page （数字，可选）：每页结果（默认值：20，最大值：50）
starting_after （字符串，可选）：来自前一个响应的分页光标 next

示例（所有公开对话）：

{
  "query": {"operator":"AND","value":[{"field":"state","operator":"=","value":"open"}]},
  "per_page": 50
}

答复包括：

total_count：匹配的对话总数
next：分页光标（如果有更多页面，则显示）
conversations：精简项数组（id、状态、打开、标题、主题、联系人、admin_assigne_id、时间戳）--无部分

`get_conversation`

获取包含消息历史记录的单个对话， 精简的 分类：过滤掉纯系统事件部分，但保留每个包含消息的部分（包括重新打开的电子邮件回复和第一个管理员回复）及其附件。

参数：

id （字符串，必填）：对话ID

例子：

{
  "id": "12345678"
}

答复包括：

顶层： id, state, open, title时间戳， waiting_since
source：包括。 delivered_as （识别真正的提问者）， subject, body, author
ticket：票单要点-- type, state，以及 title / description （真正的请求，从内部删除 _default_title_ / _default_description_ 钥匙；仅在有票时才出示）
ticket_attributes：所有具有非空值的票证表单自定义属性
contacts：联系人参考
total_parts / included_parts：过滤前后计数
parts: comment / note / quick_reply, 加任何 open / assignment 带有真实正文或附件的部分（重新打开电子邮件回复，第一个管理员回复）。每 { part_type, body, author, from_quick_reply, attachments, created_at } — from_quick_reply 将键入的回复与点击的快速回复选项区分开来； attachments （如果存在）列表 { name, url, content_type }

`reply_conversation`

以管理员身份回复对话。客户可以看到回复。返回一个细长的确认对象(id, state, last_part_id、时间戳）。

参数：

conversation_id （string，必填）：要回复的对话ID
body （string，必填）：回复消息正文（支持HTML）
admin_id （字符串，可选）：要回复的管理员ID（默认为 INTERCOM_ADMIN_ID 任何人）

例子：

{
  "conversation_id": "12345678",
  "body": "<p>Thank you for reaching out. We'll look into this right away.</p>"
}

`send_outbound_email`

开始a 新向通过电子邮件地址标识的联系人发送出站电子邮件，而不是对现有对话的回复。该工具将电子邮件解析为内部通信联系人（创建 lead 如果不存在），则通过消息API发送。因为新创建的联系人在发送时可以短暂地返回404，所以呼叫会以退避方式重试。返回新 conversation_id 所以你可以记录/跟踪它。

使用 reply_conversation 相反，当在现有对话中回应时。

参数：

email （字符串，必填）：收件人的电子邮件地址
subject （字符串，必填）：电子邮件主题
body （字符串，必填）：电子邮件正文（支持HTML）
admin_id （字符串，可选）：要发送的管理员ID（默认为 INTERCOM_ADMIN_ID env变量）。确定收件人看到的发件人姓名/地址。
template （字符串，可选）： plain 或 personal （默认为 personal --1:1个人电子邮件外观）

例子：

{
  "email": "member@example.com",
  "subject": "About your subscription",
  "body": "<p>Hello, ...</p>",
  "admin_id": "8530422"
}

注：消息API要求 to.id 成为Intercom联系人id，而不是原始电子邮件——此工具为您处理查找/创建。

`add_conversation_note`

在对话中添加内部注释。注释仅对团队成员可见，对客户不可见。

参数：

conversation_id （string，必填）：要添加注释的对话ID
body （string，必填）：备注内容（支持HTML）
admin_id （字符串，可选）：添加注释的管理员ID（默认为 INTERCOM_ADMIN_ID 任何人）

例子：

{
  "conversation_id": "12345678",
  "body": "<p>Customer has been refunded. Follow up in 3 days.</p>"
}

`close_conversation`

结束对话。

参数：

conversation_id （string，必填）：要关闭的对话ID

例子：

{
  "conversation_id": "12345678"
}

`update_ticket_state`

更新票证的状态。

参数：

ticket_id （字符串，必填）：要更新的票证ID
state （string，必填）：新票证状态--其中之一 in_progress, waiting_on_customer, resolved

例子：

{
  "ticket_id": "87654321",
  "state": "resolved"
}

发展

构建

npm run build

观看模式

npm run watch

故障排除

Claude Desktop未显示工具

检查配置文件路径是否正确
验证JSON格式（无尾随逗号）
完全重新启动克劳德桌面
检查绝对路径 dist/index.js

API错误

验证您的访问令牌是否正确
确保令牌具有文章和对话读/写权限
检查对讲机API状态

构建错误

确保TypeScript版本>=5.0
删除 node_modules 和 dist那么：

npm install && npm run build

项目结构

intercom-mcp/
├── package.json           # Project configuration
├── tsconfig.json          # TypeScript configuration
├── src/
│   └── index.ts           # Main server code
├── dist/                  # Compiled output
└── README.md             # This file

路线图

已完成

✅ 获取文章（v0.1.0）
✅ 列出文章（v0.1.0）
✅ 创建文章（v0.2.0）
✅ 更新文章（v0.2.0）
✅ 文章多语言支持（v0.2.0）
✅ 列表集合（v0.3.1）
✅ 获取收藏（v0.3.1）
✅ 更新集合（v0.4.0）
✅ 删除集合（v0.4.0）
✅ 集合的多语言支持（v0.4.0）
✅ 使用关键字匹配和突出显示搜索文章（v0.5.0）
✅ 回复对话（v0.6.0）
✅ 在对话中添加内部注释（v0.6.0）
✅ 亲密对话（v0.6.0）
✅ 更新票证状态（v0.6.0）
✅ 删除文章（v0.7.0）
✅ 创建集合（v0.7.0）
✅ 列表管理员（v0.7.0）
✅ 优化搜索_文章响应（v0.7.0）
✅ 搜索对话--精简列表（v0.8.0）
✅ 获取对话——精简，分流感知（系统事件已过滤， from_quick_reply 标志）（v0.8.0）
✅ 精简操作工具响应以保护客户端上下文（v0.8.0）
✅ 获取对话——保留重新打开/分配消息部分+附件，表面票标题/描述（v0.8.3）

使用说明

内部通信MCP服务器

版本

特征

条款

集合

管理员

对话

CS工作流程

安装

配置

获取内部通信访问令牌

环境变量

使用Claude代码配置（推荐）

手动配置Claude桌面

重新启动克劳德桌面

用法

列出文章

获取文章详细信息

搜索文章

创建文章

更新文章

列出收藏

获取集合

更新收藏

删除收藏

用例：翻译管理

添加缺失的翻译

批量翻译更新

验证翻译

工具参考

get_article

list_articles

search_articles

create_article

update_article

list_collections

get_collection

update_collection

delete_collection

delete_article

create_collection

list_admins

search_conversations

get_conversation

reply_conversation

send_outbound_email

add_conversation_note

close_conversation

update_ticket_state

发展

构建

观看模式

故障排除

Claude Desktop未显示工具

API错误

构建错误

项目结构

路线图

已完成

计划的

资源

许可证

相关 MCP

Unity MCP AI游戏开发工具

SearXNG与n8n集成服务器

AI模型协调服务

智能任务管理系统

Bluesky代理发布服务

LLM交互工具

`get_article`

`list_articles`

`search_articles`

`create_article`

`update_article`

`list_collections`

`get_collection`

`update_collection`

`delete_collection`

`delete_article`

`create_collection`

`list_admins`

`search_conversations`

`get_conversation`

`reply_conversation`

`send_outbound_email`

`add_conversation_note`

`close_conversation`

`update_ticket_state`