接入文档
在 WorkBuddy 里连接公益啦
公益啦 V5 通过 MCP 向 AI 平台开放机构业务数据。连接建立后,你可以在 WorkBuddy 里用一句话查项目进展、 活动报名、捐赠与基金流水,也能让 AI 起草活动页面和报名表。数据范围由机构管理员签发令牌时决定, 随时可以吊销;内容只生成草稿,发布仍在后台人工完成。
手动接入 WorkBuddy
登录自己的公益啦机构后台,打开「外部 AI 平台」。页面内有本机构的接入地址、技能包和可直接复制的专家创建说明。以下流程可在 WorkBuddy 客户端直接完成。
连接本机构
请管理员签发 WorkBuddy 连接令牌,绑定使用账号,首次试用可选「只读 · 不含个人信息」。在 WorkBuddy 的「专家·技能·连接器 → 连接器 → 自定义连接器」中命名为
gongyila,选择 Streamable HTTP,粘贴后台提供的完整 HTTPS 地址(含 /mcp)。请求头名称填
Authorization,值填Bearer、一个半角空格和完整令牌,保存并启用。令牌只填在连接设置中。上传公益啦技能
在机构后台下载公益啦技能 ZIP。打开 WorkBuddy「技能 → 添加技能 → 上传技能」,直接选择 ZIP,在「已安装」中确认公益啦机构运营助手(gongyila-skill)已启用。
创建并召唤专家
打开 WorkBuddy「专家 → 我的专家 → 创建专家」,粘贴机构后台提供的专家创建说明,按提示完成创建。在「我的专家」中召唤「公益啦机构运营专家」。
验证连接
请专家用 gongyila 列出当前账号可查看的前 3 个项目,再到机构后台「调用记录」核对结果。查询成功也可能返回空列表;可用工具取决于连接范围、绑定账号权限与机构已开通功能。
能查什么
工具范围在签发时选定,之后可以调整;调整不影响已经签发令牌的有效期。
| 范围 | 工具数 | 包含内容 |
|---|---|---|
| 只读 · 不含个人信息 | 18 | 项目、活动、票种、资讯、学校、官网配置、规则与口径、知识库检索。新连接的默认范围。 |
| 全部只读 | 46 | 包含捐赠、资金、志愿者、助学、审批等含个人信息的只读工具。 |
| 捐赠人服务(只读) | 12 | 面向公众答疑:项目、活动、基金、资讯与规则口径。 |
| 只读分析 | 22 | 统计口径、项目与资金、志愿服务数据。 |
| 内部运营(可起草) | 27 | 查询工具加内容草稿工具;签发时还要单独打开「允许写工具」。 |
内容起草与发布。活动页面、报名表和活动档案都以草稿形式写入,没有任何「发布」工具;上线、生效、对外可见仍由人在后台操作。
常见错误
| 现象 | 原因 | 处理 |
|---|---|---|
| 401 · 令牌无效 | 令牌已过期、已吊销,或绑定账号已停用。 | 请管理员在「外部 AI 平台」重新签发一枚令牌,再更新连接。 |
| 403 · 机构未开通 | 该机构没有开通外部 AI 平台接入,或本部署已停用连接令牌。 | 请管理员确认「外部 AI 平台」功能已开通。 |
| 403 · 域名不被接受 | 填写的机构域名不是该机构登记的域名。 | 自定义连接器请复制机构后台提供的完整 MCP 地址。若使用带有「机构域名」专栏的预设连接表单,该栏只填主机名。 |
| 429 · 调用过于频繁 | 超过该连接的每分钟调用额度。 | 稍等再试;长期不够用请管理员调高额度(每分钟 1–600 次)。 |
| 工具未开放 | 该工具不在本次连接的工具范围内。 | 换用已开放的工具,或请管理员调整工具范围。 |
| 没有功能权限 | 绑定账号本身没有该业务权限,与工具范围无关。 | 请管理员为绑定账号补充对应业务权限。 |
数据与权限边界
令牌只用于 MCP 接口
连接令牌不能登录后台,也不能访问业务管理界面;机构管理员可以随时吊销,吊销后立即失效。
令牌保存在本机
WorkBuddy 使用连接配置中的令牌向本机构的 MCP 服务发起鉴权请求。令牌可被管理员随时吊销,建议按项目或按人签发,便于追溯。
个人信息默认不出圈
含姓名、手机号、逐人记录的工具需要选择「全部只读」一类的范围;返回的手机号一律只保留前 3 位与后 4 位。
每次调用都有记录
后台「外部 AI 平台」页可以查看每个连接的工具范围、调用记录与状态,便于审计与回收。
需要开通或遇到接入问题,请联系机构管理员;也可以直接联系我们:51@Gongyi.LA · 400-996-1599
了解更多产品能力,返回公益啦首页