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 選填 — 上層任務的 row key；設定後，此任務會成為子任務，且上層任務的「具有子任務」旗標會自動更新 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 助理。