Ir al contenido principal

Cómo conectar Wati MCP a Meta Muse o Gemini CLI

Resumen

Conecte el servidor Wati Model Context Protocol (MCP) a Meta Muse o a la interfaz de línea de comandos (CLI) de Gemini de Google para trabajar con su espacio de trabajo de Wati utilizando lenguaje natural. Una vez conectado, puede usar clientes de IA compatibles para gestionar contactos, conversaciones, mensajes, plantillas, campañas y otras funciones admitidas.

Esta guía le explica cómo conectar Wati MCP a Meta Muse y a la CLI de Gemini mediante autenticación OAuth. Puede iniciar sesión con su cuenta de Wati existente sin necesidad de crear una cuenta nueva ni añadir una clave API a su configuración.

Nota: El servidor Wati MCP está disponible para los clientes de los planes Growth, Pro y Business de Wati. Si actualmente utiliza una cuenta de prueba, también puede habilitar y usar el servidor Wati MCP durante su período de prueba.

Instrucciones

Elija el cliente de IA que desea conectar a Wati y siga los pasos en la sección correspondiente.

Utilice la URL del servidor MCP que coincida con la región de su espacio de trabajo de Wati:

Región del espacio de trabajo

URL del servidor MCP

Global

https://mcp.wati.io/mcp

UE

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

Parte 1: Conectar Wati MCP a Meta Muse

Disponibilidad: Meta Muse actualmente solo está disponible en Estados Unidos y Canadá. Si se encuentra fuera de estas regiones, conecte Wati a través de la CLI de Gemini (consulte la Parte 2).

Conecte Wati a Meta Muse directamente desde la aplicación Muse. Iniciará sesión en su cuenta de Wati existente y autorizará el acceso a través del flujo de autenticación OAuth de Wati.

Pasos para conectar

1. Abra Conectores (Connectors)

  • Abra la aplicación Muse, vaya a Configuración (Settings) y seleccione Conectores (Connectors).

2. Abra conectores personalizados

  • Desplácese hasta la sección Personalizado (Custom) y seleccione Conectores personalizados (Custom connectors).

3. Ingrese la URL del servidor Wati MCP

  • En la pantalla Añadir conector personalizado (Add custom connector), ingrese la URL del servidor MCP para la región de su espacio de trabajo según la tabla anterior.

4. Elija Wati

  • Su navegador abrirá la página de conexión de Wati. Indicará que agent.meta.ai quiere conectarse a Wati y Astra. Seleccione Wati y haga clic en Continuar (Continue).

5. Inicie sesión y autorice el acceso

  • En la página de inicio de sesión de Wati, acceda con su cuenta de Wati existente. Revise la solicitud de autorización y apruebe el acceso para completar la conexión.

No necesita crear una cuenta nueva ni generar una clave API.

6. Comience a usar Wati en Muse

  • Una vez completada la conexión, pídale a Muse que realice tareas compatibles en su espacio de trabajo de Wati usando lenguaje natural.

Parte 2: Conectar Wati MCP a la CLI de Gemini

Puede conectar Wati MCP a la CLI de Gemini de Google añadiendo la configuración del servidor Wati a su archivo de configuración de la CLI de Gemini. La CLI de Gemini utiliza OAuth para autenticar su cuenta de Wati a través de su navegador.

La CLI de Gemini se conecta a los servidores MCP listados bajo mcpServers en su archivo settings.json. La entrada wati utiliza httpUrl para llegar al servidor Wati MCP a través de HTTP transmitible, y oauth.enabled permite que la CLI de Gemini inicie su sesión a través del navegador, por lo que no es necesario añadir una clave API al archivo. Una vez autorizado, la CLI de Gemini descubre las herramientas de Wati disponibles para su cuenta. Para ver más opciones de configuración, consulte la documentación del servidor MCP de la CLI de Gemini.

Prerrequisito

Instale la CLI de Gemini antes de comenzar. Siga la guía oficial de instalación y configuración de la CLI de Gemini.

Pasos para conectar

Consejo: Si prefiere no editar el JSON, ejecute el siguiente comando en su terminal en lugar de seguir los pasos 1 y 2, y luego continúe desde el paso 3:

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

Para los espacios de trabajo de la UE, utilice la URL de la UE de la tabla anterior.

1. Abra el archivo de configuración de la CLI de Gemini

  • Abra ~/.gemini/settings.json en su editor de texto preferido.

    Si el archivo no existe, créelo.

2. Añada la configuración del servidor Wati MCP

