# 立刻智能体 MCP 接入 Google Gemini 网页版教程：在任务（Tasks）中调用企业知识库与业务工具

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

将立刻智能体通过 MCP（Model Context Protocol，模型上下文协议）接入 Google Gemini 网页版后，员工可以直接借助 Gemini 的规划与执行能力，检索企业知识库、查询 HS 编码与实时汇率，或获取立刻云订单与单证信息。

> **⚠️ 核心使用说明（必读）**

> 在 Google Gemini 网页版中接入自定义 MCP 工具后，**普通的实时对话窗口（Chat）暂不支持直接调用 MCP 工具，必须在 Gemini 的“任务（Tasks）”模式或定时/自动化任务流中才能触发并执行。** 如果在常规对话中直接提问，Gemini 会提示无法访问该外部工具。

本文面向企业管理员与使用者，介绍如何配置 Gemini 网页版接入、如何在“任务”中正确调用工具，以及常见问题的排查方法。

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

1.  **适用套餐**：立刻智能体 **专业版 Pro**、**旗舰版 Ultra**（基础版暂不支持）。
2.  **功能入口**：控制台 → 外部拓展 → MCP管理。
3.  **接入方式**：Google Gemini 网页版采用 **OAuth 授权接入**。管理员在后台统一配置底层 Key 与工具开关后，员工使用个人控制台账号登录授权即可，无需在 Gemini 中手动暴露企业 API Key。

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

员工在绑定 Gemini 网页版之前，需由企业管理员在立刻智能体控制台完成以下配置：

1.  **新建并授权专属 Key**
2.  进入 **外部拓展 → API设置**，新建一个 Key（建议命名为“Gemini OAuth 接入”），妥善保存。
3.  进入 **系统设置 → 开放 API 权限**，启用 **“MCP 接入”**，勾选刚创建的 Key 并保存。
4.  在同一页面，根据需要为该 Key 勾选对应的底层能力授权：

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

1.  **开启工具清单**
2.  进入 **外部拓展 → MCP管理 → 对外开放**，在“可用 Key”中选中刚才创建的 Key。
3.  在下方 **“工具清单”** 中按需打开要开放给 Gemini 的工具开关（如知识检索、汇率查询等）。
4.  _注：若为旗舰版需使用“立刻云单号查询”或“立刻云单证获取”，需先在_ **_系统设置 → 单号查询_** _中配置立刻云服务地址，再回到工具清单中手动开启这两个默认关闭的工具。_
5.  **启用 OAuth 授权开关**
6.  在“对外开放”页面的 **“OAuth 授权接入”** 区域，选择该 Key，打开接入开关。
7.  所有员工通过 Gemini 网页版发起的调用，均共用此 Key 的工具范围、调用频率与企业计费额度。
8.  **为员工分配权限**
9.  进入员工权限管理，为需要使用 Gemini 接入的员工单独勾选 **“MCP 个人授权”** 权限（该权限依赖“个人设置”，不包含在“全部标准功能”中，需单独勾选）。
10.  此外，通过 OAuth 调用部分工具时，还会校验员工本人的业务权限：

| **工具名称** | **员工本人需具备的控制台权限** |
| --- | --- |
| 新增知识 | 知识库权限（且仅能写入被授权的“知识分类”） |
| 可推送群列表、推送通知 | 合作管理 或 API设置（任一即可） |
| 立刻云单号查询、立刻云单证获取 | 合作管理、企微机器人 或 QQ机器人（任一即可） |

三、第二步：员工在 Gemini 网页版添加并授权
-------------------------

管理员配置完成后，将不带企业代码的通用 OAuth 服务地址提供给员工：

`[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)`

员工按以下步骤在浏览器中完成绑定：

