WhatsApp MCP
官方使用你自己的號碼，從你的 AI 讀取、搜尋並回覆你的 WhatsApp 聊天。
你可以用 WhatsApp MCP 做什麼？
- 找出誰在等待回覆 — 詢問哪些聊天室的最後一則訊息尚未回覆，使用
get_unanswered_chats查看誰需要回覆。 - 搜尋你的訊息 — 使用
search_messages在所有聊天室中，或在單一聊天室或聯絡人內搜尋訊息文字。 - 以你的語氣草擬 — 使用
get_writing_style取得你寫作方式的範例，讓草擬的回覆聽起來像你本人。 - 傳送或排程 — 使用
send_message傳送文字或檔案連結，或使用schedule_message設定一次性或重複的訊息。 - 管理已傳送的訊息 — 以表情符號回應、編輯你自己的文字、為所有人刪除訊息，或將聊天室標為已讀。
- 連結並檢查狀態 — 透過 QR 或配對碼開始連結、檢查 WhatsApp 是否已連線，或重新啟動工作階段。
託管 MCP 伺服器
npx add-mcp 'https://server.wa-mcp.com/mcp'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
WhatsApp MCP 文件
WhatsApp MCP 將你的 AI 助理（Claude、ChatGPT、Cursor 或任何支援 Model Context Protocol 的用戶端）連接到你原本就在使用的 WhatsApp 號碼。你的助理可以讀取和搜尋你的聊天、找出誰在等待回覆，並傳送、排程、編輯訊息或對訊息表達心情，一切始終透過你自己的號碼，且只在你要求時進行。
它是以連結裝置的方式連結 WhatsApp，與 WhatsApp Web 相同。無需安裝應用程式、無需新號碼，也不需要 Meta Business API。
設定
你只需連接一次，然後在聊天中連結你的 WhatsApp。
選項 A：Claude 的連接器目錄
- 在 Claude 中開啟連接器目錄，找到 WhatsApp MCP。
- 點擊 Connect。我們的連接頁面會開啟：確認頁面顯示的是你的 AI 應用程式，然後再次點擊 Connect。
- 回到 Claude，開啟新的聊天並輸入 「Connect my WhatsApp」（請見下方「連結你的 WhatsApp」）。
無需註冊或密碼：你的 WhatsApp 號碼就是你的帳號，連結它就能讓我們知道是你。
選項 B：個人連接 URL（任何 MCP 用戶端）
- 前往 wa-mcp.com，選擇你的 AI 應用程式並點擊 Generate my link。
- 將該連結新增至你的 AI 應用程式作為自訂連接器（MCP 伺服器）。網站會顯示各應用程式的確切步驟，而如何將 Claude 連接到 WhatsApp 則逐步說明 Claude 的操作方式。
- 開啟新的聊天並輸入 「Connect my WhatsApp」。
請妥善保管此連結：它的作用如同密碼。你可以在多個 AI 應用程式中使用同一個連結。
連結你的 WhatsApp
當你要求助理連接你的 WhatsApp 時，它會提供兩種方式：
- **QR 碼：**你的助理會顯示 QR 碼（以及包含該 QR 碼的頁面連結）。在手機上開啟 WhatsApp → 設定 → 連結裝置 → 連結裝置，然後掃描該 QR 碼。
- **配對碼：**將你的電話號碼（含國碼）提供給助理。它會回傳一組 8 字元配對碼。在手機上開啟 連結裝置 → 連結裝置 → 改用電話號碼連結，然後輸入該配對碼。
連結後，WhatsApp 會將你近期的歷史記錄（最多約 90 天）同步到連結裝置；若帳號資料量大，可能需要幾分鐘。
方案
- **免費試用：**首次連結手機後 1 小時內可使用所有功能。
- **免費方案：**試用期結束後，讀取、摘要和搜尋聊天以及傳送文字訊息仍可繼續使用。文字訊息結尾會加上「Sent via wa-mcp.com」，且無法發起新的對話（過去 90 天內未曾傳訊息給你的人）。
- **付費方案：**檔案（照片、影片、語音訊息、文件）、排程訊息、編輯、對訊息表達心情和刪除訊息、具備防封鎖保護機制的新對話，且無標籤。
詢問你的助理*「我目前使用哪個方案？」*即可查看你的方案和訂閱選項。
工具
你的助理會選擇工具；你只需用自然語言提出要求。
讀取
| 工具 | 功能 |
|---|---|
get_recent_chats | 你最近的聊天，以及每個聊天的最新訊息。 |
get_unanswered_chats | 最後一則訊息來自對方的聊天，讓你能看到誰在等待回覆。 |
read_chat_history | 某個聊天、對象或群組的訊息。 |
search_messages | 搜尋你訊息的文字，可選擇限定於某個聊天或某個人。 |
search_contacts | 依名稱或號碼尋找聯絡人或群組。 |
download_media | 開啟訊息中的照片、語音訊息、影片、文件或貼圖。 |
get_writing_style | 你寫作方式的範例，讓你收到的草稿聽起來像你本人。 |
寫入
| 工具 | 功能 |
|---|---|
send_message | 傳送文字或來自連結的檔案給某個人或群組。會先顯示輸入中的指示。 |
schedule_message | 排程稍後傳送訊息，可單次或重複（每日、每週、每月等）。 |
list_scheduled_messages | 列出即將到來的排程訊息以及過去訊息的歷史記錄。 |
cancel_scheduled_message | 取消排程訊息（包含其所有重複項目）。 |
react_to_message | 以表情符號對訊息表達心情，或移除心情。 |
edit_message | 變更你自己其中一則訊息的文字。 |
delete_message | 為所有人刪除你自己其中一則訊息。 |
mark_as_read | 將聊天標示為已讀。 |
連線與帳號
| 工具 | 功能 |
|---|---|
get_session_status | 你的 WhatsApp 是否已連結並連線。 |
get_pairing_qr | 以 QR 碼開始連結。 |
request_pairing_code | 以配對碼開始連結。 |
restart_session | 若訊息停止送達，重新連線到 WhatsApp。 |
manage_subscription | 顯示你的方案和訂閱選項。 |
report_feedback | 向我們傳送錯誤回報或功能請求。 |
unlink_whatsapp | 取消連結你的 WhatsApp（你的帳號會保留）。 |
delete_account | 在你確認後刪除你的帳號及其所有資料。 |
範例提示
- 「從昨天到現在，誰在等我回覆？」
- 「摘要家庭群組這週聊了什麼。」
- 「找出 Carlos 傳地址給我的那則訊息。」
- 「告訴 Ana 訂單週四出貨。」（除非你提供了確切文字，否則你的助理會先顯示草稿）
- 「每週一早上 9 點，提醒團隊群組傳送每週更新。」
安全
- **你始終掌控傳送的內容。**當你的助理為你撰寫訊息時，除非你提供了確切文字，否則它會在傳送前先顯示草稿。
- **防封鎖保護機制。**傳送給過去 90 天內未曾傳訊息給你的人的訊息會分散發送（每分鐘最多 1 則，每 12 小時最多 10 個不同對象），因為這正是號碼被標記為垃圾訊息的原因。與曾傳訊息給你的人的聊天則從不受限。沒有大量傳送工具。
- **輸入中指示。**每則訊息前會短暫顯示「輸入中…」，就像你親自輸入時一樣。
疑難排解
- 「WhatsApp 未連結」：連結裝置已被移除（從你的手機移除，或透過取消連結）。請要求你的助理以相同號碼再次連接你的 WhatsApp。
- 配對碼無法使用：配對碼會在短時間後過期。請索取新的配對碼、確認號碼包含國碼，並在手機上使用 改用電話號碼連結。
- 訊息停止送達：請要求你的助理重新啟動你的 WhatsApp 連線。若你手機上的 WhatsApp 已離線約 14 天，WhatsApp 會登出連結裝置：請在手機上開啟 WhatsApp，然後再次連結。
- 「此連線已永久註冊至電話號碼…」：每個連線只屬於一支手機。若要使用另一個號碼，請取消連結，然後移除連接器並再次新增（或者，若使用個人 URL，請產生新的 URL）。
- 連接器顯示未連線（目錄使用者）：從你的連接器移除 WhatsApp MCP 並再次連接，然後連結同一支手機。你的帳號和訂閱會保留。
隱私與你的資料
你的訊息會在我們的伺服器上儲存 90 天，以便你的助理搜尋，且絕不會用於廣告或 AI 訓練。你的助理所讀取的內容由其供應商依其政策處理。你可以隨時要求你的助理取消連結你的 WhatsApp 或刪除你的帳號；刪除會立即移除所有內容。完整詳情請見我們的隱私權政策和條款。