一句话直接答案
能。育蜂云对外提供统一的 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 |
| Cursor | MCP 设置里新增一个 HTTP 类型的服务 | 请求头 X-API-Key |
控制台「外部 AI 助手」新建密钥后的弹窗里,四种客户端的配置模板都已填好当前密钥,复制即可;配置模板弹窗里的版本是占位符,用于旧密钥或批量部署时照着改。
三步接上
- 建密钥:登录控制台 → 设置 → 多端集成 → 外部 AI 助手 → 新建密钥,名称写清楚是哪台设备在用(例如「WorkBuddy 排课助手」)。
- 勾授权范围:通用档有三项——全部只读、全部可读可编辑、调用 AI 能力;也可以按学员、教学、排课、财务、招生运营逐项细勾。只勾真正需要的,范围越大密钥泄露的影响越大。
- 粘到客户端:把弹窗里的配置复制到对应客户端,再用命令行自检模板发一次 tools/list,能列出工具就说明通了。
密钥只在创建时显示一次,关掉弹窗后无法再查看,所以先想清楚范围再建。授权范围创建后不可修改,需要调整就新建一张范围不同的密钥。
AI 能做什么:按领域看
| 领域 | 只读能力举例 | 需要人工确认的写操作 |
|---|---|---|
| 学员档案 | 查学员与家长信息、就读状态、生命周期 | 给家长发消息、发班级通知 |
| 课表与排课 | 查课表、排课建议、冲突检查、课次名单 | 创建课次、取消课次、调整课次学员、扣减课时 |
| 教学 | 查作业、考试、掌握度分析 | 布置作业、智能组卷 |
| 财务 | 查营收、订单、课时账户、支出 | 开单与赠课(金额与课时数在确认页可见,需人工确认) |
| 招生与运营 | 查线索、渠道、续费名单、审批待办 | 发布公告、审批通过或驳回、外部线索写入 |
| 知识库与报表 | 检索机构知识库、经营 KPI 快照 | 无 |
| 内容草稿 | 营销文案、续费话术、课堂点评、教案、主观题批改建议 | 草稿不落库,确认后才成文 |
换句话说,AI 是一个能读取本机构数据、能替员工把动作准备好的助手,但它不是第二个管理员:任何会改动数据的操作都停在「AI 待确认动作」里等人点确认。
安全边界:四道闸门
- 授权范围:密钥和 OAuth 授权都按范围放行,工具不在范围内直接拒绝,并给出缺少哪一项范围。
- 人工确认:36 个写工具一律先生成待确认动作,确认时用确认人本人的权限执行,外部 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 只能提出草稿与参数,必须由员工在系统里确认后才发送,发送记录一并留痕。