How do I install @wasapi/?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does @wasapi/ need an API key?

No required environment variable is listed on this record.

What transport does @wasapi/ use?

@wasapi/ runs locally over stdio.

When was @wasapi/ last checked?

Last checked 2026-11-10. Servidor MCP para Wasapi — gestiona contactos y envía mensajes de WhatsApp desde Claude

@wasapi/ MCP 伺服器

Wasapi MCP Server

Servidor MCP para Wasapi. Gestiona tu cuenta de WhatsApp Business directamente desde Claude, Cursor o cualquier cliente compatible con MCP: envía mensajes, administra contactos y consulta conversaciones usando lenguaje natural.

Instalación

Opción 1 — Conector remoto (recomendado · Claude.ai web, ChatGPT, etc.)

La forma más fácil y recomendada. No requiere instalación: cualquier IA que soporte conectores MCP remotos puede conectarse directamente con tu cuenta de Wasapi.

Endpoint: https://ia.wasapi.io/mcp

En tu cliente de IA (Claude.ai, ChatGPT, etc.), abre la sección de conectores o integraciones.
Agrega un nuevo conector MCP con la URL: https://ia.wasapi.io/mcp
El cliente abrirá el flujo de autorización de Wasapi — inicia sesión con tu cuenta.
Acepta los permisos en la pantalla de consentimiento.
¡Listo! La IA ya puede gestionar tu cuenta de WhatsApp Business.

Para una guía detallada con capturas de pantalla, visita: ayuda.wasapi.io — Conecta Claude, ChatGPT y otras IA con el MCP de Wasapi

Las opciones 2–4 son para instalar el servidor MCP localmente (necesario si usas clientes de escritorio como Claude Desktop o Cursor). Antes de empezar necesitas una API key de Wasapi. Consíguela en app.wasapi.io/account/developer.

Opción 2 — Claude Desktop, sin terminal

La forma más fácil si usas Claude Desktop y no quieres tocar la terminal:

Descarga wasapi-mcp.mcpb (enlace directo, siempre la última versión).
Haz doble click en el archivo — Claude Desktop abre el diálogo de instalación.
Pega tu API key de Wasapi.
Haz click en Instalar.
Activa la extensión: ve a Configuración → Extensiones, busca "Wasapi" y enciéndela (Claude Desktop instala deshabilitadas las extensiones de desarrolladores no verificados).
Abre un chat nuevo y prueba: "Lista mis números de WhatsApp".

Nota: verás un aviso de que el desarrollador "no está verificado por Anthropic". Es lo esperado para extensiones distribuidas fuera del directorio oficial de Anthropic; la fuente es este repositorio.

Opción 3 — Asistente de configuración (recomendada para developers)

No necesitas instalar nada previamente — npx descarga y ejecuta el paquete en un solo paso:

npx -y @wasapi/mcp-server setup --restart

El asistente te guía por todo el proceso:

Abre tu navegador en el panel de Wasapi para que copies tu API key
Valida la key contra el API en vivo
Selecciona un número de WhatsApp por defecto (si tienes alguno)
Detecta tu cliente MCP (Claude Desktop / Cursor) y escribe la configuración
Reinicia la aplicación por ti (con el flag --restart)

npm install -g @wasapi/mcp-server
wasapi-mcp setup --restart

Con la instalación global, el comando wasapi-mcp queda disponible en tu terminal de forma permanente.

Opción 4 — Configuración manual

Si prefieres editar la configuración tú mismo:

Consigue tu API key en app.wasapi.io/account/developer
Agrega este bloque a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "wasapi": {
      "command": "npx",
      "args": ["-y", "@wasapi/mcp-server"],
      "env": {
        "WASAPI_API_KEY": "tu_api_key_aquí",
        "WASAPI_FROM_ID": "12345"
      }
    }
  }
}

Reinicia tu cliente MCP.

Rutas de configuración más comunes:

