mcpField
S
supportchat

supportchat

本地服务
github.com/CloudCorpRecords通信协作02 周前更新
代码仓库

关于 supportchat

supportchat 将 Intercom REST API 的核心会话、联系人、标签和文章操作封装为工具，面向处理 Intercom 支持工作的开发者与 Agent。它使用访问令牌进行 API 调用，不包含托管 OAuth。

主要功能

  1. 01列出、搜索和读取会话
  2. 02回复或关闭会话
  3. 03列出、创建和更新联系人
  4. 04列出标签并为联系人添加标签
  5. 05列出文章

适用场景

  1. 01查找待处理的支持会话
  2. 02回复或关闭客户会话
  3. 03维护联系人信息和标签
  4. 04浏览 Intercom 文章

MCP 相关

提供 stdio MCP 服务，向 MCP 客户端开放 12 个 Intercom REST API 工具；调用需要配置 INTERCOM_ACCESS_TOKEN。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "cloudcorprecords-supportchat": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/supportchat"
      ]
    }
  }
}
启动命令npx -y @reneturcios/supportchat

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@reneturcios/supportchat0.1.0
ocighcr.io/cloudcorprecords/supportchat:0.1.0

工具

12

收录的工具列表 · 更新于 1 周前

参数类型必填说明
statestring否用于筛选的可选会话状态，通过 state 查询参数传递。
per_pagenumber否每页返回的会话数上限（可选）。

详细介绍

supportchat

将 Intercom 支持对话封装为 MCP 工具，并接入 Intercom REST API。supportchat 以全新名称对 Intercom MCP 服务的核心功能进行了洁净室重建：代码全新编写，不复制品牌元素。原版是 Intercom 托管的远程 MCP 服务 （OAuth）；本项目不复现托管 OAuth——这是一个使用令牌访问同一 API 的 REST 客户端。

工具（核心子集，共 12 个）

list_conversations、get_conversation、 reply_to_conversation、close_conversation、 search_conversations、list_contacts、 get_contact、create_contact、update_contact、list_tags、 tag_contact、list_articles。

此子集中不包含：文章详情（为确保恰好 12 个工具而移除 get_article）、公司、团队和队友管理、事件和数据属性、备注、 工单、工作流、访客转化工具，以及计数和报告导出。

设置

为你的 Intercom 工作区创建访问令牌并进行设置：

export INTERCOM_ACCESS_TOKEN=dG9r...

也可以选择通过 INTERCOM_API_BASE_URL 覆盖 API 基础地址 （默认值为 https://api.intercom.io）。每个请求都会携带 Intercom-Version: 2.11 标头。如果未设置令牌，每次工具调用 都会失败，并指出缺少的变量。回复和关闭对话时，需要提供执行操作的管理员的 admin_id。

命令行界面

npx @reneturcios/supportchat list_conversations '{"state":"open"}'
npx @reneturcios/supportchat mcp        # stdio MCP server

每个工具名称都是一个子命令，接受一个 JSON 对象参数。

MCP 客户端配置

{
  "mcpServers": {
    "supportchat": {
      "command": "npx",
      "args": ["-y", "@reneturcios/supportchat", "mcp"],
      "env": { "INTERCOM_ACCESS_TOKEN": "dG9r..." }
    }
  }
}

Docker

docker run -i -e INTERCOM_ACCESS_TOKEN ghcr.io/cloudcorprecords/supportchat

开发

npm install
npm run build
npm test

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。