跳至主要內容

如何將 Wati MCP 連接到 Meta Muse 或 Gemini CLI

摘要

將 Wati Model Context Protocol (MCP) 伺服器連接至 Meta Muse 或 Google 的 Gemini Command Line Interface (CLI)，即可使用自然語言操作您的 Wati 工作區。連接後，您可以使用兼容的 AI 客戶端來管理聯絡人、對話、訊息、範本、行銷活動以及其他支援的功能。

本指南將帶您了解如何透過 OAuth 驗證將 Wati MCP 連接至 Meta Muse 和 Gemini CLI。您可以使用現有的 Wati 帳戶登入，無需建立新帳戶或在設定中添加 API 金鑰。

注意：Wati MCP 伺服器適用於 Wati 的 Growth、Pro 和 Business 方案客戶。如果您目前正在使用試用帳戶，也可以在試用期間啟用並使用 Wati MCP 伺服器。

操作說明

選擇您要連接至 Wati 的 AI 客戶端，並依照對應章節的步驟進行操作。

請使用與您的 Wati 工作區區域相符的 MCP 伺服器 URL：

工作區區域

MCP 伺服器 URL

全球 (Global)

https://mcp.wati.io/mcp

歐盟 (EU)

https://eu-mcp.wati.io/mcp

第 1 部分：將 Wati MCP 連接至 Meta Muse

可用性：Meta Muse 目前僅在美國和加拿大提供。如果您位於這些地區之外，請改為透過 Gemini CLI 連接 Wati（請參閱第 2 部分）。

您可以直接從 Muse 應用程式將 Wati 連接至 Meta Muse。您將登入現有的 Wati 帳戶，並透過 Wati 的 OAuth 驗證流程授權存取權限。

連接步驟

1. 開啟連接器 (Connectors)

  • 開啟 Muse 應用程式，前往 Settings（設定），然後選擇 Connectors（連接器）。

2. 開啟自訂連接器

  • 向下捲動至 Custom（自訂）區段，並選擇 Custom connectors（自訂連接器）。

3. 輸入 Wati MCP 伺服器 URL

  • 在 Add custom connector（新增自訂連接器）畫面上，輸入上表中與您的工作區區域對應的 MCP 伺服器 URL。

4. 選擇 Wati

  • 您的瀏覽器將開啟 Wati 的連接頁面。頁面會顯示 agent.meta.ai 想要連接至 Wati 和 Astra。選擇 Wati 並點選 Continue（繼續）。

5. 登入並授權存取

  • 在 Wati 登入頁面上，使用您現有的 Wati 帳戶登入。審閱授權請求並核准存取權，即可完成連接。

您無需建立新帳戶或產生 API 金鑰。

6. 開始在 Muse 中使用 Wati

  • 連接完成後，即可要求 Muse 使用自然語言在您的 Wati 工作區中執行支援的任務。

第 2 部分：將 Wati MCP 連接至 Gemini CLI

您可以將 Wati MCP 連接至 Google 的 Gemini CLI，方法是將 Wati 伺服器設定加入您的 Gemini CLI 設定檔中。Gemini CLI 使用 OAuth 透過瀏覽器驗證您的 Wati 帳戶。

Gemini CLI 會連接至列於 settings.json 檔案中 mcpServers 下方的 MCP 伺服器。wati 項目使用 httpUrl 透過 Streamable HTTP 存取 Wati MCP 伺服器，而 oauth.enabled 讓 Gemini CLI 能夠透過您的瀏覽器登入，因此無需在檔案中加入 API 金鑰。完成授權後，Gemini CLI 會自動偵測您帳戶可使用的 Wati 工具。如需更多設定選項，請參閱 Gemini CLI MCP 伺服器說明文件。

先決條件

開始前請先安裝 Gemini CLI。請依照官方 Gemini CLI 安裝與設定指南操作。

連接步驟

提示：如果您不希望編輯 JSON 檔案，可以在終端機執行下列指令來取代步驟 1 和 2，然後從步驟 3 繼續：

gemini mcp add --transport http wati <https://mcp.wati.io/mcp>

針對歐盟工作區，請使用上表中的歐盟 URL。