Cliente	macOS	Linux	Windows
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`	`~/.config/Claude/claude_desktop_config.json`	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor	`~/.cursor/mcp.json`	`~/.cursor/mcp.json`	`%USERPROFILE%\.cursor\mcp.json`

Tip: npx -y @wasapi/mcp-server setup --print-only genera este JSON ya personalizado con tu cuenta, sin escribir ningún archivo.

¿Qué puedo hacer?

Una vez instalado, háblale a tu cliente MCP en lenguaje natural. Algunos ejemplos:

"Lista los primeros 10 contactos de mi cuenta de Wasapi."

"¿Cuántos contactos tengo en total?"

"Crea un contacto: Ana Gómez, teléfono +57 300 123 4567, código de país 57."

"Envíale por WhatsApp a +57 300 123 4567 el mensaje: 'Hola Ana, te confirmo tu cita mañana a las 10am.'"

"Etiqueta al contacto con UUID abc-123 con el label 42."

"Muéstrame los últimos mensajes con el wa_id 573001234567."

"Envíale la plantilla de bienvenida al 573001234567 con el nombre Ana en la variable 1."

"¿Qué flows tengo configurados? Envíale el flow de encuesta al 573001234567."

"¿Cómo le fue a mi última campaña? ¿Cuántos mensajes se entregaron?"

"¿Cuántos mensajes enviamos entre el 1 y el 31 de enero? ¿Y cuántos agentes están en línea ahora?"

"Desactiva el bot para el contacto 573001234567 y dime qué campos personalizados tengo configurados."

"Muéstrame las conversaciones abiertas sin etiqueta y dame el reporte de satisfacción del último mes."

Claude decide cuál de las 62 herramientas usar, pide aclaraciones si algo es ambiguo, y te muestra la respuesta.

Clientes compatibles

Cliente	Cómo conectar	Notas
Claude.ai web	Conector remoto — `https://ia.wasapi.io/mcp` (Opción 1)	Recomendado · sin instalación
ChatGPT	Conector remoto — `https://ia.wasapi.io/mcp` (Opción 1)	Requiere soporte de conectores MCP en tu plan
Claude Desktop	`.mcpb` (Opción 2) o asistente (Opción 3)	Instalación local
Cursor	Asistente (Opción 3) con auto-configuración y reinicio	Instalación local
Claude Code	`setup --print-only` + `claude mcp add` o editar `~/.claude.json`	Instalación local
Windsurf, Zed y otros	`setup --print-only` + pegar el JSON en su configuración	Instalación local

Referencia del asistente (`setup`)

npx -y @wasapi/mcp-server setup [flags]

Flag	Descripción
`--target claude-desktop\|cursor`	Salta el menú de plataforma e instala directo en esa
`--restart`	Reinicia la aplicación destino automáticamente al terminar (solo macOS)
`--print-only`	Imprime el JSON personalizado; nunca escribe en disco
`--local`	(desarrollo) Escribe la ruta local del repo en vez de `npx`

Ejemplos:

# Configurar Claude Desktop y reiniciarlo automáticamente
npx -y @wasapi/mcp-server setup --target claude-desktop --restart

# Obtener el JSON para pegarlo manualmente en Windsurf / Zed / Claude Code
npx -y @wasapi/mcp-server setup --print-only

Variables de entorno

Variable	Requerida	Descripción
`WASAPI_API_KEY`	Sí	Tu API key de Wasapi. Consíguela en app.wasapi.io/account/developer
`WASAPI_FROM_ID`	No	ID del número de WhatsApp por defecto para mensajes salientes. Descúbrelo con la herramienta `list_whatsapp_numbers`
`WASAPI_BASE_URL`	No	Sobrescribe la URL base del SDK (staging / pruebas)
`WASAPI_DEBUG`	No	Ponla en `1` para logs detallados de errores por stderr

Herramientas disponibles

62 herramientas en total.

Contactos (9)

Herramienta	Qué hace	Parámetros clave
`list_contacts`	Lista paginada de contactos con búsqueda opcional	`search`, `labels[]`, `page`
`get_contact`	Obtiene un contacto por su WhatsApp ID	`wa_id`
`create_contact`	Crea un contacto	`first_name` (requerido), `phone`, `country_code`, `last_name`, `email`
`update_contact`	Actualiza un contacto existente	`wa_id` + campos a cambiar
`delete_contact`	Elimina un contacto permanentemente	`wa_id`
`add_label_to_contact`	Agrega una etiqueta	`contact_uuid`, `label_id`
`remove_label_from_contact`	Quita una etiqueta	`contact_uuid`, `label_id`
`assign_agent_to_contact`	Asigna un agente automáticamente	`contact_uuid`
`export_contacts`	Inicia una exportación de todos los contactos	`email_urls[]` (opcional)

Los contactos se identifican por wa_id (un WhatsApp ID en texto), no por ID numérico.

WhatsApp — Mensajería y conversaciones (7)

Herramienta	Qué hace	Parámetros clave
`list_whatsapp_numbers`	Lista los números conectados y sus `from_id`	—
`send_message`	Envía un mensaje de texto	`wa_id`, `message`, `from_id` (opcional)
`send_template`	Envía una plantilla aprobada, con variables y adjunto por URL	`recipients[]`, `template_id`, `contact_type`, `body_vars[]`, `url_file`, `from_id` (opcionales)
`send_attachment`	Envía un archivo desde una URL pública	`wa_id`, `file_url`, `caption`, `filename`, `from_id` (opcionales)
`send_contact_card`	Envía tarjetas de contacto (vCard)	`wa_id`, `contacts[]`, `from_id` (opcional)
`get_conversation`	Obtiene el hilo de mensajes con un contacto	`wa_id`, `from_id`, `page` (opcionales)
`change_conversation_status`	Cambia el estado de la conversación	`wa_id`, `status` (open/hold/closed), `agent_id` (opcional)

