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

来源: https://www.likelic.com/blog/agent-mcp-setup-guide.html

正文
--

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

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

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

一、MCP 接入后可以做什么
--------------

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

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

| **工具** | **可以做什么** | **适用套餐** |
| --- | --- | --- |
| 知识检索 | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 |
| 智能体问答 | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 |
| 新增知识 | 向企业知识库新增一条问答 | 专业版 / 旗舰版 |
| HS 编码查询 | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 |
| 汇率查询 | 查询汇率并换算金额 | 专业版 / 旗舰版 |
| 可推送群列表 | 查询当前可推送通知的群 | 专业版 / 旗舰版 |
| 推送通知 | 向指定群发送通知 | 专业版 / 旗舰版 |
| 舱单查询 | 按提运单号查询舱单状态 | 仅旗舰版 |
| 立刻云单号查询 | 查询指定客户群可见的单票信息 | 仅旗舰版 |
| 立刻云单证获取 | 获取指定订单的单证文件下载链接 | 仅旗舰版 |

例如，接入并开通对应工具后，可以向 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 开通对应能力：

| **需要使用的工具** | **需要开通的能力** |
| --- | --- |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |

### 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。

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

| **工具** | **员工本人需要的权限** |
| --- | --- |
| 新增知识 | 知识库 |
| 可推送群列表、推送通知 | 合作管理或 API设置，任一即可 |
| 立刻云单号查询、立刻云单证获取 | 合作管理、企微机器人或 QQ机器人，任一即可 |

新增知识还受员工的“知识分类”授权限制，只能写入被授权的分类。以上员工权限限制适用于 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 天**。记录只保存参数摘要；鉴权失败、套餐不支持、未开通、超出频率或参数格式错误等在进入工具前被拒绝的请求，不会产生工具调用记录。

七、常见问题与处理
---------

| **问题** | **处理方法** |
| --- | --- |
| 提示 Key 或企业代码无效 | 核对完整 Key、企业代码、启用状态与有效期；完整 Key 遗失时需新建 |
| 提示未开通 MCP | 请管理员到“系统设置 → 开放 API 权限”启用 MCP 接入并勾选该 Key |
| 工具列表中找不到某个工具 | 检查套餐、能力授权、工具开关；OAuth 接入还需检查员工权限 |
| 提示授权失效或暂停 | 先确认企业 OAuth 开关、接入 Key、套餐与员工权限正常，再按提示重新连接 |
| 提示调用过于频繁 | 稍后重试，或由管理员在 API设置中调整该 Key 的调用频率 |
| 提示尚未配置立刻云服务 | 到“系统设置 → 单号查询”配置立刻云服务地址 |
| 提示群不存在或不可用 | 在目标群重新获取群ID，并确认该群已被本企业机器人收录 |

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

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

开发者及合作方如需查看接口参数、返回结构、错误码和更多限制，请阅读[立刻智能体 MCP 技术文档](https://agent.likelic.com/doc/mcp/)。