跳转到主要内容

如何将 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 服务器配置添加到 Gemini CLI 设置文件中，从而将 Wati MCP 连接到 Google 的 Gemini CLI。Gemini CLI 使用 OAuth 通过您的浏览器验证您的 Wati 帐户。

Gemini CLI 连接到列在 settings.json 文件中 mcpServers 下的 MCP 服务器。wati 条目使用 httpUrl 通过流式 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.” (向 VIP 客户细分中的联系人发送 order_update 模板。)

  • “How many contacts do we have?” (我们有多少联系人？)

  • “Show me the latest messages in conversations assigned to my team.” (向我显示分配给我团队的对话中的最新消息。)

这些是受支持工作流程的示例。您可用的操作取决于您的帐户和工作区配置。

故障排除和重要说明

在使用任一客户端通过 Wati MCP 时，请记住以下几点：

  • 可用工具可能有所不同： 您帐户可用的工具由身份验证会话的 MCP 服务器工具列表确定。

  • 权限仍然适用： 您的 Wati 工作区角色、产品计划和渠道权限决定了您可以执行的操作。某个工具可能可用，但在使用时会返回与权限或计划相关的错误。

  • 使用正确的服务器 URL： 确保使用与您的 Wati 工作区匹配的全球 (Global) 或欧盟 (EU) 端点。

  • 检查您的配置： 对于 Gemini CLI，请确认服务器条目位于 mcpServers 下，URL 正确，且 JSON 语法有效。

  • 使用带有本地浏览器的机器 (Gemini CLI)： Gemini CLI 会在同一台机器上打开浏览器以完成 Wati OAuth 登录。此过程无法通过 SSH 或在无头环境（如远程服务器或容器）中进行。请在带有浏览器的机器上运行 Gemini CLI 进行登录。

  • 必要时重新进行身份验证： 如果您的会话需要更新授权，请在 Gemini CLI 中运行 /mcp auth wati。

  • 无需 API 密钥： 两种集成均使用 OAuth 身份验证，因此您无需在连接配置中添加 Wati API 密钥。

相关资源

常见问题解答 (FAQ)

Wati MCP 集成常见问题

1. 什么是 Wati MCP 服务器，我可以将其用于什么用途？

Wati Model Context Protocol (MCP) 服务器将兼容的 AI 客户端（如 Meta Muse 和 Google 的 Gemini Command Line Interface (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：

  • 全球 (Global)：https://mcp.wati.io/mcp

  • 欧盟 (EU)：https://eu-mcp.wati.io/mcp

在配置 AI 客户端时，请使用相应的区域 URL。

设置和身份验证

4. 如何将 Wati MCP 连接到 Meta Muse？

在 Muse 应用程序中，转到 Settings（设置）> Connectors（连接器）> Custom connectors（自定义连接器）。输入与您的工作区区域对应的 Wati MCP 服务器 URL。当浏览器打开 Wati 的连接页面时，选择 Wati，点击 Continue（继续），使用现有的 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。

相关文章
这是否解答了您的问题？