Debajo de mcpServers, añada la siguiente configuración:

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

Para los espacios de trabajo de la UE, utilice la URL de la UE de la tabla anterior.

Si su archivo de configuración ya contiene otros servidores MCP, añada la entrada wati dentro del objeto mcpServers existente. Mantenga la configuración existente intacta y asegúrese de que la sintaxis JSON sea válida.

3. Reinicie la CLI de Gemini

  • Cierre y reinicie la CLI de Gemini para que cargue la configuración actualizada.

4. Inicie sesión en Wati

  • Cuando utilice la conexión por primera vez, la CLI de Gemini abrirá su navegador para iniciar el flujo de inicio de sesión OAuth de Wati. Inicie sesión con su cuenta de Wati existente y apruebe el acceso solicitado.

5. Vuelva a la terminal

  • Una vez completada la autorización, vuelva a la CLI de Gemini y continúe utilizando el servidor Wati conectado.

6. Autentíquese de nuevo si es necesario

  • Si necesita iniciar sesión de nuevo, ejecute el siguiente comando en la CLI de Gemini:

/mcp auth wati

7. Verifique la conexión

  • Pídale a la CLI de Gemini que realice una tarea sencilla, como:

List my Wati contacts.

Si la conexión y los permisos están configurados correctamente, la CLI de Gemini debería poder recuperar la información de contacto admitida desde su espacio de trabajo de Wati.

¿Qué puede hacer con Wati MCP?

Dependiendo de los permisos de su espacio de trabajo, plan de producto y canales habilitados, puede utilizar Muse o la CLI de Gemini para realizar tareas como:

  • Contactos: Buscar, listar, añadir y actualizar contactos; gestionar atributos de contacto; ver recuentos de contactos; y asignar contactos a equipos.

  • Conversaciones: Recuperar mensajes, gestionar etiquetas y el estado de la conversación, asignar conversaciones y transferir conversaciones a un operador.

  • Mensajería: Enviar mensajes de texto y archivos, utilizar botones y listas interactivas, y enviar plantillas de mensaje aprobadas.

  • Campañas: Trabajar con difusiones, ver estadísticas de campañas, estimar costes de envío y comprobar los créditos disponibles.

  • Configuración del espacio de trabajo: Gestionar segmentos, canales, webhooks y plantillas de mensajes admitidos.

  • Instagram: Utilizar flujos de trabajo de Instagram compatibles cuando la función esté habilitada para su espacio de trabajo.

Ejemplos de prompts

Después de conectar Wati a cualquiera de los clientes, pruebe a preguntar:

  • "Find every conversation tagged billing from last week."

  • "Send the order_update template to contacts in the VIP Customers segment."

  • "How many contacts do we have?"

  • "Show me the latest messages in conversations assigned to my team."

Estos son ejemplos de flujos de trabajo admitidos. Las acciones disponibles para usted dependen de su cuenta y de la configuración de su espacio de trabajo.

Solución de problemas y notas importantes

Tenga en cuenta los siguientes puntos al utilizar Wati MCP con cualquiera de los clientes:

  • Las herramientas disponibles pueden variar: Las herramientas disponibles para su cuenta vienen determinadas por la lista de herramientas del servidor MCP para su sesión autenticada.

  • Los permisos siguen vigentes: Su rol en el espacio de trabajo de Wati, su plan de producto y los permisos de canal determinan qué acciones puede realizar. Una herramienta puede estar disponible, pero devolver un error relacionado con permisos o con el plan cuando la utilice.

  • Utilice la URL del servidor correcta: Asegúrese de utilizar el endpoint global o de la UE que coincida con su espacio de trabajo de Wati.

  • Compruebe su configuración: Para la CLI de Gemini, confirme que la entrada del servidor está bajo mcpServers, la URL es correcta y la sintaxis JSON es válida.

  • Utilice una máquina con un navegador local (CLI de Gemini): La CLI de Gemini abre un navegador en la misma máquina para completar el inicio de sesión OAuth de Wati. Esto no funciona a través de SSH ni en entornos headless, como servidores remotos o contenedores. Ejecute la CLI de Gemini en una máquina con navegador para iniciar sesión.

  • Reautentíquese si es necesario: Si su sesión requiere una reautorización, ejecute /mcp auth wati en la CLI de Gemini.

  • No se requiere clave API: Ambas integraciones utilizan autenticación OAuth, por lo que no es necesario añadir una clave API de Wati a la configuración de la conexión.

Recursos relacionados

Preguntas frecuentes (FAQs)

