El MCP de Wasapi es un conector oficial que permite a herramientas de inteligencia artificial como Claude acceder directamente a tu cuenta de Wasapi y administrar tus líneas WhatsApp. Busca contactos, envía mensajes y consulta reportes en lenguaje natural, sin abrir la plataforma.

Cómo funciona

Conecta — Agrega el MCP de Wasapi a tu IA favorita. Solo necesitas el endpoint y tu cuenta de Wasapi.
Pide — Escríbele a la IA en lenguaje natural: "Envíale este mensaje a Juan" o "¿Cuántas conversaciones tengo abiertas?"
Obtén resultados — La IA ejecuta la acción en Wasapi y te muestra el resultado directamente en la conversación.

¿Qué puedes hacer?

Contactos: buscar, crear, editar y eliminar; asignar etiquetas y agentes
Mensajes: enviar texto, archivos adjuntos, plantillas de WhatsApp y tarjetas de contacto
Conversaciones: ver historial, navegar páginas, cambiar estado
Campañas: listar y consultar el detalle de cada campaña
Embudos: ver etapas, mover contactos entre ellas
Etiquetas y campos personalizados: crear, editar y eliminar
Métricas y reportes: volumen de mensajes, desempeño de agentes, encuestas de satisfacción y más
Bot: activar o desactivar el bot por número de WhatsApp

Prerrequisitos

Una cuenta activa en Wasapi
Acceso a Claude.ai, Claude Desktop, ChatGPT, Cursor u otro cliente compatible con MCP

El endpoint del MCP es: https://ia.wasapi.io/mcp

Cómo conectar

Claude.ai (web)

Abre claude.ai e inicia sesión.
Haz clic en el ícono de herramientas en el panel de conversación, o ve a Settings → Integrations.
Selecciona Add integration → Custom.
Ingresa el endpoint: https://ia.wasapi.io/mcp
Cuando se abra la ventana de autorización, ingresa tu cuenta de Wasapi y acepta el acceso.
Listo. La integración queda guardada para todas tus conversaciones.

Claude Desktop

Abre Claude Desktop.
Ve a Settings → Connectors → Add custom Connector.
Ingresa:
- Nombre: Wasapi
- URL: https://ia.wasapi.io/mcp
Haz clic en Add y aprueba la pantalla de consentimiento en tu navegador.
Para verificar: abre una nueva conversación y escribe "Lista mis números de WhatsApp".

ChatGPT

Los conectores MCP personalizados en ChatGPT requieren el modo desarrollador, que expone todas las herramientas del MCP. Actívalo solo para servidores en los que confíes.

Paso 1 — Activar el modo desarrollador (una sola vez)

Abre ChatGPT → Settings → Connectors → Advanced.
Activa Developer mode.
Lee y acepta la advertencia sobre herramientas con permisos de escritura.

Paso 2 — Agregar el conector de Wasapi

Ve a Settings → Apps → Advanced settings y haz clic en Create app.
Ingresa:
- Name: Wasapi
- MCP Server URL: https://ia.wasapi.io/mcp
- Authentication: OAuth
Guarda y aprueba la pantalla de consentimiento de Wasapi en tu navegador.

Paso 3 — Usarlo en un chat

Inicia una nueva conversación.
Haz clic en el ícono + (o Tools) → Developer mode → activa Wasapi.
Escribe tu pregunta.
Para verificar: "Lista mis números de WhatsApp".

Cursor

Ve a Cursor → Settings → MCP.
Haz clic en Add new MCP server.
Nombra el servidor wasapi e ingresa la URL: https://ia.wasapi.io/mcp
Guarda. Cursor detectará las herramientas disponibles automáticamente.

Uso local (stdio)

Si prefieres ejecutar el servidor MCP localmente en tu máquina. Requiere Node.js 18 o superior.

npx @wasapi/mcp-server setup

Este comando abre un asistente de configuración que te guía para obtener tu API key y configurar el cliente automáticamente.

💡 Tip: El conector remoto usa OAuth — no necesitas API key. Solo inicia sesión con tu cuenta de Wasapi una vez y el cliente recuerda el acceso.

Referencia completa de herramientas

Contactos

Herramienta	Descripción
`list_contacts`	Lista contactos con filtros opcionales
`get_contact`	Obtiene el detalle de un contacto por ID o teléfono
`create_contact`	Crea un nuevo contacto
`update_contact`	Actualiza los datos de un contacto
`delete_contact`	Elimina un contacto
`add_label_to_contact`	Agrega una etiqueta a un contacto
`remove_label_from_contact`	Quita una etiqueta de un contacto
`assign_agent_to_contact`	Asigna un agente responsable a un contacto

Mensajes y WhatsApp

Herramienta	Descripción
`send_message`	Envía un mensaje de texto
`send_attachment`	Envía un archivo adjunto (imagen, documento, audio, etc.)
`send_template`	Envía una plantilla de mensaje aprobada por Meta
`send_contact_card`	Envía una tarjeta de contacto por WhatsApp
`list_whatsapp_numbers`	Lista los números de WhatsApp conectados
`list_whatsapp_templates`	Lista todas las plantillas disponibles
`list_templates_by_number`	Lista plantillas disponibles para un número específico
`get_whatsapp_template`	Obtiene el detalle de una plantilla
`get_template_fields`	Obtiene los campos variables de una plantilla
`sync_meta_templates`	Sincroniza las plantillas desde Meta

