← 育蜂云

豆包、WorkBuddy 能直接连培训机构管理系统吗?育蜂云 MCP 接入说明

这是育蜂云外部 AI 助手接入的事实说明页:一个 MCP 地址、两种认证方式、按域勾选的授权范围、写操作的人工确认闸门,以及能做什么、不能做什么。本文免费阅读,无需注册。

一句话直接答案

能。育蜂云对外提供统一的 MCP 接入地址 https://eduhive.cn/mcp,豆包(自定义连接器)、WorkBuddy(自定义 MCP)、Claude Code、Cursor 都能连;认证用 API 密钥(请求头 X-API-Key)或浏览器 OAuth 授权,数据范围按勾选的授权范围控制。截至 2026 年 11 月,工具目录共 103 个工具(61 个只读、5 个生成草稿、37 个写操作),写操作中 36 个要由员工本人在系统内确认后才真正落库,另 1 个是「撤销待确认动作」,只减不增、即时生效。

支持的客户端与配置位置

客户端在哪里配认证
豆包自定义连接器:服务器名称、传输类型 HTTP、服务器 URL,再加自定义 Headers密钥,或走 OAuth 登录确认
WorkBuddy自定义 MCP:填一段 JSON,type 为 streamableHttp,url 加上 headers请求头 X-API-Key
Claude Code项目或用户级 mcpServers 配置,type 为 http请求头 X-API-Key
CursorMCP 设置里新增一个 HTTP 类型的服务请求头 X-API-Key

控制台「外部 AI 助手」新建密钥后的弹窗里,四种客户端的配置模板都已填好当前密钥,复制即可;配置模板弹窗里的版本是占位符,用于旧密钥或批量部署时照着改。

三步接上

  1. 建密钥:登录控制台 → 设置 → 多端集成 → 外部 AI 助手 → 新建密钥,名称写清楚是哪台设备在用(例如「WorkBuddy 排课助手」)。
  2. 勾授权范围:通用档有三项——全部只读、全部可读可编辑、调用 AI 能力;也可以按学员、教学、排课、财务、招生运营逐项细勾。只勾真正需要的,范围越大密钥泄露的影响越大。
  3. 粘到客户端:把弹窗里的配置复制到对应客户端,再用命令行自检模板发一次 tools/list,能列出工具就说明通了。

密钥只在创建时显示一次,关掉弹窗后无法再查看,所以先想清楚范围再建。授权范围创建后不可修改,需要调整就新建一张范围不同的密钥。

AI 能做什么:按领域看

领域只读能力举例需要人工确认的写操作
学员档案查学员与家长信息、就读状态、生命周期给家长发消息、发班级通知
课表与排课查课表、排课建议、冲突检查、课次名单创建课次、取消课次、调整课次学员、扣减课时
教学查作业、考试、掌握度分析布置作业、智能组卷
财务查营收、订单、课时账户、支出开单与赠课(金额与课时数在确认页可见,需人工确认)
招生与运营查线索、渠道、续费名单、审批待办发布公告、审批通过或驳回、外部线索写入
知识库与报表检索机构知识库、经营 KPI 快照无
内容草稿营销文案、续费话术、课堂点评、教案、主观题批改建议草稿不落库,确认后才成文

换句话说,AI 是一个能读取本机构数据、能替员工把动作准备好的助手,但它不是第二个管理员:任何会改动数据的操作都停在「AI 待确认动作」里等人点确认。

安全边界:四道闸门

这四条是本系统的既有实现,不是宣传口径:授权范围校验与写操作闸门都有单元测试覆盖,审计日志与工具调用写在同一个事务里。

和开放 API 是什么关系

MCP 接入与开放 API 是同一套身份:同一张密钥、同一份授权范围、同一份审计。MCP 是给「AI 助手」用的通用协议入口,开放 API 是给机构自有系统用的 REST 接口与事件回调;两者都不额外收费,都随套餐提供。

常见问题

豆包、WorkBuddy 能直接连育蜂云吗?

能。育蜂云对外提供一个 MCP 接入地址,豆包用「自定义连接器」、WorkBuddy 用「自定义 MCP」都能连;Claude Code 与 Cursor 用同一份 HTTP 配置也能直连,不需要额外开发。

接入地址是什么?

统一接入地址是 https://eduhive.cn/mcp。传输方式是 MCP 的 Streamable HTTP:豆包自定义连接器里填传输类型 HTTP 与这个服务器 URL;WorkBuddy 填 type 为 streamableHttp 的配置。

为什么豆包要求登录账户,WorkBuddy 不用?

差别在认证方式。WorkBuddy 与 Claude Code、Cursor 的配置里可以直接带请求头 X-API-Key,填了密钥就认身份;豆包自定义连接器没有填自定义 Headers 时,服务端返回 401 并把 OAuth 授权入口告诉客户端,于是流程被带到浏览器里登录机构账号确认。

提示缺少授权范围怎么办?

说明这张密钥的授权范围不包含该能力。密钥的授权范围创建后不能修改,回到控制台「设置 → 多端集成 → 外部 AI 助手」新建一张范围更大的密钥,再把客户端里的密钥换掉即可。

AI 能直接改学员资料、建课次吗?

不能直接改。写操作只会生成一条待确认动作,员工在系统「AI 待确认动作」里看过参数并点确认后才真正落库;外部 AI 拿不到确认权限,它只有密钥或授权令牌。

「全部只读」和「全部可读可编辑」有什么区别?

全部只读放行所有只读工具,不含写操作。全部可读可编辑在只读之上再放行写工具,但写操作照样要人工确认;两档都不包含「调用 AI 能力」,需要 AI 生成文案或教案时要单独勾选。

密钥泄露了怎么办?

在「外部 AI 助手」列表里点停用即可。外部调用数秒内全部失效,按生效顺序回落到数据库记录,不需要重启服务;密钥只在创建时显示一次,页面关闭后无法再查看,只能重建。

外部 AI 能看到别的机构的数据吗?

看不到。每张密钥绑定一个机构,工具查询在机构与校区权限范围内执行,跨机构的请求直接查不到数据;平台侧的连接器包只用于安装应用本身,不携带任何机构数据。

接入要额外付费吗?

不需要。MCP 接入与开放 API 都包含在已购套餐内,不单列接入费用;只有第三方付费接口(例如线上会议 API、AI 生图)按实际用量计费,不用不产生费用。

支持哪些客户端?

官方给配置模板的客户端有四类。分别是豆包自定义连接器、WorkBuddy 自定义 MCP、Claude Code、Cursor;其他支持 MCP Streamable HTTP 且能带自定义请求头的客户端,按同样的地址与 X-API-Key 请求头配置即可。

AI 的每一步操作有记录吗?

有。每次工具调用都会写审计日志,记录调用方、工具名、风险等级与结果;被拒绝的调用也记一条,写明缺少哪个授权范围,便于事后追溯。

不想用了怎么断开?

两个入口都能断:控制台停用该密钥,或在「外部 AI 助手」里解除 OAuth 授权。停用后外部调用立即失效,已产生的待确认动作也会在有效期过后自动作废。

AI 生成的内容会直接发给家长吗?

不会。给家长发消息、发班级通知都属于写操作,AI 只能提出草稿与参数,必须由员工在系统里确认后才发送,发送记录一并留痕。