# 立刻智能体 MCP 接入 ChatGPT 教程：通过 OAuth 授权调用企业知识库与业务工具

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

在 ChatGPT 中处理日常工作时，如果需要检索企业内部知识库、查询实时汇率与 HS 编码，或者获取立刻云的订单与单证文件，无需频繁切换系统——通过立刻智能体的 MCP（Model Context Protocol，模型上下文协议）管理功能，即可让 ChatGPT 直接调用企业级业务工具。

ChatGPT 的自定义 MCP 接入采用 **OAuth 授权机制**。由企业管理员在后台统一配置底层 Key 与工具范围后，员工只需使用自己的立刻智能体账号登录并同意授权，即可安全使用，全程无需向员工暴露企业 API Key。

本文面向企业管理员与使用者，详细介绍如何完成管理员前置配置、员工端 ChatGPT 授权绑定，以及常见问题的排查处理。

一、接入前准备：确认套餐与入口
---------------

1.  **适用套餐**：立刻智能体 **专业版 Pro**、**旗舰版 Ultra**（基础版暂不支持）。
2.  **功能入口**：控制台 → 外部拓展 → MCP管理。
3.  **管理权限说明**：
4.  企业管理员默认拥有全部配置权限。
5.  若交由指定员工负责日常维护，需为该员工单独勾选 **“MCP管理”** 权限（依赖“API设置”）。
6.  需要使用 ChatGPT 连接立刻智能体的员工，必须单独获得 **“MCP 个人授权”** 权限（依赖“个人设置”）。
7.  _注：以上两项权限均不包含在“全部标准功能”授权模式中，须由管理员单独勾选；且为 Key 开通“MCP 接入”的开放 API 权限仅限企业管理员操作。_

二、第一步：企业管理员开启 OAuth 接入
----------------------

在员工绑定 ChatGPT 之前，企业管理员需在立刻智能体控制台完成以下五步前置配置：

### 1\. 准备专属 API Key

1.  进入 **外部拓展 → API设置**，新建一个 Key，建议单独命名为 **“OAuth 接入”**（或与其它 OAuth 客户端共用）。
2.  完整 Key 仅在新建时显示一次，请妥善保存。

### 2\. 开通 MCP 与对应底层能力

1.  进入 **系统设置 → 开放 API 权限**，启用 **“MCP 接入”**，勾选刚刚创建的“OAuth 接入”Key 并保存。
2.  根据计划开放给 ChatGPT 的工具，为该 Key 开通对应的底层能力授权：

| **计划使用的工具** | **需为 Key 开通的能力授权** |
| --- | --- |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |
| HS 编码、汇率查询、舱单查询、立刻云查单 | 无需额外能力（由套餐与工具开关控制） |

### 3\. 开启工具清单

1.  进入 **外部拓展 → MCP管理 → 对外开放**，在“可用 Key”中选中该 Key。
2.  在 **“工具清单”** 中按需打开要开放给员工的工具开关（只读工具通常默认开启；“新增知识”“推送通知”及立刻云两个查单工具默认关闭，需手动开启）。
3.  _注：若为旗舰版且需使用“立刻云单号查询”或“立刻云单证获取”，请先前往_ **_系统设置 → 单号查询_** _配置立刻云服务地址。_

### 4\. 开启 OAuth 授权开关

1.  在“对外开放”页面的 **“OAuth 授权接入”** 区域，选择该 Key，打开接入开关。
2.  **注意**：所有员工通过 OAuth 发起的 ChatGPT 调用，均共用管理员选定的这个 Key。可用工具、能力授权、每分钟调用频率上限与企业计费均受该 Key 的配置约束。

### 5\. 为员工分配权限与服务地址

1.  为需要使用的员工授予 **“MCP 个人授权”** 权限，并确保员工本人具备对应业务工具的操作权限（详见下文“员工权限检查表”）。
2.  在控制台“接入配置”中选择 ChatGPT，复制 **不带企业代码** 的 OAuth 专属服务地址提供给员工：
3.  `[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)`

三、第二步：员工在 ChatGPT 中添加并完成授权
--------------------------

员工拿到服务地址后，按以下步骤将立刻智能体接入自己的 ChatGPT 账号：

