立刻智能体 MCP 使用教程：让 ChatGPT、Claude 调用企业知识库与业务工具

正文

在 ChatGPT、Claude 或 Cursor 中工作时，如果需要查企业知识库、查询汇率，或者获取立刻云订单信息，可以直接让当前使用的 AI 助手调用立刻智能体的工具。

立刻智能体的 MCP 管理提供了统一接入方式。管理员开通权限并选择工具后，支持 MCP 的 AI 助手就能在授权范围内调用企业能力，无需为每个平台分别开发接口。

本文面向控制台使用者，介绍如何开通、如何管理，以及调用失败时如何排查。

一、MCP 接入后可以做什么

MCP 是 Model Context Protocol 的缩写，中文为“模型上下文协议”，用于让 AI 助手以统一方式调用外部工具。

立刻智能体目前提供以下能力：

例如，接入并开通对应工具后，可以向 AI 助手提出这些请求：

1. “从企业知识库查一下，AI 应收录入怎么使用？”
2. “帮我查询‘笔记本电脑’的 HS 编码。”
3. “查询美元兑人民币汇率，并换算 1,000 美元。”
4. “查询指定客户群对应的这票订单，并获取提单文件。”

实际可用工具取决于企业套餐、Key 的能力授权与工具开关；通过 OAuth 接入时，部分工具还需要员工本人具备相应权限。

二、先确认套餐、入口与权限

适用套餐：专业版 Pro、旗舰版 Ultra。基础版暂不支持。

功能入口为：控制台 → 外部拓展 → MCP管理。

页面包含三个 Tab：

1. 对外开放：选择 Key、开关工具、复制接入配置、开启 OAuth 接入。
2. 个人授权：查看和撤销员工已授权的 AI 助手。
3. 调用记录：查看工具调用结果、失败原因与消耗。

企业管理员始终拥有 MCP 管理权限。员工如需管理接入，须单独获得 “MCP管理”权限，该权限依赖“API设置”。

员工如需用个人账号授权外部 AI 助手，则须获得 “MCP 个人授权”权限，该权限依赖“个人设置”。

以上两项权限均不包含在“全部标准功能”授权模式中，需要管理员单独勾选。 为 Key 开通“MCP 接入”的开放 API 权限，仍只有企业管理员可以修改。

三、使用 API Key 接入

Cursor、Claude Code、Codex、企业微信大圆、千问办公、WorkBuddy 等支持 MCP 的工具，可以使用企业 API Key 接入。

1. 新建并保存 Key

进入 外部拓展 → API设置，新建一个 Key，例如“Cursor 接入”。

完整 Key 只在新建时显示一次，请及时保存；后续页面只能查看前缀。建议为不同平台分别创建 Key，方便独立管理工具与调用频率。

2. 开通 MCP 和对应能力

由企业管理员进入 系统设置 → 开放 API 权限，启用“MCP 接入”，勾选刚创建的 Key 并保存。

根据需要，还要为该 Key 开通对应能力：

3. 选择需要开放的工具

进入 外部拓展 → MCP管理 → 对外开放，在“可用 Key”中选中该 Key，再到“工具清单”按需开启工具。

如果开关置灰，可以查看提示原因，确认是否存在套餐不支持、Key 缺少能力授权或工具暂不可用等情况。

4. 复制平台配置

在“接入配置”中选择对应平台，点击“复制配置”，按页面说明填写到 AI 工具中，并将 Key 占位符替换为完整 Key。

Key 接入的服务地址形如：

https://agent.likelic.com/mcp?customer_code=你的企业代码

控制台会自动带入本企业代码，直接复制即可。Key 应按配置放入请求头，不要拼接到 URL 中。

5. 检查并试用

选中 Key，点击“检查开通状态”，确认 Key、套餐与 MCP 接入状态正常，再回到 AI 工具发起一次工具调用。

随后到“调用记录”中检查结果。“检查开通状态”本身不计费、不占调用次数，也不会产生调用记录。

四、ChatGPT 和 Claude 使用 OAuth 授权接入

Claude 网页版 / 桌面版、ChatGPT 的此类自定义 MCP 接入使用 OAuth 授权。员工通过自己的控制台账号登录并同意授权，无需向 AI 助手填写企业 Key。

管理员先开启接入

1. 准备一个已开通“MCP 接入”的 Key，建议单独命名为“OAuth 接入”。
2. 为该 Key 配置所需的能力授权，并在 MCP管理中开启工具。
3. 在“对外开放”的“OAuth 授权接入”区域选择这个 Key，打开接入开关。
4. 为需要使用的员工授予“MCP 个人授权”权限。
5. 在“接入配置”中选择对应平台，将服务地址提供给员工。

OAuth 接入使用不带企业代码的地址：

https://agent.likelic.com/mcp