Preguntas frecuentes sobre la integración de Wati MCP

1. ¿Qué es el servidor Wati MCP y para qué puedo usarlo?

El servidor Wati Model Context Protocol (MCP) conecta clientes de IA compatibles, como Meta Muse y la interfaz de línea de comandos (CLI) de Gemini de Google, a su espacio de trabajo de Wati. Puede utilizar lenguaje natural para realizar tareas admitidas, incluyendo la búsqueda de contactos, la gestión de conversaciones, el envío de plantillas de mensajes aprobadas, la visualización de estadísticas de campañas y la gestión de segmentos y webhooks admitidos. Las acciones disponibles dependen de los permisos de su espacio de trabajo, su plan de producto y los canales habilitados.

2. ¿Qué planes de Wati son compatibles con MCP y qué clientes de IA puedo usar?

El servidor Wati MCP está disponible en los planes Growth, Pro y Business. Las cuentas de prueba también pueden habilitar y utilizar el servidor durante el período de prueba. Puede conectar Wati a Meta Muse o a la CLI de Gemini. Meta Muse actualmente solo está disponible en Estados Unidos y Canadá; los clientes fuera de estas regiones pueden utilizar la CLI de Gemini.

3. ¿Qué URL del servidor Wati MCP debo usar?

Utilice la URL que coincida con la región de su espacio de trabajo de Wati:

  • Global: https://mcp.wati.io/mcp

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

Utilice la URL regional adecuada al configurar su cliente de IA.

Configuración y autenticación

4. ¿Cómo conecto Wati MCP a Meta Muse?

En la aplicación Muse, vaya a Configuración > Conectores > Conectores personalizados. Ingrese la URL del servidor Wati MCP para la región de su espacio de trabajo. Cuando su navegador abra la página de conexión de Wati, seleccione Wati, haga clic en Continuar, inicie sesión con su cuenta de Wati existente y apruebe el acceso. Una vez conectado, puede utilizar lenguaje natural para interactuar con su espacio de trabajo de Wati.

5. ¿Cómo conecto Wati MCP a la CLI de Gemini?

Primero, instale la CLI de Gemini. Luego, añada el servidor Wati MCP a ~/.gemini/settings.json bajo mcpServers usando la siguiente configuración:

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

Para los espacios de trabajo de la UE, sustituya la URL por https://eu-mcp.wati.io/mcp. Guarde la configuración y reinicie la CLI de Gemini. En el primer uso, inicie sesión en Wati a través del navegador y apruebe el acceso.

Alternativamente, añada el servidor desde su terminal usando:

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

Para los espacios de trabajo de la UE, utilice la URL de la UE en su lugar.

6. ¿Necesito una clave API de Wati para conectar un cliente de IA?

No. Tanto Meta Muse como la CLI de Gemini utilizan autenticación OAuth. Inicie sesión con su cuenta de Wati existente a través del navegador y apruebe el acceso. No necesita crear una cuenta de Wati nueva ni añadir una clave API a su configuración.

Solución de problemas y permisos

7. ¿Cómo verifico o reautentico la conexión Wati MCP en la CLI de Gemini?

Para verificar la conexión, pregunte a la CLI de Gemini: "List my Wati contacts." Si necesita autenticarse de nuevo, ejecute:

/mcp auth wati

Complete el inicio de sesión a través del navegador y apruebe el acceso cuando se le solicite.

8. ¿Por qué la CLI de Gemini no puede completar la autenticación OAuth de Wati a través de SSH o en un entorno headless?

La CLI de Gemini abre un navegador en la misma máquina donde se está ejecutando para completar el inicio de sesión OAuth de Wati. Este proceso no funciona a través de SSH ni en entornos headless, como servidores remotos o contenedores. Ejecute la CLI de Gemini en una máquina con un navegador local para completar la autenticación.

9. ¿Por qué una acción de Wati MCP devuelve un error o aparece como no disponible?

Las herramientas y acciones disponibles dependen de la lista de herramientas de Wati MCP para su sesión autenticada, su rol en el espacio de trabajo, su plan de producto y los permisos de sus canales habilitados. Una herramienta puede estar disponible, pero devolver un error relacionado con permisos o con el plan cuando la utilice. Para problemas de conexión con la CLI de Gemini, verifique también que la URL del servidor coincida con la región de su espacio de trabajo, que la configuración esté bajo mcpServers, que la sintaxis JSON sea válida y que OAuth esté habilitado.

Artículos relacionados
¿Ha quedado contestada tu pregunta?