fenbs-mcp 用于把任意 MCP 客户端连接到 fenbs 看板（https://fenbs.ai）。fenbs 是一个简单的项目管理工具，人和 AI 助手都是看板成员，各自持有角色，且每次变更都会由操作者签名。看板设有四个泳道，三种任务类型（Feature、Enhancement、Bug），角色使用通俗词语描述，并提供会指明 AI 助手名称的审计追踪。它还支持带签核的决策、在每个任务上记录测试，以及由人预先批准、供 AI 助手空闲时领取的任务。
大多数情况下你可能不需要这个包。fenbs 通过 HTTP 以 MCP 通信，并支持浏览器登录。多数客户端可直接连接，无需复制令牌。分步说明见 https://fenbs.ai/integrations。只有客户端仅支持 stdio，或机器无法打开浏览器（CI、服务器、容器）时，才使用 fenbs-mcp。它通过手动签发的令牌，将 stdin/stdout 桥接到远程服务器。
令牌的获取方式：在 fenbs 中进入“Settings → Connect an AI assistant”，为助手命名，勾选 read / write / comment，复制令牌。令牌只显示一次。也可用于需要命令的客户端配置。
助手可执行的操作包括以下几类。任务：fenbs_whoami、fenbs_list_boards、fenbs_list_items、fenbs_get_item、fenbs_create_item、fenbs_update_item、fenbs_flag_item、fenbs_comment、fenbs_search、fenbs_delete_item、fenbs_restore_item。AI 预批准：fenbs_next_approved_task、fenbs_release_task。决策与规则：fenbs_list_decisions、fenbs_get_decision、fenbs_add_decision、fenbs_update_decision、fenbs_request_signoff、fenbs_delete_decision、fenbs_restore_decision。AI 上下文：fenbs_get_context、fenbs_add_context_note、fenbs_list_context_notes、fenbs_update_context_note、fenbs_delete_context_note。项目：fenbs_list_projects、fenbs_add_project、fenbs_rename_project、fenbs_delete_project、fenbs_restore_project。工具列表来自 fenbs 本身，因此新增工具无需更新此包。
关于规则：规则就是决策。一条规则是一条从此刻起持续生效的决策（standingRule: true）。当有人说明某件事必须始终如何做、或绝不能如何做时，助手应用 fenbs_add_decision 记录（状态为 decided，以该人为决策者，并引用其原话），绝不能记录为上下文笔记。fenbs_get_context 会优先并完整显示规则，助手必须遵循每一条规则。上下文笔记仅用于记录无人选择的事实：代码如何工作、某个陷阱、某物位于何处。
该工具以签发令牌者的身份行事，并持有其看板角色，权限受勾选的 scopes 限制。拒绝会以一句话呈现，助手可向你复述，例如："You are a Viewer on Kitchen Refit, which cannot move tasks between lanes."。在 Settings 中撤销令牌后，它会立即停止。
完整指南面向人和助手编写：https://fenbs.ai/llms.txt。无依赖，需要 Node 20 或更新版本，MIT 许可。
