MCP 工具參考

ActionBridge 提供 AI 助理 55 個 MCP 工具（Model Context Protocol，助理用來連接各種應用程式的開放標準）：AB Projects 有 22 個 ab_* 工具，AB Sales 有 25 個 ab_crm_* 工具，AB Support 有 8 個 ab_support_* 工具。唯讀工具只會傳回資料，不會變更任何內容。寫入工具會以您的身分變更資料，並記在您的名下 — 其中六個最受團隊關注的任務與文件工具，還會在已連結的 Microsoft Teams 頻道張貼一張卡片。

AB Projects 工具

AB Sales（CRM）工具

AB Support 工具

斜線指令提示

可拉取的資源摘要

讀取免費；寫入 AB Projects 需要席次。每個唯讀工具，任何專案成員都能使用。當您的組織超過 10 位免費使用者之後，AB Projects 的十一個寫入工具就需要一個已授權席次 — 未授權使用者的助理會收到一則清楚的錯誤訊息，並附上授權管理的連結，而不是默默失敗。ab_crm_* 工具的門檻不同：關鍵在於您是不是該 AB Sales 工作區的成員。只要您能在 AB Sales 中開啟那個工作區，它的 CRM 工具對您就可用，讀取與寫入皆然 — AB Projects 的席次規則不適用於它們。ab_support_* 工具也一樣：關鍵在於您是不是該 desk（服務台）的成員。請參閱管理訂閱、帳單與授權。

如何閱讀這些表格

每個 MCP 工具名稱旁邊那些標記的意思
標記	意思
唯讀	只傳回資料。不會變更任何內容。
寫入	變更資料，並記在您的名下。
Teams 卡片	同時會在已連結的 Microsoft Teams 頻道張貼或更新一張卡片，並清楚揭露為 AI 活動。

不是每一次寫入都會張貼到 Teams。只有帶著 Teams 標記的那六個工具會通知頻道。文件留言、任務–文件連結、專案狀態／類型／環境的變更，以及所有 AB Sales 與 AB Support 的寫入，都是靜靜地存下來 — 它們會以您的名義出現在應用程式中，但不會有人收到卡片。如果某項變更一定要讓團隊看見，請改用任務工具，或自己在頻道裡說一聲。請參閱 AI 寫入時會發生什麼事。

如果您還沒建立連線，請參閱透過 MCP 連接 AI 助理。

AB Projects MCP 工具

這些工具處理專案、任務、排程，以及專案的文件（Wiki）。大多數都需要一個 project_id — 從 ab_get_my_projects 取得。

專案與身分

專案的狀態、類型與環境，是看板用來分類任務的標籤 — 例如 In Progress、Bug 或 Production。三者合稱為專案的選項（options）。

用來列出專案、成員與選項、管理專案的狀態／類型／環境，以及確認您身分的 AB Projects MCP 工具
工具	作用	主要輸入
`ab_get_my_projects` 唯讀	列出您所屬的每一個專案，包含成員人數、整體進度、您在其中的角色，以及建立時間。	無
`ab_get_project_members` 唯讀	列出專案成員及其角色與成員資格 ID — 指派任務時需要的就是這個 ID。	`project_id`
`ab_get_project_options` 唯讀	傳回專案有效的狀態、類型與環境 ID，以及固定的優先順序數字。助理在把這些設到任務上之前，應該先呼叫它。	`project_id`
`ab_create_task_option` 寫入	為專案新增一個狀態、類型或環境 — 也就是專案的 Status、Types 與 Environments 設定頁所編輯的那幾份清單。這份清單由整個團隊的看板共用，所以已經在使用中的名稱會被拒絕；新的選項會加在清單最後面。狀態還可以設定成：任務移入時就標示為完成，或設定其進度。`note` 是必填，並會記錄在專案的變更記錄中。不會有 Teams 卡片。	`project_id`、`kind`（status／type／environment）、`name`、`note`；選填描述、顏色、`locale`
`ab_update_task_option` 寫入	為既有的狀態、類型或環境重新命名、更改顏色、加上描述或調整順序，或變更某個狀態是否會完成任務、會設定什麼進度。所有使用該選項的任務都會立刻反映這項變更。選項在這裡無法刪除 — 否則任務會指向不存在的東西。`note` 是必填。不會有 Teams 卡片。	`project_id`、`kind`、`option_id`、`note`；選填名稱、描述、顏色、`position`
`ab_whoami` 唯讀	身分檢查：伺服器為這次連線解析出來的電子郵件、您的 AB 使用者 ID、顯示名稱、租用戶、您的驗證方式，以及伺服器版本。當驗證或成員資格看起來不對勁時很有用。	無