1.  **进入连接器设置**
2.  打开 ChatGPT（网页版或桌面客户端），进入 **设置（Settings） → 应用 / 连接器（Apps / Connectors）** 页面，找到自定义 MCP 接入入口（注：平台菜单名称可能随版本微调，具体以控制台“接入配置”中的说明为准）。
3.  **填写地址并选择 OAuth**
4.  在服务地址栏填入：`[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)`
5.  认证方式（Authentication）选择 **OAuth**，点击发起连接。
6.  **登录立刻智能体并确认授权**
7.  浏览器会自动跳转至立刻智能体授权登录页。
8.  依次填写本企业的 **企业代码、个人用户名与登录密码**。
9.  登录成功后，仔细核对页面显示的 **企业名称、客户端标识（ChatGPT）以及即将授权的工具清单**，确认无误后点击 **“同意授权”**。
10.  **浏览器环境要求（重要）**
11.  **授权过程必须在发起授权的同一个浏览器中完成**，且需确认浏览器允许 Cookie。
12.  如果页面提示“授权请求已被处理”或“授权请求无效”，请关闭当前标签页，回到 ChatGPT 重新发起授权连接。

### ⚠️ 员工个人业务权限检查表

通过 OAuth 接入时，除了受底层 Key 控制外，调用部分特定工具还会校验**员工本人的控制台账号权限**。若员工缺少以下权限，即使总开关已开启，该员工在 ChatGPT 中也无法调用对应工具：

| **工具名称** | **员工本人需要具备的权限** | **补充说明** |
| --- | --- | --- |
| **新增知识** | 知识库 | 受员工的“知识分类”授权限制，只能写入被授权的分类 |
| **可推送群列表、推送通知** | 合作管理 或 API设置（任一即可） | 推送通知发出后不可撤回，请谨慎操作 |
| **立刻云单号查询、立刻云单证获取** | 合作管理、企微机器人 或 QQ机器人（任一即可） | 仅旗舰版可用，目标群须被本企业未删除的机器人收录 |

四、第三步：在 ChatGPT 中调用工具与实战示例
--------------------------

完成绑定后，员工即可在 ChatGPT 对话框中直接用自然语言下达指令，ChatGPT 会自动匹配并调用立刻智能体工具：

1.  **查企业知识库与智能体问答**
2.  提问示例：_“从企业知识库查一下，AI 应收录入怎么使用？”_
3.  写入示例（需开启写入开关）：_“帮我向企业知识库的‘财务规范’分类新增一条问答：……”_
4.  **关务与财务日常查询**
5.  提问示例：_“帮我查询‘笔记本电脑’的 HS 编码及详情。”_
6.  提问示例：_“查询今日美元兑人民币汇率，并帮我换算 1,000 美元等于多少人民币。”_
7.  **查询立刻云订单与获取单证（旗舰版）**
8.  提问示例：_“查询XX企业对应的这票订单（单号：XXXX）的最新状态，并获取提单文件下载链接。”_

五、能力范围、计费与授权管理
--------------

### 1\. 工具能力与计费规则一览

| **工具名称** | **可以做什么** | **适用套餐** | **计费规则** |
| --- | --- | --- | --- |
| **知识检索** | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 | 只计向量化 Token |
| **智能体问答** | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 | 按实际消耗扣除套餐 Token |
| **新增知识** | 向企业知识库新增一条问答 | 专业版 / 旗舰版 | 只计向量化 Token |
| **HS 编码查询** | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| **汇率查询** | 查询汇率并换算金额 | 专业版 / 旗舰版 | 免费 |
| **可推送群列表** | 查询当前可推送通知的群 | 专业版 / 旗舰版 | 免费 |
| **推送通知** | 向指定群发送通知 | 专业版 / 旗舰版 | 占用推送通知额度 |
| **舱单查询** | 按提运单号查询舱单状态 | 仅旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| **立刻云单号查询** | 查询指定客户群可见的单票信息 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
| **立刻云单证获取** | 获取指定订单的单证文件下载链接 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |

### 2\. 授权查看、撤销与有效期

1.  **管理员视角**：可在 **外部拓展 → MCP管理 → 个人授权** 中集中查看所有员工已授权的 ChatGPT 客户端，并随时撤销指定授权。
2.  **员工视角**：可在 **系统管理 → 个人设置 → 已授权的 AI 助手** 中查看和管理自己的授权记录。
3.  **失效机制**：超过 **30 天未使用** 的授权会自动失效，需重新授权；管理员撤销授权、员工修改或重置密码、收回员工的“MCP 个人授权”权限，也会使原授权立即失效。

### 3\. 调用记录排查

在 **MCP管理 → 调用记录** 中，管理员可按时间、Key、工具、结果查询明细。ChatGPT 的 OAuth 调用会在记录中清晰标注 **“员工姓名 · 客户端名”**，方便核对调用人、参数摘要、耗时与消耗（记录保存期：专业版 90 天，旗舰版 365 天）。