1. 開啟 Gemini CLI 設定檔

  • 使用您偏好的文字編輯器開啟 ~/.gemini/settings.json。

    如果檔案不存在，請自行建立。

2. 新增 Wati MCP 伺服器設定

在 mcpServers 下方，新增以下設定：

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

針對歐盟工作區，請使用上表中的歐盟 URL。

如果您的設定檔中已經包含其他 MCP 伺服器，請將 wati 項目加入現有的 mcpServers 物件中。請保留現有的設定並確保 JSON 語法正確。

3. 重新啟動 Gemini CLI

  • 關閉並重新啟動 Gemini CLI，以便載入更新後的設定。

4. 登入 Wati

  • 首次使用此連接時，Gemini CLI 會開啟您的瀏覽器以啟動 Wati OAuth 登入流程。請使用現有的 Wati 帳戶登入並核准所要求的存取權限。

5. 返回終端機

  • 授權完成後，返回 Gemini CLI 並繼續使用已連接的 Wati 伺服器。

6. 如有需要，請重新驗證

  • 如果您需要再次登入，請在 Gemini CLI 中執行下列指令：

/mcp auth wati

7. 驗證連接

  • 要求 Gemini CLI 執行簡單的任務，例如：

List my Wati contacts.

如果連接和權限設定正確，Gemini CLI 應該能夠從您的 Wati 工作區擷取支援的聯絡人資訊。

使用 Wati MCP 可以做什麼？

根據您的工作區權限、產品方案和已啟用的頻道，您可以使用 Muse 或 Gemini CLI 執行下列任務：

  • 聯絡人：搜尋、列出、新增與更新聯絡人；管理聯絡人屬性；檢視聯絡人總數；以及將聯絡人指派給團隊。

  • 對話：擷取訊息、管理標籤和對話狀態、指派對話，以及將對話移交給操作員。

  • 訊息傳送：傳送文字訊息與檔案、使用互動式按鈕與清單，以及傳送已核准的訊息範本。

  • 行銷活動：管理廣播、檢視行銷活動統計數據、估算傳送成本，以及檢查可用額度。

  • 工作區設定：管理支援的區段、頻道、Webhook 和訊息範本。

  • Instagram：在您的工作區啟用該功能時，使用支援的 Instagram 工作流程。

範例指令

將 Wati 連接至任一客戶端後，請嘗試詢問：

  • "Find every conversation tagged billing from last week."（尋找上週標記為「帳單」的所有對話。）

  • "Send the order_update template to contacts in the VIP Customers segment."（將 order_update 範本傳送給「VIP 客戶」區段中的聯絡人。）

  • "How many contacts do we have?"（我們有多少聯絡人？）

  • "Show me the latest messages in conversations assigned to my team."（顯示分配給我團隊的對話中的最新訊息。）

以上為支援的工作流程範例。您可以使用的操作取決於您的帳戶和工作區設定。

疑難排解與重要注意事項

使用 Wati MCP 搭配任一客戶端時，請注意以下幾點：

  • 可用工具可能有所不同：帳戶可用的工具取決於您已驗證工作階段的 MCP 伺服器工具清單。

  • 權限規範依然適用：您的 Wati 工作區角色、產品方案和頻道權限決定了您可以執行哪些動作。即使工具可用，使用時若遇到權限或方案相關問題仍會回傳錯誤。

  • 使用正確的伺服器 URL：請確保您使用與您的 Wati 工作區相符的全球或歐盟端點。

  • 檢查您的設定：對於 Gemini CLI，請確認伺服器項目位於 mcpServers 下方，URL 正確，且 JSON 語法有效。

  • 在配有本機瀏覽器的電腦上操作 (Gemini CLI)：Gemini CLI 會在同一台電腦上開啟瀏覽器來完成 Wati OAuth 登入。這在 SSH 或無頭環境（例如遠端伺服器或容器）中無法運作。請在配有瀏覽器的電腦上執行 Gemini CLI 以進行登入。

  • 必要時重新驗證：如果您的工作階段需要重新授權，請在 Gemini CLI 中執行 /mcp auth wati。

  • 無需 API 金鑰：兩種整合方式均使用 OAuth 驗證，因此您無需在連接設定中新增 Wati API 金鑰。

相關資源

常見問題 (FAQs)