WhatsApp — Plantillas (5)

Herramienta	Qué hace	Parámetros clave
`list_whatsapp_templates`	Lista todas las plantillas de la cuenta	—
`get_whatsapp_template`	Detalle de una plantilla	`template_uuid`
`get_template_fields`	Variables que acepta una plantilla (úsalo antes de `send_template`)	`template_uuid`
`list_templates_by_number`	Plantillas disponibles para un número	`from_id`
`sync_meta_templates`	Sincroniza plantillas desde Meta	—

WhatsApp — Flows (6)

Herramienta	Qué hace	Parámetros clave
`list_flows`	Lista los WhatsApp Flows de la cuenta	—
`list_flows_by_number`	Flows disponibles para un número	`from_id` (opcional)
`send_flow`	Envía un Flow interactivo a un contacto	`wa_id`, `message`, `cta`, `screen`, `flow_id`
`get_flow_responses`	Respuestas que enviaron los usuarios por un Flow	`flow_id`, `page` (opcional)
`get_flow_assets`	Detalle y assets de un Flow	`flow_id`
`get_flow_screens`	Pantallas de un Flow (para elegir `screen` en `send_flow`)	`flow_id`

Campañas (2)

Herramienta	Qué hace	Parámetros clave
`list_campaigns`	Lista las campañas de difusión de la cuenta	—
`get_campaign`	Detalle de una campaña con sus envíos por contacto	`campaign_uuid`

Crear, editar o eliminar campañas aún no está disponible (el SDK no lo implementa todavía).

Funnels (3)

Herramienta	Qué hace	Parámetros clave
`list_funnels`	Lista los embudos de venta y sus etapas	—
`search_contact_in_funnels`	Busca un contacto en los embudos	`phone_number` o `contact_uuid`
`move_contact_to_funnel_stage`	Mueve un contacto a otra etapa	`funnel_contact_id`, `to_stage_id`

Métricas (11)

Herramienta	Qué hace	Parámetros clave
`get_online_agents`	Agentes en línea	—
`get_status_contacts`	Contactos por estado	—
`get_total_campaigns`	Total de campañas en un rango	`start_date`, `end_date`
`get_consolidated_conversations`	Conversaciones consolidadas	`start_date`, `end_date`
`get_agent_conversations`	Conversaciones por agente	`start_date`, `end_date`
`get_messages`	Volumen de mensajes	`start_date`, `end_date`
`get_messages_bot`	Mensajes del bot	`start_date`, `end_date`
`get_agent_time_response`	Tiempo de respuesta de un agente	`agent_id`, `start_date`, `end_date`
`get_agent_transferred`	Conversaciones transferidas de un agente	`agent_id`, `start_date`, `end_date`
`get_agent_volume_of_work`	Volumen de trabajo de un agente	`agent_id`, `start_date`, `end_date`
`get_agent_time_in_conversation`	Tiempo en conversación de un agente	`agent_id`, `start_date`, `end_date`

Las métricas con rango de fechas esperan formato YYYY-MM-DD.

Bot (1)

Herramienta	Qué hace	Parámetros clave
`toggle_bot_status`	Activa/desactiva el chatbot para un contacto	`wa_id`, `action` (enable/disable/disable_permanently), `from_id` (opcional)

Workflow (1)

Herramienta	Qué hace	Parámetros clave
`get_workflow_statuses`	Lista cambios de estado de conversaciones, con filtros	`action`, `phone`, `agent_id`, `dates`, `per_page`, `page` (todos opcionales)

Campos personalizados (4)

Herramienta	Qué hace	Parámetros clave
`list_custom_fields`	Lista los campos personalizados	—
`create_custom_field`	Crea un campo	`name`
`update_custom_field`	Renombra un campo	`field_id`, `name`
`delete_custom_field`	Elimina un campo	`field_id`

Usuario (2)

Herramienta	Qué hace	Parámetros clave
`get_current_user`	Datos de la cuenta asociada a la API key	—
`list_users`	Lista los usuarios (agentes) de la cuenta	—

Conversaciones (2)

Herramienta	Qué hace	Parámetros clave
`list_conversations`	Lista conversaciones (paginado por cursor) con filtros	`status`, `query`, `phones`, `labels`, `agents`, `dates`, `per_page` (todos opcionales)
`get_conversations_next_page`	Siguiente página vía cursor	`cursor` + mismos filtros

Etiquetas (6)

Herramienta	Qué hace	Parámetros clave
`list_labels`	Lista las etiquetas	—
`search_labels`	Busca etiquetas por nombre	`name`
`get_label`	Obtiene una etiqueta por ID	`label_id`
`create_label`	Crea una etiqueta	`title`, `color`, `description` (opcional)
`update_label`	Actualiza una etiqueta	`label_id`, `title`, `color`, `description` (opcional)
`delete_label`	Elimina una etiqueta	`label_id`