所有员工的 OAuth 调用共用管理员选定的这个 Key。 可用工具、能力授权、调用频率与企业计费均受该 Key 的配置约束。

员工添加并授权

在 Claude 的连接器或 ChatGPT 的应用 / 连接器设置中，找到自定义 MCP 接入入口，填写服务地址；需要选择认证方式时，选择 OAuth。

按提示跳转至立刻智能体授权页，填写企业代码、用户名与密码，核对企业、客户端和工具清单后同意授权。

平台菜单名称可能随版本调整，具体填写方式以控制台“接入配置”中的对应平台说明为准。

授权须在发起授权的同一个浏览器中完成。 如果提示“授权请求已被处理”或“授权请求无效”，请回到 AI 助手重新发起授权，并确认浏览器允许 Cookie。

部分工具还要检查员工权限

新增知识还受员工的“知识分类”授权限制，只能写入被授权的分类。以上员工权限限制适用于 OAuth 调用，Key 接入不受这条限制。

管理员可在 MCP管理 → 个人授权中查看和撤销授权；员工可在 系统管理 → 个人设置 → 已授权的 AI 助手中管理自己的授权。

超过 30 天未使用的授权需要重新授权。撤销授权、员工修改或重置密码、收回“MCP 个人授权”等操作，也会使原授权失效。

五、旗舰版如何查询立刻云订单与单证

旗舰版提供“立刻云单号查询”和“立刻云单证获取”两个工具，数据范围与群内 @ 机器人查单号一致。

使用前需要：

1. 在 系统设置 → 单号查询中配置立刻云服务地址。
2. 在 MCP管理的工具清单中，为对应 Key 手动开启这两个工具，默认均为关闭。
3. 准备订单号、群渠道与群标识；获取单证时，还需提供企业已配置的单证类型。

群渠道为企微或 QQ。群标识可以在目标群中发送“群ID”获取，也可以在具备推送通知能力时，让 AI 助手查询“可推送群列表”。目标群须被本企业任一未删除的机器人收录过。

订单查询最多返回 10 票信息；单证获取最多返回 5 份文件的文件名和下载链接，超出部分会提示登录系统查看。单证类型须在企业配置清单中，超过 50MB 的文件只列文件名，不提供转存下载。

直接通过 MCP 调用这两个工具，在立刻智能体侧免费，不经大模型、不扣技能点。 查询会同时占用 MCP 调用频率，以及与群内查单共用的立刻云查询频率额度。

六、工具开关、计费与调用记录怎么管理

按 Key 控制工具

工具开关按 Key 分别设置，同一工具可以只向指定 Key 开放。

通常只读工具默认开启；“新增知识”“推送通知”默认关闭，立刻云两个只读工具也默认关闭。

新增知识会写入企业知识库；推送通知会对外发送，发出后不能撤回。 开启这两类工具时，页面会二次确认，请按实际用途开放。

关闭某个工具后，该 Key 通过 MCP 调用智能体问答时，也不能再间接调用对应技能；控制台和其他渠道不受影响。

Key 被停用或移出相关能力授权时，已开启的写入类工具会自动关闭。重新启用或授权后，需要手动开启，不会自动恢复。

计费沿用对应能力规则

1. 智能体问答：按实际消耗扣除套餐 Token。
2. 知识检索、新增知识：只计向量化 Token。
3. HS 编码、舱单查询：成功出站扣技能点，技术失败自动冲正。
4. 汇率查询、可推送群列表、立刻云两个工具：免费。
5. 推送通知：占用推送通知额度。

具体以工具清单中的“计费”说明为准。HS 编码、汇率、舱单经 MCP 直接调用时，不经过智能体；在技能点用量明细中，智能体显示为“未调用智能体”，渠道显示为“MCP”。

MCP 与开放 API 共用同一 Key 的每分钟调用上限，建立连接、列出工具等请求也计入次数。

到调用记录定位问题

在 MCP管理 → 调用记录中，可以按时间、Key、工具、结果、来源等条件查询，查看调用人、参数摘要、失败原因、耗时与消耗。

OAuth 调用会显示“员工姓名 · 客户端名”，便于核对使用情况。

记录保存期限为：专业版 90 天，旗舰版 365 天。记录只保存参数摘要；鉴权失败、套餐不支持、未开通、超出频率或参数格式错误等在进入工具前被拒绝的请求，不会产生工具调用记录。

七、常见问题与处理

遇到超时，需要根据工具类型处理：

1. 只读查询超时：稍后重试。
2. 新增知识提示“结果未确认”：先用知识检索核实是否已新增，避免重复写入。
3. 推送通知提示“结果未确认”：发送可能已受理；如需重试，使用相同的 biz_msg_id，避免重复发送。

开发者及合作方如需查看接口参数、返回结构、错误码和更多限制，请阅读立刻智能体 MCP 技术文档。