AgileHero

AgileHero MCP 服务

可由你的 AI Agent 操作的敏捷项目管理工具。 AgileHero 是一款面向敏捷团队的项目工具——在一个工作区中提供看板、史诗和路线图、回顾、估点扑克、白板、Wiki 和交付指标——并通过 49 个工具，使用 Model Context Protocol 向 AI 助手开放所有模块。

此仓库是托管服务的公开连接器套件。这里不包含服务端代码：服务运行于 https://mcp.agilehero.io/mcp，这些文件用于向 MCP 客户端和目录介绍该服务（注册清单、Claude Code 插件、客户端配置），并记录其功能。

• 网站：https://agilehero.io
• 设置指南和支持的客户端：https://agilehero.io/docs/mcp（本仓库中也有：docs/setup.md、docs/tools.md、docs/agilehero-markup.md）
• AgileHero Markup（富文本）规范：https://agilehero.io/docs/mcp/agilehero-markup
• 官方 MCP 注册表条目：io.agilehero/agilehero
• 也已发布至：Smithery · Glama · LobeHub

连接

端点	https://mcp.agilehero.io/mcp
传输方式	Streamable HTTP
身份验证	OAuth 2.1 — 你可在客户端使用 AgileHero 账户登录；无需粘贴 API 密钥。客户端必须支持 Client ID Metadata Documents（Claude Code、Claude.ai、VS Code、Codex、Zed 等；目前尚不支持 Cursor 和 Gemini CLI）。
权限	Agent 以你的身份操作——你的账户能做什么，它就能做什么，不会有更多权限。
计划	支持所有计划，包括 Free。Wiki、白板、回顾和路线图工具需要 Pro 工作区或处于 14 天试用期的工作区。
每日限额	工具调用按每位用户、每个工作区计量：Free 每天 500 次，Pro 或试用期每天 5,000 次，每天 00:00 UTC 重置。

Claude Code

claude mcp add --transport http agilehero https://mcp.agilehero.io/mcp

然后在 Claude Code 中运行 /mcp，并按照登录链接完成操作。

Claude Code 插件 — 此仓库也是一个包含一个插件的插件市场；安装后即可使用该服务。

claude plugin marketplace add agilehero-io/agilehero-mcp
claude plugin install agilehero@agilehero

其他 MCP 客户端 — 将客户端指向上面的端点；客户端会自行发现授权服务（RFC 9728 受保护资源元数据）并打开登录页面。VS Code、Codex、Zed 等客户端的具体步骤请参阅：https://agilehero.io/docs/mcp。

通用配置（.mcp.json）：

{ "mcpServers": { "agilehero": { "type": "http", "url": "https://mcp.agilehero.io/mcp" } } }

Agent 可以做什么

你可以让它整理待办事项、将规格拆分为一个史诗和多张卡片、估点、在看板上移动工作项、撰写回顾、将白板头脑风暴内容转换为卡片，或起草 Wiki 页面——所有操作都在你自己的工作区中进行，遵循你的权限，每项更改都会实时显示给团队。

服务会在 initialize 时向每个客户端说明以下约定：每个 ID 都是由列表、获取或搜索工具返回的短 uid（不得自行编造）；大多数工具都需要项目 uid（先调用 list_projects）；富文本采用 AgileHero Markup (AHM)，这是一种严格的 XML 方言——开始编写前先调用一次 get_ahm_spec；描述和 Wiki 编辑按设计分为两步（先预览，再使用返回的令牌应用）。

工具（49）

发现与搜索

工具	功能
list_projects	列出令牌所属用户可以访问的所有工作区和项目，以便 Agent 查询项目 uid……
search	产品的全局全文搜索（OpenSearch）：卡片、史诗、Wiki 页面和项目，匹配标题……
search_cards	在单个项目内按标题子字符串搜索卡片（看板和待办列表），匹配产品的项目内……
list_project_users	列出项目成员，以便 Agent 查询受派人 uid
list_board_lists	列出项目看板中的列表，以便 Agent 查询有效的 move_card 目标。
list_labels	列出项目标签，以便 Agent 重用现有分类体系，而不是创建近似重复项……

卡片与史诗

工具	功能
list_cards	列出某个看板列表中的卡片；如果省略 list_id 或将其留空，则列出项目待办列表中的卡片，位于看板……
get_card	根据 ID 获取卡片的详细信息
create_card	在项目看板上创建新卡片，可组合使用任意受支持字段
update_card	根据 uid 更新现有卡片。
move_card	将卡片移至其他列表（或更改其在同一列表中的位置）。
delete_card	软删除 uid 对应的卡片
list_epics	列出项目史诗，以便 Agent 查询 get_epic 和卡片分配所需的史诗 uid。
get_epic	根据 ID 获取史诗的详细信息
create_epic	在项目上创建新史诗，可组合使用任意受支持字段
update_epic	根据 uid 更新现有史诗；仅更改提供的字段。
delete_epic	软删除 uid 对应的史诗。
create_label	根据名称在项目上创建新标签。
create_comment	为卡片或史诗添加评论。
delete_comment	删除你发布的评论（评论归属于此客户端代表其操作的已登录用户；其他……