Wati MCP 整合常見問題

1. 什麼是 Wati MCP 伺服器，我可以用它做什麼？

Wati Model Context Protocol (MCP) 伺服器可將相容的 AI 客戶端（如 Meta Muse 和 Google 的 Gemini CLI）連接至您的 Wati 工作區。您可以使用自然語言執行支援的任務，包括搜尋聯絡人、管理對話、傳送已核准的訊息範本、檢視行銷活動統計數據，以及管理支援的區段和 Webhook。可執行的動作取決於您的工作區權限、產品方案和已啟用的頻道。

2. 哪些 Wati 方案支援 MCP，我可以使用哪些 AI 客戶端？

Wati MCP 伺服器適用於 Growth、Pro 和 Business 方案。試用帳戶也可以在試用期間啟用並使用伺服器。您可以將 Wati 連接至 Meta Muse 或 Gemini CLI。Meta Muse 目前僅在美國和加拿大提供；位於這些地區之外的客戶可以使用 Gemini CLI。

3. 我應該使用哪個 Wati MCP 伺服器 URL？

請使用與您的 Wati 工作區區域相符的 URL：

  • 全球：https://mcp.wati.io/mcp

  • 歐盟：https://eu-mcp.wati.io/mcp

設定 AI 客戶端時，請使用對應的區域 URL。

設定與驗證

4. 如何將 Wati MCP 連接至 Meta Muse？

在 Muse 應用程式中，前往 Settings > Connectors > Custom connectors。輸入與您工作區區域對應的 Wati MCP 伺服器 URL。當瀏覽器開啟 Wati 的連接頁面時，選擇 Wati，點選「繼續」，使用現有的 Wati 帳戶登入並核准存取。連接後，您即可使用自然語言與 Wati 工作區互動。

5. 如何將 Wati MCP 連接至 Gemini CLI？

首先安裝 Gemini CLI。然後將 Wati MCP 伺服器新增至 ~/.gemini/settings.json 中的 mcpServers，設定如下：

{
  "mcpServers": {
    "wati": {
      "httpUrl": "https://mcp.wati.io/mcp",
      "oauth": {
        "enabled": true
      }
    }
  }
}

針對歐盟工作區，請將 URL 替換為 https://eu-mcp.wati.io/mcp。儲存設定並重新啟動 Gemini CLI。首次使用時，請透過瀏覽器登入 Wati 並核准存取。

或者，從您的終端機使用下列指令新增伺服器：

gemini mcp add --transport http wati https://mcp.wati.io/mcp

針對歐盟工作區，請改用歐盟 URL。

6. 連接 AI 客戶端時，是否需要 Wati API 金鑰？

不需要。Meta Muse 和 Gemini CLI 皆使用 OAuth 驗證。請透過瀏覽器使用您現有的 Wati 帳戶登入並核准存取。您無需建立新的 Wati 帳戶或在設定中加入 API 金鑰。

疑難排解與權限

7. 如何在 Gemini CLI 中驗證或重新驗證 Wati MCP 連接？

若要驗證連接，請詢問 Gemini CLI："List my Wati contacts."。如果需要重新驗證，請執行：

/mcp auth wati

完成瀏覽器登入程序並在出現提示時核准存取即可。

8. 為什麼 Gemini CLI 無法在 SSH 或無頭環境中完成 Wati OAuth 驗證？

Gemini CLI 會在執行它的同一台電腦上開啟瀏覽器來完成 Wati 的 OAuth 登入。此程序無法在 SSH 或無頭環境（例如遠端伺服器或容器）中運作。請在配有本機瀏覽器的電腦上執行 Gemini CLI 以完成驗證。

9. 為什麼 Wati MCP 動作會傳回錯誤或顯示為無法使用？

可用的工具和動作取決於您已驗證工作階段的 Wati MCP 工具清單、您的工作區角色、產品方案以及已啟用的頻道權限。即使工具可用，使用時若遇到權限或方案相關問題仍會回傳錯誤。針對 Gemini CLI 連接問題，也請確認伺服器 URL 是否與您的工作區區域相符、設定是否位於 mcpServers 下方、JSON 語法是否正確，以及 OAuth 是否已啟用。

相關文章
是否回答了您的問題？