任務與排程

用來讀取、建立、更新、完成任務與新增留言的 AB Projects MCP 工具
工具	作用	主要輸入
`ab_get_my_tasks` 唯讀	您進行中的任務 — 逾期、今日到期與進行中 — 附上 ID、標題、優先順序、狀態、到期日與進度。	`project_id`（選填篩選）；選填 `limit`
`ab_search_tasks` 唯讀	跨您所有專案以關鍵字搜尋任務。	`query`；選填 `project_id`、`limit`
`ab_get_task` 唯讀	一筆任務的完整細節，包含它的留言、前置與後續任務，以及任何已連結的文件。	`project_id`、`task_id`
`ab_get_schedule` 唯讀	您今天與本週的任務，依到期日排列。	選填 `project_id`、`limit`
`ab_create_task` 寫入 Teams 卡片	建立一筆任務。支援描述（Markdown）、優先順序（1 = 高、2 = 中、3 = 低）、負責人、到期日、狀態／類型／環境 ID、`parent_task_id`（讓它成為子任務），以及 `depends_on_task_ids`（先完成再開始的相依關係；循環相依會被拒絕）。`note` 說明原因 — 它會出現在變更歷程與 Teams 卡片中。	`project_id`、`title`
`ab_update_task` 寫入 Teams 卡片	更新任務的標題、描述、狀態、進度（0–100）、優先順序、負責人、類型、環境、上層任務、開始／到期日、預估工時或相依關係（`add_predecessors` / `remove_predecessors`）。每一項變更都會連同所提供的備註一起記錄。	`project_id`、`task_id`
`ab_complete_task` 寫入 Teams 卡片	將任務標示為完成，並附上一則完成備註。	`project_id`、`task_id`
`ab_add_comment` 寫入 Teams 卡片	在任務的討論串中新增留言；同時也會張貼到該任務的 Teams 對話中。	`project_id`、`task_id`、`content`

文件（Wiki）

用來瀏覽、讀取、寫入與連結專案文件的 AB Projects MCP 工具
工具	作用	主要輸入
`ab_get_wiki_tree` 唯讀	專案的文件導覽樹（資料夾與頁面）。	`project_id`
`ab_get_wiki_article` 唯讀	讀取一份文件的完整內容、中繼資料與版本資訊。	`project_id`、`article_id`
`ab_search_wiki` 唯讀	列出某個資料夾路徑下的文件（名稱雖然叫搜尋，實際上是瀏覽資料夾，而不是以關鍵字搜尋）。	`project_id`；`parent_path`（預設 `/`）
`ab_create_wiki_article` 寫入 Teams 卡片	以 Markdown 建立一份文件，可指定資料夾與標籤。	`project_id`、`title`、`content`
`ab_update_wiki_article` 寫入 Teams 卡片	更新一份文件，並建立新版本。必填的 `edit_note` 會顯示在版本歷程中。	`project_id`、`article_id`、`content`、`edit_note`
`ab_add_wiki_comment` 寫入	為文件新增留言。儲存在文件上；不會有 Teams 卡片。	`project_id`、`article_id`、`content`
`ab_link_task_wiki` 寫入	把一筆任務連結到一份文件。這個連結是雙向的 — 兩邊都會顯示 — 呼叫兩次也不會有問題。不會有 Teams 卡片。	`project_id`、`task_id`、`wiki_article_id`
`ab_unlink_task_wiki` 寫入	移除任務–文件連結；若兩者原本就沒有連結，則不會有任何動作。不會有 Teams 卡片。	`project_id`、`task_id`、`wiki_article_id`

檢視者無法寫入。如果您在專案中的角色是唯讀的檢視者（Viewer），寫入工具會附上清楚的說明予以拒絕，而不是默默失敗 — 請找專案管理員把您改成成員（Member）。

AB Sales（CRM）MCP 工具