Conversaciones

Herramienta	Descripción
`list_conversations`	Lista las conversaciones con filtros opcionales
`get_conversation`	Obtiene el historial de una conversación
`get_conversations_next_page`	Navega a la siguiente página de conversaciones
`change_conversation_status`	Cambia el estado de una conversación

Campañas

Herramienta	Descripción
`list_campaigns`	Lista todas las campañas
`get_campaign`	Obtiene el detalle de una campaña

Embudos

Herramienta	Descripción
`list_funnels`	Lista los embudos configurados
`search_contact_in_funnels`	Busca en qué etapa de un embudo está un contacto
`move_contact_to_funnel_stage`	Mueve un contacto a una etapa del embudo

Etiquetas

Herramienta	Descripción
`list_labels`	Lista todas las etiquetas
`get_label`	Obtiene el detalle de una etiqueta
`search_labels`	Busca etiquetas por nombre
`create_label`	Crea una nueva etiqueta
`update_label`	Edita una etiqueta existente
`delete_label`	Elimina una etiqueta

Campos personalizados

Herramienta	Descripción
`list_custom_fields`	Lista los campos personalizados
`get_custom_field`	Obtiene el detalle de un campo
`create_custom_field`	Crea un nuevo campo personalizado
`update_custom_field`	Edita un campo personalizado
`delete_custom_field`	Elimina un campo personalizado

Métricas

Herramienta	Descripción
`get_messages`	Total de mensajes enviados y recibidos
`get_messages_bot`	Mensajes gestionados por el bot
`get_consolidated_conversations`	Vista consolidada de conversaciones
`get_status_contacts`	Estado de los contactos
`get_online_agents`	Agentes activos en tiempo real
`get_total_campaigns`	Total de campañas
`get_agent_conversations`	Conversaciones por agente
`get_agent_time_in_conversation`	Tiempo promedio por conversación por agente
`get_agent_time_response`	Tiempo de primera respuesta por agente
`get_agent_transferred`	Conversaciones transferidas por agente
`get_agent_volume_of_work`	Volumen de trabajo por agente

Reportes

Herramienta	Descripción
`get_agent_performance_report`	Reporte de desempeño de agentes
`get_workflow_volume_report`	Reporte de volumen por workflow
`get_satisfaction_survey_report`	Reporte de encuestas de satisfacción

Bot y otros

Herramienta	Descripción
`toggle_bot_status`	Activa o desactiva el bot de un número
`get_workflow_statuses`	Obtiene los estados de workflow disponibles
`get_current_user`	Obtiene la información del usuario autenticado

Preguntas frecuentes

¿Necesito una API key para usar el conector remoto?
No. El conector remoto usa OAuth: la primera vez te pide iniciar sesión con tu cuenta de Wasapi y autorizar el acceso. No necesitas generar ni copiar ninguna API key.

¿Puedo conectar múltiples cuentas de Wasapi?
Actualmente cada cliente de IA se conecta a una sola cuenta de Wasapi a la vez.

¿La conexión persiste entre sesiones?
Sí. Una vez autorizado, el cliente recuerda el acceso. No necesitas autorizarte de nuevo cada vez que abres una nueva conversación.

¿Cómo revoco el acceso?
Puedes revocar el acceso en cualquier momento desde la configuración de tu cuenta de Wasapi. Tras la revocación, la IA perderá acceso hasta que vuelvas a autorizar.

¿El MCP puede leer mis mensajes de WhatsApp?
El MCP accede al historial de conversaciones que ya está almacenado en Wasapi. No tiene acceso directo a WhatsApp — solo opera sobre los datos que Wasapi ya tiene en su plataforma.

¿Cuál es la diferencia entre el conector remoto y el uso local?
El conector remoto (https://ia.wasapi.io/mcp) funciona desde cualquier cliente sin instalar nada, usando OAuth. El uso local instala el servidor en tu máquina con npx @wasapi/mcp-server y requiere una API key; es ideal si necesitas usarlo offline o en entornos controlados.

Resolución de problemas

Problema	Solución
La IA dice que no puede conectarse	Verifica que el endpoint sea exactamente `https://ia.wasapi.io/mcp`
Error al autorizar la conexión	Asegúrate de haber iniciado sesión en Wasapi antes de conectar la integración
Las herramientas no aparecen en el cliente	Desconecta y vuelve a conectar la integración desde la configuración del cliente
La sesión expiró	Vuelve a autorizar la integración. El acceso expira por inactividad prolongada
Un mensaje no se envía	Verifica que el número de teléfono sea válido con código de país y que tengas un número de WhatsApp activo en Wasapi
Error "Couldn't register with Wasapi's sign-in service"	Intenta de nuevo. Si persiste, usa la opción "Add an OAuth Client ID" en la configuración del conector

Conecta Claude, ChatGPT y otras IA con el MCP de Wasapi