在千问办公中处理日常文档、办公协同与业务咨询时，如果需要检索企业内部知识库、查询实时汇率与 HS 编码，或者获取立刻云订单及单证信息，可以直接通过立刻智能体的 MCP（Model Context Protocol，模型上下文协议）将企业能力接入千问办公。
千问办公支持通过 企业 API Key 方式接入 MCP。管理员在后台创建专属 Key、开启对应工具并复制配置后，即可在千问办公中统一调用授权范围内的企业能力，无需单独开发接口。
本文面向控制台管理员与使用者，介绍如何配置 API Key、如何接入千问办公，以及调用失败时的排查方法。
一、接入前准备：确认套餐、入口与权限
- 适用套餐：立刻智能体 专业版 Pro、旗舰版 Ultra（基础版暂不支持）。
- 功能入口：控制台 → 外部拓展 → MCP管理。
- 管理权限说明：
- 企业管理员始终拥有全部 MCP 管理权限。
- 员工如需管理接入，须单独获得 “MCP管理” 权限（该权限依赖“API设置”，且不包含在“全部标准功能”授权模式中，需要管理员单独勾选）。
- 为 Key 开通“MCP 接入”的开放 API 权限，仍只有企业管理员可以修改。
- 注：使用 API Key 接入时，实际可用工具取决于企业套餐、Key 的能力授权与工具开关，不受员工个人业务权限限制。
二、第一步：在立刻智能体控制台配置 API Key
1. 新建并保存专属 Key
- 进入 外部拓展 → API设置，新建一个 Key，建议命名为 “千问办公接入”。
- 注意：完整 Key 只在新建时显示一次，请及时复制保存；后续页面只能查看前缀。建议为不同平台分别创建独立的 Key，方便独立管理工具开关与调用频率。
2. 开通 MCP 和对应底层能力
- 由企业管理员进入 系统设置 → 开放 API 权限，启用 “MCP 接入”，勾选刚创建的“千问办公接入” Key 并保存。
- 根据业务需要，在同一页面为该 Key 开通对应的底层能力：
| 需要使用的工具 | 需要开通的能力 |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |
| HS 编码、汇率查询、舱单查询、立刻云查单 | 无需额外勾选能力（按套餐与工具开关控制） |
3. 选择需要开放的工具
- 进入 外部拓展 → MCP管理 → 对外开放，在“可用 Key”中选中该 Key，再到下方 “工具清单” 按需开启工具：
- 通常只读工具默认开启。
- “新增知识”（会写入企业知识库）和 “推送通知”（会对外发送且发出后不能撤回）默认关闭，开启时页面会二次确认，请按实际用途开放。
- “立刻云单号查询” 与 “立刻云单证获取”（仅旗舰版）默认均为关闭。使用前需先在 系统设置 → 单号查询 中配置立刻云服务地址，再回到工具清单手动开启。
- 如果开关置灰，可以查看提示原因，确认是否存在套餐不支持、Key 缺少能力授权或工具暂不可用等情况。
三、第二步：复制配置并接入千问办公
1. 复制平台配置
- 在 外部拓展 → MCP管理 → 对外开放 的 “接入配置” 区域中，选择 千问办公。
- 点击 “复制配置”，控制台会自动带入本企业代码（
customer_code），生成的 Key 接入服务地址形如：[https://agent.likelic.com/mcp?customer_code=你的企业代码](https://agent.likelic.com/mcp?customer_code=你的企业代码)
2. 填写到千问办公
- 按页面说明将配置填写到千问办公的 MCP 工具配置处，并将 Key 占位符替换为你保存的 完整 Key。
- 安全提示：Key 应按配置放入请求头（Headers），不要直接拼接到 URL 中。
3. 检查开通状态并试用
- 在控制台选中该 Key，点击 “检查开通状态”，确认 Key、套餐与 MCP 接入状态正常（“检查开通状态”本身不计费、不占调用次数，也不会产生调用记录）。
- 回到千问办公发起一次工具调用，随后到控制台 “调用记录” 中检查结果。
四、第三步：在千问办公中调用工具示例
接入并开启对应工具后，可以在千问办公中直接向 AI 助手提出以下请求：
- 查企业知识库与新增问答
- “从企业知识库查一下，AI 应收录入怎么使用？”
- “帮我把刚才整理的报销说明，新增一条问答到企业知识库。”
- 查询 HS 编码与汇率换算
- “帮我查询‘笔记本电脑’的 HS 编码。”
- “查询美元兑人民币汇率，并换算 1,000 美元。”
- 查询立刻云订单与单证（旗舰版）
- “查询指定客户群（企微群ID：xxxx）对应的这票订单，并获取提单文件。”
- 使用说明：查询需提供订单号、群渠道（企微或 QQ）与群标识（可在目标群发送“群ID”获取，也可让 AI 助手查询“可推送群列表”）。订单查询最多返回 10 票信息；单证获取最多返回 5 份文件（≤50MB）的文件名和下载链接，超出部分会提示登录系统查看。
五、工具能力、计费与开关管理
1. 工具能力与计费一览
| 工具名称 | 可以做什么 | 适用套餐 | 计费规则 |
| 知识检索 | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 | 只计向量化 Token |
| 智能体问答 | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 | 按实际消耗扣除套餐 Token |
| 新增知识 | 向企业知识库新增一条问答 | 专业版 / 旗舰版 | 只计向量化 Token |
| HS 编码查询 | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| 汇率查询 | 查询汇率并换算金额 | 专业版 / 旗舰版 | 免费 |
| 可推送群列表 | 查询当前可推送通知的群 | 专业版 / 旗舰版 | 免费 |
| 推送通知 | 向指定群发送通知 | 专业版 / 旗舰版 | 占用推送通知额度 |
| 舱单查询 | 按提运单号查询舱单状态 | 仅旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| 立刻云单号查询 | 查询指定客户群可见的单票信息 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
| 立刻云单证获取 | 获取指定订单的单证文件下载链接 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
2. 工具开关与调用限制
- 按 Key 独立控制：关闭某个工具后，该 Key 通过 MCP 调用智能体问答时，也不能再间接调用对应技能；控制台和其他渠道不受影响。
- 写入类工具安全机制：Key 被停用或移出相关能力授权时，已开启的写入类工具会自动关闭；重新启用或授权后，需要手动开启，不会自动恢复。
- 频率共用：MCP 与开放 API 共用同一 Key 的每分钟调用上限，建立连接、列出工具等请求也计入次数。