這些工具處理您的銷售管道 — 也就是潛在客戶（Lead） → 聯絡人（Contact） → 商機（Opportunity） → 客戶（Customer）的漏斗。幾乎每一個都需要 workspace_id — 請先呼叫 ab_crm_workspaces 取得。所有 CRM 寫入都會蓋上您的名字與時間，並在 AB Sales 應用程式中看得到，但它們都不會張貼 Teams 卡片。

探索

用來列出工作區、銷售脈絡與銷售管道的 AB Sales MCP 工具
工具	作用	主要輸入
`ab_crm_workspaces` 唯讀	列出您可以使用的 CRM 工作區，附上潛在客戶／聯絡人／商機／客戶的數量。請先呼叫這一個 — 其他每個 CRM 工具都需要它給的工作區 ID。	無
`ab_crm_get_sales_context` 唯讀	該工作區的銷售脈絡，用來草擬符合品牌調性的外拓內容：產品與價格、銷售目標、價值主張，以及是否已設定外寄電子郵件。	`workspace_id`
`ab_crm_get_pipeline` 唯讀	銷售管道摘要：依階段分列的進行中商機（筆數、總額、加權金額）、工作區總計，以及 30 天內即將結案的交易。	`workspace_id`
`ab_crm_get_win_patterns` 唯讀	從您已結案的交易中，挖掘贏單有哪些共通點 — 銷售週期長度、交易規模、活動節奏、產業、潛在客戶來源，以及失單時填寫的原因。它至少需要 5 筆 Closed-Won（成交）交易才會給出結論（另需 5 筆 Closed-Lost（失單）才能對照失敗的那一側）；低於這個數量時，它會告訴您歷史資料還不夠，而不是從寥寥幾筆交易硬推出結論。	`workspace_id`

潛在客戶

用來列出、讀取、建立與更新潛在客戶的 AB Sales MCP 工具
工具	作用	主要輸入
`ab_crm_list_leads` 唯讀	列出或搜尋潛在客戶（Lead），最新的在前。狀態：New InformationFilled Contacted Qualified Disqualified（新建、資料已補齊、已聯絡、已符合資格、不符合資格）	`workspace_id`；選填 `status`、`label`、`source`、`query`、`limit`
`ab_crm_get_lead` 唯讀	一筆潛在客戶的完整內容：基本資料、AI 公司研究、最近的註記、最近的電子郵件，以及它的商機。助理在更新潛在客戶或寄信給它之前會先呼叫它。	`workspace_id`、`lead_id`
`ab_crm_create_lead` 寫入	建立一筆潛在客戶 — 只有名稱是必填。潛在客戶會從 New（新建）開始，一旦名稱、網站與電子郵件都齊全，就會自動晉升到 InformationFilled（資料已補齊）。每建立一筆新的潛在客戶，就會用掉該工作區每月新增潛在客戶額度中的一筆；額度用完時，這個工具會拒絕並明白告知。	`workspace_id`、`name`；選填電子郵件、網站、聯絡人、電話、產業、來源、註記
`ab_crm_update_lead` 寫入	更新一筆潛在客戶的欄位、狀態及／或標籤。標籤是逐一新增或移除的（`add_labels` / `remove_labels`）；這筆潛在客戶的其他標籤會保留。設定 `automation_opt_out=true` 會把這筆潛在客戶排除在所有自動外拓之外。	`workspace_id`、`lead_id`

用來列出、建立、編輯與封存潛在客戶標籤的 AB Sales MCP 工具
工具	作用	主要輸入
`ab_crm_list_labels` 唯讀	列出工作區的潛在客戶標籤，附上 ID、名稱與顏色。	`workspace_id`；選填 `include_archived`
`ab_crm_create_label` 寫入	建立一個標籤。若已有同名的標籤則會拒絕 — 工具會改為指向那一個。	`workspace_id`、`name`；選填顏色
`ab_crm_update_label` 寫入	為標籤重新命名或更改顏色。帶有這個標籤的每一筆潛在客戶都會反映這項變更。	`workspace_id`、`label_id`；`name` 及／或 `color`
`ab_crm_archive_label` 寫入	封存（移除）一個標籤。它會立刻從每一筆潛在客戶與每一個篩選中消失；潛在客戶本身不會被更動。由於這會改變整個團隊的檢視，助理應該先與您確認。	`workspace_id`、`label_id`

