接入文档

在 WorkBuddy 里连接公益啦

公益啦 V5 通过 MCP 向 AI 平台开放机构业务数据。连接建立后,你可以在 WorkBuddy 里用一句话查项目进展、 活动报名、捐赠与基金流水,也能让 AI 起草活动页面和报名表。数据范围由机构管理员签发令牌时决定, 随时可以吊销;内容只生成草稿,发布仍在后台人工完成。

手动接入 WorkBuddy

登录自己的公益啦机构后台,打开「外部 AI 平台」。页面内有本机构的接入地址、技能包和可直接复制的专家创建说明。以下流程可在 WorkBuddy 客户端直接完成。

  1. 连接本机构

    请管理员签发 WorkBuddy 连接令牌,绑定使用账号,首次试用可选「只读 · 不含个人信息」。在 WorkBuddy 的「专家·技能·连接器 → 连接器 → 自定义连接器」中命名为 gongyila,选择 Streamable HTTP,粘贴后台提供的完整 HTTPS 地址(含 /mcp)。

    请求头名称填 Authorization,值填 Bearer、一个半角空格和完整令牌,保存并启用。令牌只填在连接设置中。

  2. 上传公益啦技能

    在机构后台下载公益啦技能 ZIP。打开 WorkBuddy「技能 → 添加技能 → 上传技能」,直接选择 ZIP,在「已安装」中确认公益啦机构运营助手(gongyila-skill)已启用。

  3. 创建并召唤专家

    打开 WorkBuddy「专家 → 我的专家 → 创建专家」,粘贴机构后台提供的专家创建说明,按提示完成创建。在「我的专家」中召唤「公益啦机构运营专家」。

  4. 验证连接

    请专家用 gongyila 列出当前账号可查看的前 3 个项目,再到机构后台「调用记录」核对结果。查询成功也可能返回空列表;可用工具取决于连接范围、绑定账号权限与机构已开通功能。

能查什么

工具范围在签发时选定,之后可以调整;调整不影响已经签发令牌的有效期。

范围工具数包含内容
只读 · 不含个人信息18项目、活动、票种、资讯、学校、官网配置、规则与口径、知识库检索。新连接的默认范围。
全部只读46包含捐赠、资金、志愿者、助学、审批等含个人信息的只读工具。
捐赠人服务(只读)12面向公众答疑:项目、活动、基金、资讯与规则口径。
只读分析22统计口径、项目与资金、志愿服务数据。
内部运营(可起草)27查询工具加内容草稿工具;签发时还要单独打开「允许写工具」。

内容起草与发布。活动页面、报名表和活动档案都以草稿形式写入,没有任何「发布」工具;上线、生效、对外可见仍由人在后台操作。

常见错误

现象原因处理
401 · 令牌无效令牌已过期、已吊销,或绑定账号已停用。请管理员在「外部 AI 平台」重新签发一枚令牌,再更新连接。
403 · 机构未开通该机构没有开通外部 AI 平台接入,或本部署已停用连接令牌。请管理员确认「外部 AI 平台」功能已开通。
403 · 域名不被接受填写的机构域名不是该机构登记的域名。自定义连接器请复制机构后台提供的完整 MCP 地址。若使用带有「机构域名」专栏的预设连接表单,该栏只填主机名。
429 · 调用过于频繁超过该连接的每分钟调用额度。稍等再试;长期不够用请管理员调高额度(每分钟 1–600 次)。
工具未开放该工具不在本次连接的工具范围内。换用已开放的工具,或请管理员调整工具范围。
没有功能权限绑定账号本身没有该业务权限,与工具范围无关。请管理员为绑定账号补充对应业务权限。

数据与权限边界

  1. 令牌只用于 MCP 接口

    连接令牌不能登录后台,也不能访问业务管理界面;机构管理员可以随时吊销,吊销后立即失效。

  2. 令牌保存在本机

    WorkBuddy 使用连接配置中的令牌向本机构的 MCP 服务发起鉴权请求。令牌可被管理员随时吊销,建议按项目或按人签发,便于追溯。

  3. 个人信息默认不出圈

    含姓名、手机号、逐人记录的工具需要选择「全部只读」一类的范围;返回的手机号一律只保留前 3 位与后 4 位。

  4. 每次调用都有记录

    后台「外部 AI 平台」页可以查看每个连接的工具范围、调用记录与状态,便于审计与回收。

需要开通或遇到接入问题,请联系机构管理员;也可以直接联系我们:51@Gongyi.LA · 400-996-1599

了解更多产品能力,返回公益啦首页

文档随产品版本更新;工具清单以连接器实际返回为准。