富文本（AgileHero Markup）

工具	功能
get_ahm_spec	AgileHero Markup（AHM）v1.0 规范——AgileHero 唯一接受的富文本格式（Markdown 和……
preview_description_update	每次编辑卡片或史诗描述时都必须先执行此步骤：验证块操作并返回……
update_description	将先前预览过的描述更新应用到卡片或史诗。

Wiki

工具	功能
list_wiki_paths	列出项目的所有 Wiki 路径（页面和文件夹）
show_wiki_page	以 AgileHero Markup（AHM）格式获取 Wiki 页面及其 document_version。
create_wiki_page	使用 AgileHero Markup（AHM）内容创建 Wiki 页面（可选放入文件夹中）。
preview_wiki_page_update	每次更新 Wiki 页面时都必须先执行此步骤：验证操作并返回服务器计算出的……
update_wiki_page	将先前预览过的更新应用到 Wiki 页面。

白板

工具	功能
list_whiteboards	列出项目的白板（uid、名称、元素数量、url）。
create_whiteboard	在项目中创建空白白板。
get_whiteboard	以精简文本表示读取白板：白板边界，以及每个元素占一行——" at…
create_whiteboard_elements	在一次事务调用中创建最多 100 个白板元素（要么全部成功，要么全部失败；只触发一个实时事件）。
create_whiteboard_diagram	根据语义图在白板上绘制图表（流程图、流程、依赖关系图）——节点、边……
update_whiteboard_elements	在一次全部成功或全部失败的调用中更新最多 100 个白板元素：移动（x/y）、调整大小、重新排序（z_index）……
delete_whiteboard_elements	在一次事务调用中删除最多 100 个白板元素。
review_whiteboard	对白板运行确定性质量检查：文本可能超出其元素范围、存在明显重叠……
convert_whiteboard_element	将白板元素转换为待办事项：将便签转换为卡片或史诗，或将框架转换为……
convert_mind_map	将思维导图转换为待办事项，并逐节点映射：根节点可转换为新的史诗（角色为 "epic"）……

回顾会议

工具	功能
list_retrospectives	列出项目的回顾会议，按时间从近到远排序（uid、名称、日期、url）。
create_retrospective	创建回顾会议。
get_retrospective	读取回顾会议：其列（含 uid——句柄 add_retro_items 和 move_retro_item 会用到）……
add_retro_items	向回顾会议白板添加多个条目。
move_retro_item	将回顾条目移动到其回顾白板的另一列。

路线图

工具	功能
list_roadmap_slots	列出与日期范围重叠的项目路线图时段（默认范围：本月至五个月后）。
create_roadmap_slot	在项目路线图上安排一个史诗：创建从 start_date 到 end_date 的时段，可选指定负责人。
update_roadmap_slot	更新路线图时段：重新安排时间或调整时长（start_date/end_date），将其移至同一……中的另一个史诗
delete_roadmap_slot	永久删除路线图时段（及其负责人关联）。

指标与关注事项

工具	功能
list_attention_cards	列出项目看板上需要关注的卡片——与产品「指标」页面中的列表相同。
get_metrics_summary	一次调用即可统计项目看板上需要关注的卡片数量：overdue_cards_count，……

此存储库中的文件

文件	用途
docs/setup.md	各客户端的连接说明，由程序生成
docs/tools.md	全部 49 个工具及其参数和调用示例，由程序生成
docs/agilehero-markup.md	AHM 富文本规范，由程序生成
data/mcp-docs.json	三份生成文档的来源（后端中的 bin/rails mcp:docs）
scripts/generate-docs.mjs	根据该 JSON 重新生成 docs/
context7.json	文档索引的解析和 Agent 规则配置
server.json	发布到 Official MCP Registry 的清单
.mcp.json	托管服务的客户端配置
.claude-plugin/plugin.json	Claude Code 插件清单（使用 claude plugin validate 验证）
.claude-plugin/marketplace.json	Marketplace 清单，使插件可直接从此存储库安装
assets/agilehero-icon-512.png	目录图标

定价

永久免费提供 2 个席位。Pro 版每月 12 美元，额外席位每个每月 9 美元；所有高级模块均可免费试用 14 天，无需信用卡。详情：https://agilehero.io/pricing。

支持

https://agilehero.io/contact/ · [email protected]

许可证

此仓库中的文件根据 MIT 许可证 发布。AgileHero 本身是一项托管的专有服务；其条款适用于你登录时使用的账户。