Reportes (3)

Herramienta	Qué hace	Parámetros clave
`get_agent_performance_report`	Desempeño por agente en un rango	`start_date`, `end_date`, `agent_id` (opcional)
`get_workflow_volume_report`	Volumen de workflow en un rango	`start_date`, `end_date`, `from_id` (opcional)
`get_satisfaction_survey_report`	Encuestas de satisfacción en un rango	`start_date`, `end_date`, `agent_id` (opcional)

¿Cómo actualizo?

Depende de cómo instalaste:

Si usaste el asistente o la configuración manual con `npx`

Tu configuración usa npx -y @wasapi/mcp-server sin versión fijada, así que basta con reiniciar tu cliente MCP (Cmd+Q completo + abrir) — npx resuelve la última versión automáticamente.

Si por caché te sigue sirviendo una versión vieja, fuérzala y reinicia:

npx -y @wasapi/mcp-server@latest --version

Si lo instalaste globalmente

npm install -g @wasapi/mcp-server@latest

y reinicia tu cliente.

Si instalaste la extensión `.mcpb` en Claude Desktop

Las extensiones instaladas fuera del directorio oficial de Anthropic no se actualizan solas:

Descarga el nuevo wasapi-mcp.mcpb (siempre apunta a la última versión)
Haz doble click — Claude Desktop detecta la extensión existente y la actualiza
Tu API key se conserva, pero tenla a mano por si el diálogo la vuelve a pedir
Verifica que la extensión siga activa en Configuración → Extensiones

Puedes ver qué versión tienes instalada en Configuración → Extensiones → Wasapi.

Solución de problemas

"Instalé la extensión pero Claude no ve las herramientas de Wasapi"

Las extensiones de desarrolladores no verificados se instalan deshabilitadas. Ve a Configuración → Extensiones, busca "Wasapi" y actívala. Luego abre un chat nuevo (los chats abiertos antes de activar no recargan las herramientas).

"Ejecuté el asistente pero el MCP no aparece en mi cliente"

Reinicio completo, no solo cerrar la ventana. En macOS: Cmd+Q, no la × roja. O usa el flag --restart.
Verifica la ruta de configuración. El asistente imprime la ruta donde escribió. Confirma que sea la misma que usa tu cliente (tabla de rutas arriba).
Revisa variables de entorno conflictivas que hayan quedado de pruebas anteriores:
```
echo $CLAUDE_DESKTOP_CONFIG
echo $CURSOR_MCP_CONFIG
```
Si alguna imprime una ruta, elimínala (unset CLAUDE_DESKTOP_CONFIG) y vuelve a ejecutar el asistente. El asistente actual te advierte de esto, pero versiones anteriores no.

"Las herramientas devuelven 'API key inválida o sin permisos'"

Tu API key funciona pero no tiene permiso para ese endpoint. Revisa la consola de desarrollador en app.wasapi.io/account/developer y confirma que la key tiene los permisos que necesitas.

"send_attachment falla"

send_attachment espera una URL pública en file_url (no una ruta de archivo local). El tipo de medio se infiere de la extensión de la URL (.jpg/.png → imagen, .mp4 → video, .mp3 → audio; cualquier otra → documento). Asegúrate de que la URL sea accesible públicamente y termine con la extensión correcta.

Activar logs de depuración

WASAPI_DEBUG=1 wasapi-mcp

O agrega "WASAPI_DEBUG": "1" al bloque env de tu configuración MCP. Los logs salen por stderr.

Privacidad

Conector remoto (ia.wasapi.io): las solicitudes pasan por el servidor MCP de Wasapi, que actúa como intermediario OAuth entre tu cliente de IA y la API de Wasapi. No almacena el contenido de tus mensajes ni contactos.
Instalación local (stdio): el servidor MCP corre en tu máquina. Envía tus solicitudes únicamente a la API de Wasapi (https://api-ws.wasapi.io). No transmite datos a los autores del paquete ni a terceros.
No recolecta, almacena ni comparte tus datos por su cuenta. Tu API key se guarda donde tu cliente MCP la configure (en Claude Desktop, en el keychain del sistema operativo).
El tratamiento de los datos de tu cuenta por parte de Wasapi se rige por la Política de Privacidad de Wasapi.
Soporte y contacto: issues del repositorio.

Limitaciones conocidas

Limitación	Detalle
`send_attachment` requiere URL pública	El archivo debe estar accesible por URL; el tipo se infiere de la extensión. No envía archivos locales.

Licencia

ISC

新增此伺服器

用我們的金鑰與日誌託管一份副本。

Server facts

Tools

Questions