WhatsApp Business Tools MCP：如何將 WhatsApp Business 連接至 AI 代理程式

2026 年 9 月 15 日，Meta 發布了官方的 WhatsApp Business Tools MCP 伺服器。它能將 AI 代理程式——Claude Code、Codex、ChatGPT 或 Cursor——連接至 WhatsApp Business Platform。你不必再在 Developer Console、Business Manager 和 API 文件之間切換，只要向代理程式描述工作，它就能新增電話號碼、建立訊息範本、設定 Webhook，並傳送測試訊息。

這個伺服器仍處於測試版：目前正逐步開放使用，這個版本是為開發和測試而推出，並非供大規模正式環境傳送訊息使用。以下介紹四種用戶端的準備工作和連線步驟。指令和設定已依據 Meta 於 2026 年 9 月 18 日的官方文件核對。

Ailoot 的使用資訊請參閱文件。

什麼是 WhatsApp Business Tools MCP？#

MCP（Model Context Protocol，模型情境協定）是用來將外部系統連接至 AI 代理程式的開放標準。深入了解請參閱文章Claude Code 的 MCP 伺服器：7 種現成整合。已驗證且附有安裝指令的連線方式收錄於 MCP 目錄。

在這項服務推出之前，設定 WhatsApp 整合看起來會是這樣：開啟 Developer Console、建立應用程式、連結商家、新增電話號碼、輸入驗證碼完成驗證、產生權杖、設定 Webhook、查閱 API 文件——之後才能開始寫第一行程式碼。

Meta 對這個伺服器背後的構想有以下說明（由英文翻譯）：

Meta 現在有兩種 MCP 伺服器，很容易混淆。Meta Social Technologies MCP 是通用的開發者工具，可用來搜尋文件、探索 Graph API 端點，以及診斷應用程式錯誤。WhatsApp Business Tools MCP 則用於管理 WhatsApp 帳號、電話號碼、範本、Webhook 和測試訊息。兩者互補，需要時可以同時連線。

連線後，代理程式具體能做什麼？#

伺服器工具分組使用whatsapp_biz_前綴。根據官方文件，工具如下：

• 概覽：whatsapp_biz_businesses、whatsapp_biz_accounts、whatsapp_biz_phone_numbers——查詢你可以使用哪些商家、帳號和電話號碼。
• 電話號碼設定：whatsapp_biz_add_phone_number、whatsapp_biz_send_verification_code、whatsapp_biz_verify_phone_number、whatsapp_biz_register_phone_number。
• 範本：whatsapp_biz_list_templates、whatsapp_biz_get_template、whatsapp_biz_create_template、whatsapp_biz_update_template、whatsapp_biz_delete_template。
• 訊息：whatsapp_biz_send_message——在 24 小時對話時限內傳送自由格式文字，或在時限外傳送已核准的範本；代理程式會在傳送前向你確認收件者。
• Webhook：whatsapp_biz_configure_webhooks、whatsapp_biz_subscribe_webhook。
• 帳號設定：whatsapp_biz_configure_payments、whatsapp_biz_verify_business、whatsapp_biz_system_user_token——提供建立系統使用者權杖的連結，以便直接呼叫 Cloud API。

顧客先傳訊息給商家時，顧客服務時限便會開始。在 24 小時內，你可以用自由格式文字回覆。顧客每傳來一則新訊息，時限就會延長。時限結束後，你只能使用已核准的範本聯絡顧客。代理程式知道這項規則，如果收件者已不在時限內，就會建議使用範本，而非一般文字。

伺服器內建存取控制。你使用 Meta 帳號登入，並選擇特定商家；權杖不會包含在對話記錄中。每次讀取都會在你的使用者情境中執行，呼叫會留下記錄，而會造成變更的操作必須由已驗證的使用者執行；只有伺服器應用程式金鑰並不足夠。

連線前應該檢查什麼？#

伺服器會代表你操作，並且只使用你的資源，因此在第一次呼叫前，請確認以下事項：

1. 你有一個 Meta 商家，且在其中具有管理員身分（MANAGE 角色）。
2. 你有一個已啟用 WhatsApp Business Messaging 情境的 Meta 應用程式（或較舊應用程式中的 WhatsApp 產品），而且你是該應用程式本身的管理員；只有商家層級的權限並不足夠。
3. 該商家已接受 WhatsApp Business Cloud API 條款——若未接受，就無法註冊電話號碼或傳送訊息。

Meta 表示，使用條款、付款方式和商家驗證方面的問題經常在沒有明確說明的情況下出現。代理程式會事先檢查這些項目，並提供可直接前往接受條款、指定付款方式或開始商家驗證的連結。

如何將伺服器連接至 Claude Code？#

如果你還沒安裝 Claude Code，請先參閱指南如何從官方網站安裝 Claude Code。

1. 新增伺服器

   在終端機中執行：

   claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
   

   這是遠端伺服器，因此不需要在本機安裝。

2. 透過 Meta 登入

   在 Claude Code 工作階段中輸入/mcp，並選取whatsapp_business_tools。瀏覽器視窗會開啟，供你登入 Meta 帳號。如果瀏覽器沒有開啟，請從用戶端複製連結並手動開啟。

