MCP 集成

Intercom 集成配置指南

通过 Kocoro 预置的 Intercom MCP Server,让 AI 直接读取你的 Intercom 会话、客户、工单与团队信息——只需开启一个开关并完成一次 OAuth 授权。

开始前的准备

  • 已安装 Kocoro Mac App(Intercom MCP Server 已预置在 Kocoro 中,无需手动 Add Server)。
  • 拥有可访问的 Intercom 工作区,并具备授权第三方 OAuth 应用的权限。
  • 网络环境可以正常访问 Intercom。
  1. 1

    进入 MCP Servers

    打开 Kocoro Mac App,在左侧导航的 Capabilities 分组下点击 MCP Servers。这是 Kocoro 管理所有外部能力(包括 Intercom)的入口。

    图 1:Kocoro 主界面 — 左侧 MCP Servers 入口。
  2. 2

    找到预置的 Intercom,打开开关

    Kocoro 已经把 Intercom MCP Server(https://mcp.intercom.com/mcp)预置在列表里,无需自己 Add Server。直接点击该行右侧的开关,Kocoro 会自动唤起默认浏览器,跳转到 Intercom 的 OAuth 授权页。

    如果列表里看不到 intercom,请把 Kocoro 升级到最新版本。
    图 2:MCP Servers 列表 — 点击 intercom 右侧的开关。
  3. 3

    在 Intercom 端确认权限并授权

    在 Intercom 授权页可以看到 intercom-api-mcp-server 申请的权限范围:People、Companies、Conversations、Teams and teammates、Tags、AI content 等只读访问。检查无误后点击绿色 Authorize access 按钮。

    授权范围全部为只读,Kocoro 不会向你的 Intercom 工作区写入任何数据。
    图 3:Intercom OAuth 授权页 — 点击 Authorize access。
  4. 4

    授权完成

    浏览器会自动跳转,并显示一个授权成功的提示页面(出现 Authorization successful! 字样),直接关闭这个标签页即可。

    图 4:OAuth 回调成功页。
  5. 5

    回到 Kocoro 确认连接已激活

    切回 Kocoro 的 MCP Servers 页面,intercom 左侧会出现一个绿色圆点,开关也变为开启状态——说明 Intercom MCP 连接已经建立,Kocoro 可以开始调用 Intercom 工具了。

    图 5:连接激活 — intercom 左侧出现绿色圆点。

完成!开始使用 Intercom

回到 Messages,直接用自然语言提问,Kocoro 会自动选择 Intercom 工具并返回结构化结果。

图 6:在 Messages 中向 Intercom 提问,获得结构化的工单清单。

推荐的提问范例

  • 今天 Intercom 里有哪些紧急的工单需要优先处理?
  • 汇总过去 7 天里 Intercom 的新会话,按客户公司分组。
  • 客户 X 最近一周提了哪些问题?请总结主要诉求与未解决项。
  • 把今天所有未读的 Intercom 会话整理成一份待办清单。

常见问题

MCP Servers 列表里看不到 Intercom?

请把 Kocoro 升级到最新版本——Intercom MCP Server 是随 Kocoro 预置下发的,旧版本可能尚未包含。

打开开关后没有自动弹出浏览器?

请检查系统的默认浏览器是否设置正常,然后把开关关闭再重新打开试一次。

授权后绿色圆点一直不出现?

在 MCP Servers 列表里把开关关闭再重新打开;如仍不生效,可在 Kocoro 的 Settings 中查看日志。

如何撤销 Kocoro 对 Intercom 的访问权限?

在 Intercom 后台的 Authorized apps 中 revoke intercom-api-mcp-server,或直接在 Kocoro MCP Servers 列表里关闭开关。