客戶、聯絡人與商機

處理客戶、聯絡人與商機的 AB Sales MCP 工具
工具	作用	主要輸入
`ab_crm_list_customers` 唯讀	列出或搜尋客戶（Customer），最新的在前。	`workspace_id`；選填 `search`、`limit`
`ab_crm_create_customer` 寫入	建立一筆客戶 — 通常是在轉換一筆已符合資格的潛在客戶時。	`workspace_id`、`name`
`ab_crm_list_contacts` 唯讀	列出隸屬於某一筆客戶的聯絡人（Contact）。	`workspace_id`、`customer_id`
`ab_crm_list_opportunities` 唯讀	列出商機（Opportunity），預計結案時間最近的在前。狀態：Open（進行中）、Closed-Won（成交）、Closed-Lost（失單）。	`workspace_id`；選填 `status`、`limit`
`ab_crm_create_opportunity` 寫入	在一筆客戶或一筆潛在客戶底下建立商機（上層必須已經存在）。	`workspace_id`、`parent_type`（Customer／Lead）、`parent_id`、`name`；選填金額、幣別、預計結案日
`ab_crm_update_opportunity` 寫入	推動階段、變更金額／預計結案日／下一步，或以 `close='won'` 或 `close='lost'` 結案（失單時必須填寫原因）。	`workspace_id`、`opportunity_id`

活動、註記與電子郵件

處理活動、註記與電子郵件的 AB Sales MCP 工具
工具	作用	主要輸入
`ab_crm_list_activities` 唯讀	列出活動（通話、會議、後續追蹤任務）— 可以是某一筆記錄上的活動，也可以是今天前後那段時間已排定的活動。	`workspace_id`；選填 `related_type`+`related_id`、`days_back`／`days_ahead`
`ab_crm_create_activity` 寫入	在潛在客戶、客戶、商機或聯絡人上排定一項後續追蹤（Call、Email、Meeting、Note 或 Task — 通話、電子郵件、會議、註記或任務）。會出現在團隊的待辦事項中。	`workspace_id`、`related_type`、`related_id`、`subject`
`ab_crm_complete_activity` 寫入	把一項活動標示為已完成，可一併記錄結果。	`workspace_id`、`activity_id`
`ab_crm_add_note` 寫入	在潛在客戶、客戶、商機或聯絡人上新增一則註記（支援 Markdown）— 這是替團隊記下通話、決定與 AI 行動的方式。	`workspace_id`、`parent_type`、`parent_id`、`text`
`ab_crm_list_notes` 唯讀	列出一筆記錄的註記，最新的在前。	`workspace_id`、`parent_type`、`parent_id`
`ab_crm_list_emails` 唯讀	某筆潛在客戶、客戶或聯絡人上的電子郵件往來（收信與寄信皆含），最新的在前，並附上預覽。	`workspace_id`、`parent_type`、`parent_id`
`ab_crm_send_email_to_lead` 寫入	從該工作區已設定的信箱寄一封純文字電子郵件給潛在客戶，接著把它歸檔到這筆潛在客戶的郵件往來中，並加上一則說明「經由 MCP 寄出」的註記。助理必須先與您確認收件者、主旨與內文；而當這筆潛在客戶已選擇退出自動化、工作區的自動化已暫停，或尚未設定信箱時，寄送會被拒絕。	`workspace_id`、`lead_id`、`subject`、`body`

每個工具確切的參數結構，隨時都能從工具本身取得；上面的輸入是參考，不是完整的規格。

AB Support MCP 工具

這些工具處理您的 desk（服務台）與上面的工單。每一個都需要 desk_id — 請先呼叫 ab_support_desks 取得。和 CRM 工具一樣，它們的門檻是您是不是該 desk 的成員，而不是 AB Projects 的席次，而且它們都不會張貼 Teams 卡片。AB Support 的使用者介面只提供英文，因此本文中的中文名詞旁，會附上畫面上實際顯示的英文字。

助理無法回覆您的客戶。沒有任何工具會送出回覆，所以助理在這裡做的事，都不會傳到提出工單的那個人手上。ab_support_draft_reply 可以在工單上留下一份草稿回覆，但在您 desk 上的某個人審閱它、並用 Use this（使用這則）送出之前，客戶什麼都看不到。ab_support_add_note 寫的是一則內部註記，只有您的 desk 看得到。

