# 立刻智能体 MCP 接入千问办公教程：使用 API Key 调用企业知识库与业务工具

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

在千问办公中处理日常文档、办公协同与业务咨询时，如果需要检索企业内部知识库、查询实时汇率与 HS 编码，或者获取立刻云订单及单证信息，可以直接通过立刻智能体的 MCP（Model Context Protocol，模型上下文协议）将企业能力接入千问办公。

千问办公支持通过 **企业 API Key** 方式接入 MCP。管理员在后台创建专属 Key、开启对应工具并复制配置后，即可在千问办公中统一调用授权范围内的企业能力，无需单独开发接口。

本文面向控制台管理员与使用者，介绍如何配置 API Key、如何接入千问办公，以及调用失败时的排查方法。

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

1.  **适用套餐**：立刻智能体 **专业版 Pro**、**旗舰版 Ultra**（基础版暂不支持）。
2.  **功能入口**：控制台 → 外部拓展 → MCP管理。
3.  **管理权限说明**：
4.  企业管理员始终拥有全部 MCP 管理权限。
5.  员工如需管理接入，须单独获得 **“MCP管理”** 权限（该权限依赖“API设置”，且不包含在“全部标准功能”授权模式中，需要管理员单独勾选）。
6.  为 Key 开通“MCP 接入”的开放 API 权限，仍只有**企业管理员**可以修改。
7.  _注：使用 API Key 接入时，实际可用工具取决于企业套餐、Key 的能力授权与工具开关，不受员工个人业务权限限制。_

二、第一步：在立刻智能体控制台配置 API Key
-------------------------

### 1\. 新建并保存专属 Key

1.  进入 **外部拓展 → API设置**，新建一个 Key，建议命名为 **“千问办公接入”**。
2.  **注意**：完整 Key 只在新建时显示一次，请及时复制保存；后续页面只能查看前缀。建议为不同平台分别创建独立的 Key，方便独立管理工具开关与调用频率。

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

1.  由企业管理员进入 **系统设置 → 开放 API 权限**，启用 **“MCP 接入”**，勾选刚创建的“千问办公接入” Key 并保存。
2.  根据业务需要，在同一页面为该 Key 开通对应的底层能力：

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

### 3\. 选择需要开放的工具

1.  进入 **外部拓展 → MCP管理 → 对外开放**，在“可用 Key”中选中该 Key，再到下方 **“工具清单”** 按需开启工具：
2.  通常只读工具默认开启。
3.  **“新增知识”**（会写入企业知识库）和 **“推送通知”**（会对外发送且发出后不能撤回）默认关闭，开启时页面会二次确认，请按实际用途开放。
4.  **“立刻云单号查询”** 与 **“立刻云单证获取”**（仅旗舰版）默认均为关闭。使用前需先在 **系统设置 → 单号查询** 中配置立刻云服务地址，再回到工具清单手动开启。
5.  如果开关置灰，可以查看提示原因，确认是否存在套餐不支持、Key 缺少能力授权或工具暂不可用等情况。

三、第二步：复制配置并接入千问办公
-----------------

### 1\. 复制平台配置

1.  在 **外部拓展 → MCP管理 → 对外开放** 的 **“接入配置”** 区域中，选择 **千问办公**。
2.  点击 **“复制配置”**，控制台会自动带入本企业代码（`customer_code`），生成的 Key 接入服务地址形如： `[https://agent.likelic.com/mcp?customer_code=你的企业代码](https://agent.likelic.com/mcp?customer_code=你的企业代码)`

### 2\. 填写到千问办公

1.  按页面说明将配置填写到千问办公的 MCP 工具配置处，并将 Key 占位符替换为你保存的 **完整 Key**。
2.  **安全提示**：Key 应按配置放入请求头（Headers），**不要直接拼接到 URL 中**。

### 3\. 检查开通状态并试用

1.  在控制台选中该 Key，点击 **“检查开通状态”**，确认 Key、套餐与 MCP 接入状态正常（“检查开通状态”本身不计费、不占调用次数，也不会产生调用记录）。
2.  回到千问办公发起一次工具调用，随后到控制台 **“调用记录”** 中检查结果。

四、第三步：在千问办公中调用工具示例
------------------

接入并开启对应工具后，可以在千问办公中直接向 AI 助手提出以下请求：

1.  **查企业知识库与新增问答**
2.  _“从企业知识库查一下，AI 应收录入怎么使用？”_
3.  _“帮我把刚才整理的报销说明，新增一条问答到企业知识库。”_
4.  **查询 HS 编码与汇率换算**
5.  _“帮我查询‘笔记本电脑’的 HS 编码。”_
6.  _“查询美元兑人民币汇率，并换算 1,000 美元。”_
7.  **查询立刻云订单与单证（旗舰版）**
8.  _“查询指定客户群（企微群ID：xxxx）对应的这票订单，并获取提单文件。”_
9.  _使用说明：查询需提供订单号、群渠道（企微或 QQ）与群标识（可在目标群发送“群ID”获取，也可让 AI 助手查询“可推送群列表”）。订单查询最多返回 10 票信息；单证获取最多返回 5 份文件（≤50MB）的文件名和下载链接，超出部分会提示登录系统查看。_

五、工具能力、计费与开关管理
--------------

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

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

### 2\. 工具开关与调用限制

1.  **按 Key 独立控制**：关闭某个工具后，该 Key 通过 MCP 调用智能体问答时，也不能再间接调用对应技能；控制台和其他渠道不受影响。
2.  **写入类工具安全机制**：Key 被停用或移出相关能力授权时，已开启的写入类工具会自动关闭；重新启用或授权后，需要手动开启，不会自动恢复。
3.  **频率共用**：MCP 与开放 API 共用同一 Key 的每分钟调用上限，建立连接、列出工具等请求也计入次数。