1.  **添加自定义 MCP 连接器**
2.  打开 Google Gemini 网页版，进入设置或扩展/连接器（Extensions / Connectors）管理页面。
3.  找到自定义 MCP 接入入口，填入服务地址：`[https://agent.likelic.com/mcp](https://agent.likelic.com/mcp)`。
4.  认证方式选择 **OAuth**，点击发起连接。
5.  **登录立刻智能体并同意授权**
6.  页面将跳转至立刻智能体授权页，员工需填写 **企业代码、个人用户名与密码**。
7.  核对页面展示的企业名称、客户端标识及可用工具清单无误后，点击 **“同意授权”**。
8.  **注意事项**
9.  **必须在发起授权的同一个浏览器中完成登录与确认**，并确保浏览器允许 Cookie。
10.  若提示“授权请求已被处理”或“授权请求无效”，请关闭授权页，回到 Gemini 网页版重新发起连接。

四、第三步：在 Gemini“任务”中调用立刻智能体工具
----------------------------

完成 OAuth 绑定后，请按照 Gemini 网页版的运行规范来使用工具：

### 1\. 为什么在普通对话中提示“未接入”或无法调用？

Google Gemini 网页版对外部自定义 MCP 协议的调用做了场景隔离：**常规的即时聊天窗口（Chat）不支持直接挂载和触发自定义 MCP 工具**。如果你在普通对话框里直接让它查知识库或查单，它会回复无法直接连接外部系统或找不到对应工具。

### 2\. 正确的使用方式：通过“任务（Tasks）”执行

你需要进入 Gemini 网页版的 **任务（Tasks）** 模块来创建并运行指令。在任务执行过程中，Gemini 会自动读取已授权的 MCP 工具列表并按需发起调用。

你可以在创建任务时下达如下指令示例：

1.  **知识库检索任务**：“调用立刻智能体工具，从企业知识库检索‘AI 应收录入怎么使用’，并整理操作步骤发给我。”
2.  **日常汇率与关务核算任务**：“查询今日美元兑人民币汇率，换算 1,000 美元；同时查询‘笔记本电脑’的 HS 编码及申报要素。”
3.  **立刻云订单跟踪任务（旗舰版）**：“在立刻云中查询企微群（群ID：xxxx）可见的订单号 XXXX 的最新状态，并获取该订单的提单文件下载链接。”

五、接入後の工具能力与计费说明
---------------

在 Gemini 任务中成功触发调用后，各工具的数据范围与计费规则如下：

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

六、常见问题与排查（FAQ）
--------------

1.  **已成功连接 MCP，但在 Gemini 里提问为什么每次都提示没有接入？**

**原因**：当前处于 Gemini 网页版的普通实时对话（Chat）界面，该界面不支持调用自定义 MCP。

**解决**：请切换至 Gemini 的 **“任务（Tasks）”** 功能模块，在任务中配置提示词并运行，即可正常调用。

1.  **在任务中执行时，提示“找不到某个工具”或权限不足？**

检查企业套餐是否支持该工具（如立刻云查单仅限旗舰版）。

检查管理员是否在 **MCP管理 → 工具清单** 中为 OAuth 绑定的 Key 打开了对应工具开关。

检查该员工账号是否具备本文“第二步”中列出的员工个人业务权限（如知识库权限、机器人权限等）。

1.  **提示“授权失效或暂停”怎么办？**

超过 30 天未使用、管理员撤销授权、员工修改/重置控制台密码、或收回“MCP 个人授权”权限，均会导致原 OAuth 授权失效。

员工可在控制台 **系统管理 → 个人设置 → 已授权的 AI 助手** 中查看状态，并回到 Gemini 网页版重新发起一次 OAuth 授权连接即可。

1.  **如何查看 Gemini 任务到底有没有调通工具？**

管理员或拥有 MCP 管理权限的人员，可进入控制台 **外部拓展 → MCP管理 → 调用记录**。

OAuth 调用会在记录中显示 **“员工姓名 · 客户端名”**，可直观查看每次任务调用的参数摘要、成功/失败原因、耗时与详细消耗。