Kapso MCP: dale un WhatsApp real a tu agente (2 pasos + chequeo de criterio)

Aviso por delante, porque es lo honesto: yo no he montado Kapso en producción con clientes reales. Esto no es un tutorial de “lo tengo puesto y lo uso para X”. Es lo que saco de las docs públicas + el criterio que aplicaría antes de darle a un agente un número de WhatsApp de verdad. Curación honesta, no testimonio.

El contexto: Kapso se define como “la API de WhatsApp para developers”, y una de sus piezas es darle a tu agente de IA un número de WhatsApp real (leer y enviar mensajes, plantillas, webhooks) a través de un servidor MCP. Lo anunció Andrés Matte (@andresmatte) en X el 2026-05-20. Docs oficiales → docs.kapso.ai/docs/whatsapp/mcp.

Los 2 pasos para conectarlo

Según las docs oficiales de Kapso, conectarlo a Claude Code / Codex son dos pasos. Importante: no es un paquete de npm, es un MCP remoto por HTTP — te conectas a su servidor (api.kapso.ai/mcp) autenticándote con tu API key de proyecto.

Paso 1 — Añades el MCP server. Exportas tu API key de Kapso y registras el servidor en tu cliente. En Claude Code, verbatim de las docs:

export KAPSO_API_KEY="tu_api_key_de_proyecto"

claude mcp add --transport http kapso https://api.kapso.ai/mcp \
  --header "Authorization: Bearer $KAPSO_API_KEY"

Si tu setup usa X-API-Key en vez de Authorization, cambia la cabecera a "X-API-Key: $KAPSO_API_KEY". La fuente que manda siempre son las docs: docs.kapso.ai/docs/whatsapp/mcp.

Paso 2 — Le pides un número de WhatsApp. Con el MCP conectado, el agente expone herramientas como whatsapp_numbers (con la acción start_setup) y setup_links: le dices en lenguaje natural que inicie el alta y te genera un enlace de setup para aprovisionar/conectar el número. A partir de ahí puede leer y mandar mensajes por él. (Truco útil: cualquier herramienta del MCP acepta action: "help" para que te diga qué parámetros pide.)

¿Es gratis? Sí, para probarlo

Kapso tiene un plan Free real: incluye 1 número de WhatsApp y 2.000 mensajes/mes, más un número sandbox gratis (compartido pero aislado) pensado para testing y desarrollo. Para empezar y trastear, no pagas nada.

La letra pequeña honesta, para que decidas con criterio:

• Meta cobra aparte. Los mensajes de plantilla los factura Meta directamente a tu cuenta de WhatsApp Business, según categoría y país. Los mensajes normales dentro de la ventana de 24h de atención al cliente son gratis.
• Producción ≠ sandbox. Un número dedicado de producción pide un pequeño depósito que va directo a tus créditos del proyecto.

Resumen: gratis para empezar y probar; en producción a escala, Meta y el número dedicado tienen coste. (Detalle en docs.kapso.ai/docs/whatsapp/pricing-faq.)

Y ahí está el truco de por qué esto es a la vez lo más fácil y lo más peligroso que puedes montar ahora mismo: en dos pasos tu agente pasa de “vive en tu terminal” a “puede escribirle a gente real”.

El chequeo: 3 preguntas antes de darle un número a tu agente

Esta es la parte que de verdad importa. Antes de conectar nada, contéstate estas tres. Si alguna falla, no le des el número todavía.

1. ¿Quién recibe los mensajes que manda — tú o terceros?

• ✅ Te avisa a ti: vigila un deploy, un log, un cron, un pago, y te escribe a tu WhatsApp cuando pasa algo. No se lía con nadie.
• ❌ Le escribe a clientes / desconocidos: ahí el agente está hablando por ti con gente real. Otro nivel de riesgo.

2. ¿Hay aprobación humana antes de enviar?

• ✅ El agente propone el mensaje y tú das al botón. Tú sigues siendo el último filtro.
• ❌ Envía solo, sin que nadie lo lea antes. Un agente con número y autonomía total mandando mensajes es donde se lía de verdad.

3. ¿Qué pasa si el agente alucina un mensaje?

• ✅ Si el peor caso es “me llega a mí un aviso raro”, asumible. Lo lees, te ríes, sigues.
• ❌ Si el peor caso es “le manda una barbaridad a un cliente, o confirma algo que no debía”, eso no se deshace. El daño ya está enviado.

Regla rápida para leer las tres: una cosa es que te avise a ti, otra muy distinta que hable por ti.

Para qué sí / para qué no

Caso	¿Adelante?
Agente que te avisa a ti de algo que vigila (deploy, log, precio, pago)	✅ Sí, es el caso cómodo
Notificaciones internas, alertas, recordatorios a tu propio número	✅ Sí
Agente que responde a clientes sin que nadie lo supervise	❌ No, por aquí yo no pasaría
Cualquier flujo donde el agente envía a terceros en automático	❌ No sin aprobación humana de por medio

No es por miedo, es por criterio. La tecnología es la misma; lo que cambia el riesgo es a quién le deja escribir tu agente y si alguien lo revisa antes de pulsar enviar.

La regla de oro

Conectar WhatsApp a tu agente cuesta dos pasos. Decidir qué le dejas hacer con él es donde está todo el trabajo. Empieza por el caso que te avisa a ti; el de “que hable con clientes” déjalo para cuando tengas aprobación humana en medio.

---

Herramienta → Kapso · Docs → docs.kapso.ai/docs/whatsapp/mcp · Anuncio de @andresmatte

Sígueme para más trucos con Claude Code e IA → @pabloinpublic

Waitlist de la comunidad → pabloinpublic.com