工單

用來列出 desk、搜尋工單與讀取單一工單的 AB Support MCP 工具
工具	作用	主要輸入
`ab_support_desks` 唯讀	列出您可以使用的 desk，附上進行中與總計的工單數量。請先呼叫這一個 — 其他每個 Support 工具都需要它給的 desk ID。	無
`ab_support_list_tickets` 唯讀	列出或搜尋某個 desk 的工單，最近有動靜的在前，附上客戶、負責人、狀態、優先順序，以及目前是 AI 還是真人在處理。AI 正在回覆某張工單時，它的負責人會顯示為「AI」。	`desk_id`；選填 `status`、`search`、`limit`
`ab_support_get_ticket` 唯讀	一張工單的完整內容：面向客戶的對話、desk 的內部註記（分開保存，才不會被誤認成客戶說過的話）、變更歷程，以及 AI 的建議回覆 — 那是一份草稿，尚未送出。	`desk_id`、`ticket_id`

分流

處理工單狀態、工單分流、內部註記與草稿回覆的 AB Support MCP 工具
工具	作用	主要輸入
`ab_support_ticket_statuses` 唯讀	該 desk 自己的狀態與它們的 ID。狀態屬於個別 desk，而且可以重新命名與重新排序，所以助理必須先讀取它們，不能假設一定存在一個叫 “Open” 的狀態。	`desk_id`
`ab_support_update_ticket` 寫入	分流一張工單：狀態、負責人及／或優先順序。`reason` 是必填 — 它會寫進工單的歷程，讓 desk 看得到工單為什麼動了，而不只是看到它動了。不會改變任何客戶看得到的內容。把某個人指派到 AI 持有的工單上，就會把工單從 AI 手上接過來：AI 會停止回覆這位客戶，歷程中會顯示「AI → 姓名」。	`desk_id`、`ticket_id`、`reason`；選填 `status_id`、`assignee_user_id`、`priority`
`ab_support_add_note` 寫入	為 desk 新增一則內部註記 — 客戶永遠看不到，而且它不會移動工單的狀態，因為註記不是回覆。	`desk_id`、`ticket_id`、`note`
`ab_support_draft_reply` 寫入	把一份給客戶的草稿回覆，留作這張工單的建議回覆 — 也就是 AI 自己的建議出現的同一個位置，並取代之前的任何一份。它絕不會送出任何東西：由 desk 上的某個人開啟工單、審閱草稿，再用 Use this 送出。收件者永遠是這張工單的客戶，絕不是助理自己選的對象。已關閉的工單會被拒絕；若 desk 目前還無法送出這份草稿（因為使用額度已用完而暫停回覆，或客戶已選擇退出該工單的管道），它會提出警告。	`desk_id`、`ticket_id`、`body`

人

用來讀取單一客戶及其過去工單的 AB Support MCP 工具
工具	作用	主要輸入
`ab_support_get_customer` 唯讀	一位客戶的詳細資料與他們過去的工單 — 這個人以前問過沒有，又是問了什麼。`customer_id` 就在工單上。也會顯示某人是否已選擇不再接收 SMS 與 WhatsApp。	`desk_id`、`customer_id`；選填 `limit`

每個工具確切的參數結構，隨時都能從工具本身取得；上面的輸入是參考，不是完整的規格。

MCP 提示 — 現成的斜線指令

除了工具之外，伺服器還發布 MCP 提示：在支援的用戶端（Claude、ChatGPT、Cursor…）中會以斜線指令的形式出現的範本。每一個都會展開成一組指示，去驅動上面那些工具 — 您不必自己把需求寫出來，就能拿到一份整理好的結果。

ActionBridge 以斜線指令形式發布的五個 MCP 提示
提示	產出的內容	參數
`ab-standup`	每日站立會議簡報：逾期、今日到期與進行中。	`project_id`（選填）
`ab-weekly-review`	每週回顧：交付了什麼、延誤了什麼、下週有什麼風險。	`project_id`（選填）
`ab-create-task`	從一句自然語言的意圖引導您建立任務 — 它會先取得有效選項，提議標題／優先順序／到期日，然後建立這筆任務。	`project_id`、`intent`（兩者皆必填）
`ab-find-blocked`	看起來被卡住的任務，依專案分組，卡最久的在前。	`project_id`（選填）
`ab-wiki-recap`	某個專案中最近編輯過的文件摘要。	`project_id`（必填）

