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

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

作为 MCP（Model Context Protocol，模型上下文协议）的原生发起与深度支持平台，Claude（包含网页版与桌面客户端 Claude Desktop）能够非常丝滑地调用外部企业工具。通过立刻智能体的 MCP 管理功能，企业可以将内部知识库、智能体问答、HS 编码、汇率查询以及立刻云查单等能力统一接入 Claude。

Claude 网页版与桌面版的自定义 MCP 接入采用 **OAuth 授权机制**。由企业管理员在后台完成统一配置后，员工只需使用个人控制台账号登录并确认授权，即可在权限范围内直接让 Claude 调用企业工具，全程无需接触或填写企业 API Key。

本文面向企业管理员与使用者，详细介绍管理员前置配置、员工端 Claude 授权连接，以及常见问题的排查处理。

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

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

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

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

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

1.  进入 **外部拓展 → API设置**，新建一个 Key，建议单独命名为 **“OAuth 接入”**（如已为其他 OAuth 平台创建过，可直接共用）。
2.  完整 Key 只在新建时显示一次，请及时保存。

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

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

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

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

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

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

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

### 5\. 分配员工权限并提供服务地址

1.  为需要使用的员工授予 **“MCP 个人授权”** 权限。
2.  在“接入配置”中选择 Claude 对应平台，复制 **不带企业代码** 的 OAuth 服务地址提供给员工：
3.  `[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)`

三、第二步：员工在 Claude 网页版 / 桌面版中添加并授权
--------------------------------

员工获取服务地址后，可按以下步骤在 Claude 网页版或桌面版中完成绑定：

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

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

通过 OAuth 接入时，除了受底层 Key 控制外，调用以下工具还会额外检查**员工本人的控制台权限**：

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

四、第三步：在 Claude 中调用工具与实战场景
-------------------------

完成授权后，员工可以在 Claude 对话框中直接用自然语言提问，Claude 会自动识别意图并请求调用立刻智能体的 MCP 工具：

1.  **检索企业知识库与智能体问答**
2.  _“从企业知识库查一下，AI 应收录入怎么使用？”_
3.  _“把刚才整理的常见问题解答，新增一条到企业知识库中。”_
4.  **查询 HS 编码与实时汇率**
5.  _“帮我查询‘笔记本电脑’的 HS 编码及申报详情。”_
6.  _“查询美元兑人民币汇率，并换算 1,000 美元。”_
7.  **查询立刻云订单与下载单证（旗舰版专属）**
8.  _“查询指定客户群（企微群ID：xxxx）对应的这票订单，并获取提单文件下载链接。”_
9.  _提示：群渠道支持企微或 QQ。群标识可在目标群中发送“群ID”获取，也可让 Claude 先调用“可推送群列表”查询。单次订单查询最多返回 10 票信息；单证获取最多返回 5 份文件（≤50MB）的文件名和下载链接。_

五、工具能力、计费规则与授权管理
----------------

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

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

### 2\. 授权管理与失效规则

1.  **查看与撤销**：管理员可在 **MCP管理 → 个人授权** 中查看和撤销员工授权；员工可在 **系统管理 → 个人设置 → 已授权的 AI 助手** 中管理自己的授权。
2.  **失效情形**：超过 **30 天未使用** 的授权需要重新授权；管理员撤销授权、员工修改或重置密码、收回“MCP 个人授权”等操作，均会使原授权立即失效。

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

在 **MCP管理 → 调用记录** 中，支持按时间、Key、工具、结果、来源等条件查询。OAuth 调用会显示 **“员工姓名 · 客户端名”**，便于核对调用参数摘要、失败原因、耗时与消耗（专业版保存 90 天，旗舰版保存 365 天）。