将立刻智能体通过 MCP（Model Context Protocol，模型上下文协议）接入 Google Gemini 网页版后，员工可以直接借助 Gemini 的规划与执行能力，检索企业知识库、查询 HS 编码与实时汇率，或获取立刻云订单与单证信息。
⚠️ 核心使用说明（必读）
在 Google Gemini 网页版中接入自定义 MCP 工具后，普通的实时对话窗口（Chat）暂不支持直接调用 MCP 工具，必须在 Gemini 的“任务（Tasks）”模式或定时/自动化任务流中才能触发并执行。 如果在常规对话中直接提问，Gemini 会提示无法访问该外部工具。
本文面向企业管理员与使用者，介绍如何配置 Gemini 网页版接入、如何在“任务”中正确调用工具，以及常见问题的排查方法。
一、接入前准备：确认套餐与权限
- 适用套餐：立刻智能体 专业版 Pro、旗舰版 Ultra（基础版暂不支持）。
- 功能入口：控制台 → 外部拓展 → MCP管理。
- 接入方式：Google Gemini 网页版采用 OAuth 授权接入。管理员在后台统一配置底层 Key 与工具开关后，员工使用个人控制台账号登录授权即可，无需在 Gemini 中手动暴露企业 API Key。
二、第一步：企业管理员开启 OAuth 接入
员工在绑定 Gemini 网页版之前，需由企业管理员在立刻智能体控制台完成以下配置：
- 新建并授权专属 Key
- 进入 外部拓展 → API设置，新建一个 Key（建议命名为“Gemini OAuth 接入”），妥善保存。
- 进入 系统设置 → 开放 API 权限，启用 “MCP 接入”，勾选刚创建的 Key 并保存。
- 在同一页面，根据需要为该 Key 勾选对应的底层能力授权：
| 需要使用的工具 | 必须为 Key 开通的能力 |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |
| HS 编码、汇率、舱单、立刻云查单 | 无需额外勾选能力（按套餐与工具开关控制） |
- 开启工具清单
- 进入 外部拓展 → MCP管理 → 对外开放，在“可用 Key”中选中刚才创建的 Key。
- 在下方 “工具清单” 中按需打开要开放给 Gemini 的工具开关（如知识检索、汇率查询等）。
- 注：若为旗舰版需使用“立刻云单号查询”或“立刻云单证获取”，需先在 系统设置 → 单号查询 中配置立刻云服务地址，再回到工具清单中手动开启这两个默认关闭的工具。
- 启用 OAuth 授权开关
- 在“对外开放”页面的 “OAuth 授权接入” 区域，选择该 Key，打开接入开关。
- 所有员工通过 Gemini 网页版发起的调用，均共用此 Key 的工具范围、调用频率与企业计费额度。
- 为员工分配权限
- 进入员工权限管理，为需要使用 Gemini 接入的员工单独勾选 “MCP 个人授权” 权限（该权限依赖“个人设置”，不包含在“全部标准功能”中，需单独勾选）。
- 此外，通过 OAuth 调用部分工具时，还会校验员工本人的业务权限：
| 工具名称 | 员工本人需具备的控制台权限 |
| 新增知识 | 知识库权限（且仅能写入被授权的“知识分类”） |
| 可推送群列表、推送通知 | 合作管理 或 API设置（任一即可） |
| 立刻云单号查询、立刻云单证获取 | 合作管理、企微机器人 或 QQ机器人（任一即可） |
三、第二步：员工在 Gemini 网页版添加并授权
管理员配置完成后，将不带企业代码的通用 OAuth 服务地址提供给员工：
[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)
员工按以下步骤在浏览器中完成绑定：
- 添加自定义 MCP 连接器
- 打开 Google Gemini 网页版，进入设置或扩展/连接器（Extensions / Connectors）管理页面。
- 找到自定义 MCP 接入入口，填入服务地址：
[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)。 - 认证方式选择 OAuth，点击发起连接。
- 登录立刻智能体并同意授权
- 页面将跳转至立刻智能体授权页，员工需填写 企业代码、个人用户名与密码。
- 核对页面展示的企业名称、客户端标识及可用工具清单无误后，点击 “同意授权”。
- 注意事项
- 必须在发起授权的同一个浏览器中完成登录与确认，并确保浏览器允许 Cookie。
- 若提示“授权请求已被处理”或“授权请求无效”，请关闭授权页，回到 Gemini 网页版重新发起连接。
四、第三步：在 Gemini“任务”中调用立刻智能体工具
完成 OAuth 绑定后，请按照 Gemini 网页版的运行规范来使用工具：
1. 为什么在普通对话中提示“未接入”或无法调用？
Google Gemini 网页版对外部自定义 MCP 协议的调用做了场景隔离：常规的即时聊天窗口（Chat）不支持直接挂载和触发自定义 MCP 工具。如果你在普通对话框里直接让它查知识库或查单，它会回复无法直接连接外部系统或找不到对应工具。
2. 正确的使用方式：通过“任务（Tasks）”执行
你需要进入 Gemini 网页版的 任务（Tasks） 模块来创建并运行指令。在任务执行过程中，Gemini 会自动读取已授权的 MCP 工具列表并按需发起调用。
你可以在创建任务时下达如下指令示例：
- 知识库检索任务：“调用立刻智能体工具，从企业知识库检索‘AI 应收录入怎么使用’，并整理操作步骤发给我。”
- 日常汇率与关务核算任务：“查询今日美元兑人民币汇率，换算 1,000 美元；同时查询‘笔记本电脑’的 HS 编码及申报要素。”
- 立刻云订单跟踪任务（旗舰版）：“在立刻云中查询企微群（群ID：xxxx）可见的订单号 XXXX 的最新状态，并获取该订单的提单文件下载链接。”
五、接入後の工具能力与计费说明
在 Gemini 任务中成功触发调用后，各工具的数据范围与计费规则如下：
| 工具名称 | 可以做什么 | 适用套餐 | 计费规则 |
| 知识检索 | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 | 只计向量化 Token |
| 智能体问答 | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 | 按实际消耗扣除套餐 Token |
| 新增知识 | 向企业知识库新增一条问答（默认关闭，需手动开启） | 专业版 / 旗舰版 | 只计向量化 Token |
| HS 编码查询 | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 | 成功出站扣技能点，失败自动冲正 |
| 汇率查询 | 查询汇率并换算金额 | 专业版 / 旗舰版 | 免费 |
| 可推送群列表 | 查询当前可推送通知的群 | 专业版 / 旗舰版 | 免费 |
| 推送通知 | 向指定群发送通知（默认关闭，发出后不可撤回） | 专业版 / 旗舰版 | 占用推送通知额度 |
| 舱单查询 | 按提运单号查询舱单状态 | 仅旗舰版 | 成功出站扣技能点，失败自动冲正 |
| 立刻云单号查询 | 查询指定客户群可见的单票信息（最多返回 10 票） | 仅旗舰版 | 免费（占用立刻云共用查询频率） |
| 立刻云单证获取 | 获取指定订单的单证下载链接（最多 5 份，≤50MB） | 仅旗舰版 | 免费（占用立刻云共用查询频率） |
六、常见问题与排查（FAQ）
- 已成功连接 MCP，但在 Gemini 里提问为什么每次都提示没有接入？
原因：当前处于 Gemini 网页版的普通实时对话（Chat）界面，该界面不支持调用自定义 MCP。
解决：请切换至 Gemini 的 “任务（Tasks）” 功能模块，在任务中配置提示词并运行，即可正常调用。
- 在任务中执行时，提示“找不到某个工具”或权限不足？
检查企业套餐是否支持该工具（如立刻云查单仅限旗舰版）。
检查管理员是否在 MCP管理 → 工具清单 中为 OAuth 绑定的 Key 打开了对应工具开关。
检查该员工账号是否具备本文“第二步”中列出的员工个人业务权限（如知识库权限、机器人权限等）。
- 提示“授权失效或暂停”怎么办？
超过 30 天未使用、管理员撤销授权、员工修改/重置控制台密码、或收回“MCP 个人授权”权限，均会导致原 OAuth 授权失效。
员工可在控制台 系统管理 → 个人设置 → 已授权的 AI 助手 中查看状态，并回到 Gemini 网页版重新发起一次 OAuth 授权连接即可。
- 如何查看 Gemini 任务到底有没有调通工具？
管理员或拥有 MCP 管理权限的人员，可进入控制台 外部拓展 → MCP管理 → 调用记录。
OAuth 调用会在记录中显示 “员工姓名 · 客户端名”，可直观查看每次任务调用的参数摘要、成功/失败原因、耗时与详细消耗。