Cómo conectar WATI a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → WATI, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

WATI + Cursor

Gestiona la bandeja de WhatsApp Business de WATI desde tu IA: lista las plantillas aprobadas, busca, añade y actualiza contactos, lee el historial de chat de un contacto, asigna conversaciones a miembros del equipo y envía un mensaje de plantilla. Los envíos de sesión, interactivos y masivos vienen desactivados al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

WATI_API_ENDPOINT, WATI_ACCESS_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas un workspace de WATI con el plan Growth o superior, y su API Endpoint y Access Token.

1. Inicia sesión en WATI y abre API Docs en el menú (en los workspaces más nuevos, Connector → API).
2. Copia el API Endpoint en WATI_API_ENDPOINT tal como lo muestra WATI, por ejemplo https://live-mt-server.wati.io/123456, sin /api/v1 al final. El número final es el id de tu workspace (tenant).
3. Copia el Access Token en WATI_ACCESS_TOKEN sin la palabra Bearer: WATI lo muestra como Bearer eyJ..., así que pega solo la parte que empieza en eyJ.
4. Instala el conector y ejecuta wati_list_message_templates: lista tus plantillas de WhatsApp y confirma que el endpoint y el token van juntos.

Solo API v1: el conector trabaja con la API v1 de WATI. La API v3, más reciente, no acepta el token de la pantalla API Docs, así que sus funciones adicionales (etiquetas y estado de las conversaciones, canales, campañas, créditos) no forman parte de este conector. El token se envía solo a tu API Endpoint y deja de funcionar cuando cambia la contraseña de la cuenta.

Qué lee: tus plantillas de mensaje con categoría, estado (APPROVED, PENDING, REJECTED), idioma, encabezado, cuerpo con sus variables, pie y botones; tus contactos con número de WhatsApp, nombre, opt-in, permiso de difusión, atributos personalizados y equipos, filtrados por nombre, por atributo o por fecha de creación; y el historial de chat con un contacto, empezando por lo más reciente, con estado de entrega y eventos de operador y de ticket.

Números: los números de WhatsApp van en formato internacional con el prefijo del país y sin + ni espacios, por ejemplo 34612345678. Cuando una herramienta pide un contacto también puedes pasar un id de contacto de WATI. Si tu workspace tiene varios números de WhatsApp, la IA puede elegir qué número de empresa usar.

Plantillas y la ventana de 24 horas: fuera de las 24 horas siguientes al último mensaje del cliente, WhatsApp solo permite plantillas aprobadas, y solo se pueden enviar plantillas con estado APPROVED. Dentro de la ventana se permiten texto libre y botones de respuesta. Meta cobra los mensajes de plantilla por conversación.

Pregunta antes de cada cambio: wati_send_template_message envía una plantilla a un número y el cliente la recibe al instante; wati_add_contact añade un contacto con nombre y atributos personalizados; wati_update_contact_attributes cambia atributos como el estado del pedido o la fase del lead y deja los demás como están. Antes de cada uno, la IA te muestra el número, la plantilla y los valores o el cambio, y espera tu sí. wati_assign_operator pasa un chat a un miembro del equipo por su email, o de vuelta al bot, y solo cambia la bandeja compartida.

Desactivadas al instalar: wati_send_session_message (texto libre en una sesión abierta de 24 horas), wati_send_interactive_buttons (un mensaje con hasta tres botones de respuesta) y wati_send_template_broadcast (una plantilla a hasta 1.000 números por llamada, y a cada destinatario le llega y se le cobra). Llegan directamente a los clientes, así que un administrador las activa a propósito, y aun así la IA confirma contigo cada envío.

Límites: unas 10 peticiones cada 10 segundos para contactos y mensajes, y de 30 a 100 envíos de plantillas cada 10 segundos según tu plan. Un 429 significa esperar unos segundos y volver a intentarlo.

Errores comunes: 401 significa que el token es incorrecto, ha caducado o todavía empieza por Bearer. 403 significa que el token o tu plan no permiten la llamada. 404 suele indicar un API Endpoint incorrecto. WATI también responde a algunos fallos con HTTP 200 y result false, por ejemplo un número no válido o una plantilla no aprobada: el conector los convierte en errores con el texto de WATI. Un contacto que nunca ha chateado contigo no tiene historial (Can't find Conversation). Un envío correcto significa que WATI aceptó el mensaje, no que se haya entregado.

El conector no usa la API v3, no crea ni borra plantillas, no programa campañas ni envíos desde CSV, no envía archivos multimedia, documentos, mensajes de lista ni de CTA, no crea chatbots ni segmentos, no configura webhooks, no gestiona WhatsApp Pay y no renueva el token.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de WATI.

Herramientas disponibles

Ejemplos de prompts

• "Busca el contacto Marta García y enséñame sus últimos mensajes de WhatsApp con nosotros."
• "¿Cuáles de nuestras plantillas aprobadas sirven para avisar de que un pedido ha salido, y qué valores necesitan?"
• "Envía la plantilla order_shipped al 34612345678 con el nombre Javier y el número de pedido 4512. Enséñamelo todo antes de enviarla."
• "Pon lead_stage en qualified para el 34655123456 y asigna el chat a [email protected]."
• "Lista los contactos creados hoy cuya ciudad sea Valencia."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT