MCP 工具参考
AB Projects 提供 MCP 工具，让 AI 助手（例如 Claude）处理您的项目、任务和文档。当助手通过这些工具更改某些内容时，它会走与应用相同的路径：一条带有您提供的备注的变更历史记录、一条审计日志条目，以及一张发布到已链接 Microsoft Teams 频道的 Adaptive Cards（自适应卡片）— 并清晰披露 AI 活动。只读工具仅返回数据，不会更改任何内容。
项目工具
| 工具 | 说明 | 参数 |
|---|---|---|
ab_get_my_projects |
列出您所属的所有项目，包括任务数量和完成率等统计信息。 | 无 |
ab_get_project_members |
列出项目的所有成员及其角色和成员关系 ID。使用此工具获取分配任务所需的成员关系 ID。 | project_id 必填 |
ab_get_project_options |
获取项目的有效状态、类型和环境 ID。在向 ab_create_task 或 ab_update_task 传递状态、类型或环境之前先调用此工具。 |
project_id 必填 |
任务工具
| 工具 | 说明 | 参数 |
|---|---|---|
ab_get_my_tasks |
获取您的活动任务 — 已逾期、今天到期和进行中。返回任务 ID、标题、优先级、状态、截止日期和进度。 | project_id 可选 — 筛选到特定项目 |
ab_search_tasks |
在您的所有项目中按关键字搜索任务。 | query 必填 — 搜索关键字 project_id 可选 — 限定到特定项目 |
ab_get_task |
获取任务的完整详情 — 描述、日期、负责人、估计/实际工时、子任务信息、父任务 ID、GitHub 分支，以及最近 50 条内联评论。状态、类型和环境以人类可读的名称返回。 | project_id 必填 task_id 必填 |
ab_create_task |
创建一个新任务。会记录一条变更日志条目，并向已链接的 Teams 频道发布通知。 | project_id 必填 title 必填 description 可选 — 支持 Markdown priority 可选 — 1 = 高，2 = 中，3 = 低（默认：2） assignee_id 可选 — 负责人的成员关系 ID due_date 可选 — yyyy-MM-dd status / type / environment 可选 — 来自 ab_get_project_options 的 IDparent_task_id 可选 — 父任务的行键；设置后，此任务将成为子任务，父任务的「有子任务」标志会自动更新 note 可选 — 原因，显示在变更日志和 Teams 频道中 |
ab_update_task |
更新任务的属性 — 标题、描述、状态、进度、优先级、负责人、类型、环境或父任务。每次变更都会带着提供的备注记录到历史记录中。 | project_id 必填 task_id 必填 title / description 可选（Markdown） status 可选 — 新状态 ID progress 可选 — 0 到 100 priority 可选 — 1/2/3 assignee_id / type / environment 可选 parent_task_id 可选 — 移动到不同的父任务下；空字符串表示分离 note 可选 — 原因，显示在变更日志和 Teams 频道中 |
ab_complete_task |
将任务标记为完成。将进度设置为 100% 并在变更历史中记录一条完成条目。 | project_id 必填 task_id 必填 note 可选 — 完成备注，显示在变更日志和 Teams 频道中 |
ab_add_comment |
向任务添加评论。评论会出现在任务的线程中，并由 ab_get_task 内联返回，因此后续调用无需第二次工具调用即可读取它。 |
project_id 必填 task_id 必填 content 必填 — 评论文本 |
日程工具
| 工具 | 说明 | 参数 |
|---|---|---|
ab_get_schedule |
获取您本周的日程 — 分组为已逾期、今天到期和本周到期。 | project_id 可选 — 筛选到特定项目 |
文档（Wiki）工具
| 工具 | 说明 | 参数 |
|---|---|---|
ab_get_wiki_tree |
获取项目的文档导航树（文件夹和页面）。 | project_id 必填 |
ab_get_wiki_article |
读取文档的完整内容、元数据和版本信息。 | project_id 必填 article_id 必填 — 来自 ab_get_wiki_tree 或 ab_search_wiki |
ab_search_wiki |
列出特定文件夹路径下的文档。 | project_id 必填 parent_path 可选 — 要列出的文件夹（默认：根目录的 /） |
ab_create_wiki_article |
以 Markdown 创建一个新文档。向已链接的 Teams 频道发布通知。 | project_id 必填 title 必填 content 必填 — Markdown parent_path 可选 — 文件夹，例如 / 或 /Engineering（默认：/）tags 可选 — 以逗号分隔 |
ab_update_wiki_article |
更新现有文档。创建一个带有编辑备注的新版本，并向 Teams 频道发布通知。 | project_id 必填 article_id 必填 content 必填 — 更新后的 Markdown edit_note 必填 — 变更内容；显示在版本历史中 tags 可选 — 更新后的以逗号分隔的标签 |
ab_add_wiki_comment |
向文档添加评论。 | project_id 必填 article_id 必填 content 必填 — 评论文本 |
AI 变更如何保持可见
当通过 MCP 工具创建、更新或完成任务或文档时，AB Projects 会自动：
- 在该项的变更历史中记录变更，附上用户姓名和提供的备注
- 出于审计目的写入一条操作日志条目
- 在项目已链接的 Microsoft Teams 频道中发布或更新一张 Adaptive Cards（自适应卡片），并清晰披露该活动为 AI 生成
因此 AI 驱动的变更具有与直接在 AB Projects 应用或 Teams 选项卡中所做变更相同的可见性和可追溯性。有关如何连接助手，请参见 通过 MCP 连接 AI 助手。