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.
Power your agent
Lệnh của chính nhà phát hành. Không phải endpoint của PlugMCP.
Host a copy with our keys and logs.
npx -y @jpabloe/[email protected]Claude Code không có liên kết cài đặt cho lệnh cục bộ. Sao chép lệnh bên dưới và chạy trong terminal.
claude mcp add jpabloe-wasapi-mcp-server -- npx -y @jpabloe/wasapi-mcp-server@0.8.0Chạy trong terminal.
{ "mcpServers": { "jpabloe-wasapi-mcp-server": { "command": "npx", "args": [ "-y", "@jpabloe/[email protected]" ] } }}claude_desktop_config.json
URL từ xa hay một lệnh trên máy của bạn? Hai cách cài đặt khác nhau thế nào
Chạy trên PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
MởTừ nhà phát hành
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.
Servidor MCP para Wasapi — gestiona contactos y envía mensajes de WhatsApp desde Claude
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
https://ia.wasapi.io/mcpPara 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.
La forma más fácil si usas Claude Desktop y no quieres tocar la terminal:
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.
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:
--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.
Si prefieres editar la configuración tú mismo:
{
"mcpServers": {
"wasapi": {
"command": "npx",
"args": ["-y", "@wasapi/mcp-server"],
"env": {
"WASAPI_API_KEY": "tu_api_key_aquí",
"WASAPI_FROM_ID": "12345"
}
}
}
}
Rutas de configuración más comunes:
Tip:
npx -y @wasapi/mcp-server setup --print-onlygenera este JSON ya personalizado con tu cuenta, sin escribir ningún archivo.
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-123con 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.
setup)npx -y @wasapi/mcp-server setup [flags]
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
62 herramientas en total.
Los contactos se identifican por wa_id (un WhatsApp ID en texto), no por ID numérico.
Crear, editar o eliminar campañas aún no está disponible (el SDK no lo implementa todavía).
Las métricas con rango de fechas esperan formato YYYY-MM-DD.
Depende de cómo instalaste:
npxTu 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
npm install -g @wasapi/mcp-server@latest
y reinicia tu cliente.
.mcpb en Claude DesktopLas extensiones instaladas fuera del directorio oficial de Anthropic no se actualizan solas:
Puedes ver qué versión tienes instalada en Configuración → Extensiones → 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).
Cmd+Q, no la × roja. O usa el flag --restart.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.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 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.
WASAPI_DEBUG=1 wasapi-mcp
O agrega "WASAPI_DEBUG": "1" al bloque env de tu configuración MCP. Los logs salen por stderr.
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.https://api-ws.wasapi.io). No transmite datos a los autores del paquete ni a terceros.ISC
Servidor MCP para Wasapi — gestiona contactos y envía mensajes de WhatsApp desde Claude
{ "mcpServers": { "jpabloe-wasapi-mcp-server": { "command": "npx", "args": [ "-y", "@jpabloe/[email protected]" ] } }}Công cụ
Chưa có danh sách công cụ. Máy chủ từ xa sẽ có danh sách sau lần kiểm tra tình trạng đầu tiên.
Câu hỏi thường gặp
Sao chép cấu hình stdio cho Cursor, Claude Desktop, Claude Code hoặc VS Code trên trang này. Cấu hình dùng bản cài đặt của nhà phát hành, không phải proxy của PlugMCP.
Bản ghi này không liệt kê biến môi trường bắt buộc nào.
@jpabloe/wasapi chạy cục bộ qua stdio.
Kiểm tra lần cuối: 2026-11-18. Servidor MCP para Wasapi — gestiona contactos y envía mensajes de WhatsApp desde Claude