WorkBuddy 接入 MCP

WorkBuddy 是支持自定义 MCP 连接器的 AI 助手。用企业的 API Key 接入后，员工可以在 WorkBuddy 里直接查询知识库、向智能体提问、查汇率和 HS 编码等。

入口与前提

• 立刻智能体侧入口：控制台 外部拓展 → MCP管理 → 对外开放，在「接入配置」里切换到「WorkBuddy」，可直接复制已带上本企业代码的配置。
• 所需权限：需要 MCP管理（mcp-server）功能权限才能进入 MCP管理 并复制配置，企业管理员始终拥有；员工须由企业管理员在成员与权限中单独授予。
• 所需套餐：专业版 / 旗舰版（基础版不支持）。
• 接入方式：使用 API Key，不走 OAuth 授权。Key 在 外部拓展 → API设置 新建，并由企业管理员在 系统设置 → 开放 API 权限 为该 Key 开通「MCP 接入」，详见MCP管理。
• 在 WorkBuddy 一侧的菜单名称以其当前版本为准。

操作步骤

1. 在 WorkBuddy 中点击「连接器 → 自定义连接器 → 配置 MCP」。
2. 粘贴下方配置，把占位符换成在「API设置」新建的完整 Key。
3. 保存后在自定义连接器中点「信任」并「启用」。

配置示例

下面的 {企业代码} 在 MCP管理 里复制时已自动替换为你的企业代码；<请填入你的 sk-Key> 是占位符，请换成完整 Key（完整 Key 只在新建时显示一次，请勿把真实 Key 发到群里或截图外传）。

{
  "mcpServers": {
    "likelic": {
      "type": "streamableHttp",
      "url": "https://agent.likelic.com/mcp?customer_code={企业代码}",
      "headers": {
        "Authorization": "Bearer <请填入你的 sk-Key>"
      }
    }
  }
}

以上字段（尤其 type 的取值）以 WorkBuddy 当前版本的实际表现为准，如与平台要求不一致，以 MCP管理「接入配置」中复制的内容为准。

接入后自检

1. 在 MCP管理 选中该 Key，点「检查开通状态」，确认可用工具数大于 0。
2. 在 WorkBuddy 里列出工具，并调用一次只读工具（如汇率查询）。
3. 到 MCP管理「调用记录」Tab 确认出现该次调用。

常见问题

提示 401 未授权？ 检查 Key 是否完整、是否已停用或过期；企业代码已包含在地址里，无需另填，Key 只能放在请求头（Authorization）中，不能放在地址里。

连接器没有生效？ 确认连接器已启用；WorkBuddy 需要先在自定义连接器中点「信任」，再点「启用」。

工具列表为空？ 请企业管理员在 系统设置 → 开放 API 权限 为该 Key 开通「MCP 接入」，并在 MCP管理 的「工具清单」里为该 Key 开启工具（写入类和立刻云工具默认关闭）。

能用哪些工具？ 与其它平台一致，见MCP管理的工具表；舱单查询和立刻云单号查询、单证获取仅旗舰版。

更多错误码与重试规则见 MCP 文档。

相关阅读

• MCP管理
• 开放 API
• 成员与权限