3. 授予權限

   在同意畫面中，選擇你允許伺服器存取的商家和 WhatsApp 應用程式。伺服器會要求三項權限：business_management（尋找你具有管理員身分的商家）、whatsapp_business_management（帳號、電話號碼、範本、Webhook），以及whatsapp_business_messaging（從你的電話號碼傳送訊息）。

4. 檢查連線

   重新啟動 Claude Code，透過/mcp再次登入，然後詢問代理程式在whatsapp_business_tools伺服器上看得到哪些工具。接著執行安全的讀取操作：「列出我可以管理的商家」——代理程式會呼叫whatsapp_biz_businesses。如果沒有任何工具，或出現登入錯誤，請檢查伺服器位址並再次登入。

OAuth 登入與用戶端啟動程序綁定：重新啟動 Claude Code 後，需要再次登入。你可以隨時前往 facebook.com 的設定，在「Business Integrations」下撤銷存取權。

如何連接 Codex、ChatGPT 和 Claude Desktop？#

Codex App。 開啟設定（左下角的齒輪），前往 MCP Servers，然後選取 Add servers。選擇 Streamable HTTP 並輸入：

• Name：WhatsApp Business Tools
• URL：https://mcp.facebook.com/whatsapp_business_tools
• Authentication：OAuth

按一下 Authenticate，並在瀏覽器中登入。

ChatGPT。依序前往 Settings、Plugins、Browse plugins，然後點選右上角的「+」圖示。輸入名稱、相同的 URL，以及 OAuth 作為驗證類型。

Claude Desktop。依序前往 Settings、Connectors、Add custom connector。Name：WhatsApp Business Tools；URL：相同的伺服器位址。

在任何用戶端新增伺服器後，依照相同的檢查步驟操作：重新啟動、再次登入、查看工具清單，並安全地讀取商家清單。

第一次工作階段會發生什麼事：從商家清單到測試訊息#

連接伺服器後，第一次工作階段通常會像這樣：

1. 「列出我管理的商家」——代理程式呼叫whatsapp_biz_businesses，然後由你選擇需要的商家。
2. 「顯示這個商家的 WhatsApp 帳號和電話號碼」——透過whatsapp_biz_accounts和whatsapp_biz_phone_numbers查看狀態。
3. 「將我的測試電話號碼新增至帳號」——whatsapp_biz_add_phone_number。
4. 「透過簡訊傳送驗證碼」——whatsapp_biz_send_verification_code。你的手機會收到驗證碼。
5. 「使用驗證碼 123456 驗證這個號碼」——呼叫whatsapp_biz_verify_phone_number，接著使用whatsapp_biz_register_phone_number註冊號碼。
6. 「使用收件者偏好的語言，建立一個用於訂單通知的order_update範本」——whatsapp_biz_create_template；代理程式會提供查看審核狀態的連結。
7. 「傳送測試訊息到我的號碼」——whatsapp_biz_send_message；代理程式會在傳送前向你確認收件者。
8. 「在https://example.com/webhook設定 Webhook」——呼叫whatsapp_biz_configure_webhooks，並使用whatsapp_biz_subscribe_webhook訂閱。

完成後，顧客傳入的訊息會抵達指定的位址——通常由 CRM、客服服務或機器人在該處接收。你需要另外建置該位址的訊息處理流程；伺服器只負責設定。

測試版有哪些限制？#

使用伺服器時，請留意以下四項限制。

測試版狀態。 Meta 表示，介面和工具集合可能會變動，存取權也正逐步開放。如果你目前還無法連接伺服器，可能是因為尚未開放給你使用。

用途。 這個版本是為開發和測試而推出，並非供正式環境大量傳送訊息使用。若要在正式環境傳送訊息，你需要與 Cloud API 完整整合，例如使用whatsapp_biz_system_user_token工具提供連結的系統使用者權杖。

限制。 每個工具都設有使用者層級的請求限制。若超過限制，工具會傳回限制錯誤——請稍候再試。

24 小時時限規則。 顧客對話時限結束後，只能傳送已核准的範本。

這對企業有什麼意義？#

小型企業常見的情境是：顧客透過 WhatsApp 傳訊息，而你希望迅速回覆並傳送訂單狀態通知。過去，初始設定得由你自行操作好幾個 Meta 控制面板，或聘請開發者處理。現在你可以透過與代理程式對話完成這部分工作。你仍須另外建置在自家位址處理傳入訊息的流程——這是設定 Webhook 後的下一項工作。

如果整合已經在運作，這個伺服器也很實用。訊息範本需要定期更新，例如新增促銷活動或通知文字。透過伺服器，代理程式可以建立或編輯範本，並顯示審核狀態，不必帶你前往控制面板。

代理程式連接外部系統，並根據你的描述與系統互動；如何透過 MCP 將 NotebookLM 連接至 Claude Code這篇指南也用文件示範了類似做法。

接下來呢？#

這個伺服器在公布消息三天後，你現在就能用一條指令開始使用並透過 Meta 登入，接著請代理程式列出你的商家。之後可依需求設定電話號碼、範本、Webhook 和測試訊息。

其他將代理程式連接至外部系統的方法，請參閱Claude Code 的 MCP 伺服器合輯——其中還有七種可用於不同工作的整合方式。

認識 Ailoot。