MCP 資源 — 可拉取的摘要

MCP 資源是唯讀的摘要，用戶端不必呼叫工具就能把它們當成背景脈絡附上。這四個全都是關於您自己的工作，不是整個團隊的：

四個 MCP 資源摘要，以及各自包含的內容
資源	內容
`ab://me/today`	您所屬的每一個專案中今天到期的任務。
`ab://me/week`	未來 7 天內到期的任務，加上今天的。
`ab://me/projects`	您的專案，附上成員人數、進度與您的角色。
`ab://project/…/overview`	每個專案一份：您在該專案中進行中的任務，加上該專案的成員清單。

AI 寫入時會發生什麼事

每一次寫入都走和應用程式相同的程式路徑，並記在您的名下 — 不存在匿名的「機器人」作者。至於它會把自己宣告得多大聲，則取決於工具：

哪些 MCP 寫入工具會記錄變更歷程、寫入作業記錄，以及張貼 Teams 卡片
寫入工具	存在記錄上	作業記錄（稽核）	Teams 卡片
`ab_create_task`、`ab_update_task`、`ab_complete_task`、`ab_add_comment`	變更歷程，附上您的 `note`	是	是，並揭露為 AI 活動
`ab_create_wiki_article`、`ab_update_wiki_article`	新版本，附上您的 `edit_note`	是	是，並揭露為 AI 活動
`ab_create_task_option`、`ab_update_task_option`	是 — 專案的變更記錄會記下這項變更、變更前後的內容，以及您的 `note`	是	否
`ab_add_wiki_comment`、`ab_link_task_wiki`、`ab_unlink_task_wiki`	是，記在您的名下	否	否
全部十二個 `ab_crm_*` 寫入工具	是，蓋上您的名字與時間；註記與活動會顯示在該筆記錄的歷程中	潛在客戶、商機、註記、新活動與寄出的電子郵件會記錄；客戶、已完成的活動與標籤則不會	否
`ab_support_update_ticket`、`ab_support_add_note`、`ab_support_draft_reply`	是 — 工單的歷程會記下這項變更與您填的原因	是	否

所以助理建立或結束的任務，和您自己動手點的一樣顯眼 — 同樣的變更歷程、同樣的稽核記錄、頻道裡同樣的一張卡片。比較安靜的那些寫入（文件留言、任務–文件連結、專案選項的變更、CRM 記錄，以及支援工單）仍然記在您的名下，也仍然在應用程式中看得到；它們只是不去打擾頻道而已。

常見問題

只是要讓助理讀取，也需要授權嗎？

不需要。每個唯讀工具，任何專案成員都能使用，有沒有授權都一樣。只有 AB Projects 的十一個寫入工具會檢查席次，而且只在您的組織超過 10 位免費使用者之後才會檢查。

為什麼我的助理只看得到部分專案？

這些工具永遠只看得到您已經接受邀請、確實加入的專案與工作區。請執行 ab_whoami 確認伺服器為您這條連線解析出來的是哪一個帳號 — 大多數「工具找不到東西」的回報，原因都在這裡對不上。

AI 會在我不知情的情況下寄信給客戶嗎？

ab_crm_send_email_to_lead 是唯一會寄信的工具，它要求您先確認收件者、主旨與內文；而當這筆潛在客戶已選擇退出自動化、該工作區的自動化已暫停，或尚未設定信箱時，它會直接拒絕。每一次寄送都會連同一則註記歸檔到該筆潛在客戶的郵件往來中。

助理可以回覆支援客戶嗎？

不能直接回覆。ab_support_* 這一組裡沒有任何工具會送出回覆，所以助理的任何動作都不會傳到提出工單的那個人手上。它可以讀取對話串、變更狀態、指派、設定優先順序、新增一則只會留在您 desk 上的內部註記，以及用 ab_support_draft_reply 擬一份回覆。那份草稿會作為建議回覆留在工單上，直到您 desk 上的某個人審閱它並用 Use this 送出 — 或是不予理會。