知识库
通过 API 或 AI 助手驱动看板
每一个看板操作都在我们的公开API中，并可作为MCP工具使用，因此脚本或AI代理可以读取看板、添加工作并向客户端发送链接。
看板完全可以通过仪表板外部进行全面操作。两条路径、一个权限模型，以及与屏幕完全相同的行为——因为它们调用的是相同的代码。
REST API
每个操作均包含在我们的公共 OpenAPI 规范中，并提供用 TypeScript、Python、PHP 和 Go 生成的客户端，CLI 也是根据同一规范生成的。看板、列、卡片、评论、问题、标签、成员和共享链接均在其涵盖范围内。
您最常使用的端点：
GET /v1/agency/boards— 您的看板GET /v1/agency/boards/{id}— 包含其列和卡片的单个看板POST /v1/agency/boards/{id}/cards— 添加工作POST /v1/agency/boards/{id}/cards/{id}/move— 移动工作POST /v1/agency/boards/{id}/invites— 生成共享链接
共享链接的令牌会在最后一次调用中返回，并且仅在该次调用中返回。我们存储了它的指纹，因此没有任何端点可以将其重新读取——如果您的脚本需要该链接，请从响应中将其保存下来。
MCP 服务器
如果您使用支持 MCP 的 AI 助手，将其连接即可直接获得看板工具：列出看板、完整读取单个看板、创建看板、添加卡片、移动卡片、评论、创建共享链接以及吊销共享链接。这使得“总结本周工作并向 Acme 发送链接”变成了一条指令，而无需跨越两个系统并进行复制粘贴。
关于这些工具有两点值得了解：
- 除非您另有说明，否则新卡片默认内部可见。 总结您内部工作的助手绝不能将该摘要发布给您的客户，因为没有人说过不这样做，因此
visibility默认设置为内部，必须有意将其设置为client。 - 吊销链接需要确认，因为它同时也会移除通过该链接加入的所有人——并且该工具会告知您具体的人数，而不是报告一个干净利落的成功。
所需条件
API 和 MCP 访问权限包含在 Boards Business 以及每一个 Agency 托管计划中。在 Boards Free 和 Boards Pro 上，看板端点将返回一条说明此情况的消息。
API 密钥或 MCP 连接只能在创建它的个人拥有权限的组织内，执行该个人有权执行的操作。助手创建的共享链接同样受到限制：它不能授予授权人员自身不具备的角色。