Conectar Claude Code a WhatsApp Business toma 5 minutos con Aurora MCP. Aurora expone un servidor MCP en https://developers.aurorainbox.com/mcp con 30+ herramientas (buscar chats, enviar mensajes, crear contactos, mover oportunidades en el embudo, levantar webhooks) que cualquier agente compatible con MCP puede consumir. Solo necesitas un workspace de Aurora Inbox, una clave ak_live_* del Developer Portal y un comando claude mcp add. Esta guía cubre el setup de punta a punta.
Requisitos previos
Antes de ejecutar el comando, asegúrate de tener:
- Workspace de Aurora Inbox activo (el trial gratuito sirve para probar todo el flujo).
- Número de WhatsApp Business conectado en Aurora (vía OAuth con Meta o registro manual).
- Claude Code instalado (
npm install -g @anthropic-ai/claude-codeo el instalador oficial). - Clave Platform API
ak_live_*generada en el Developer Portal (más abajo).
Paso 1: Generar la clave de Aurora
- Entra a tu workspace en
app.aurorainbox.com. - Ir para Integraciones → Developer Portal (URL directa: https://app.aurorainbox.com/integrations/developer-portal).
- Click en Generar nueva clave. Dale un nombre descriptivo (ej.
claude-code-laptop-alex). - Copia la clave — empieza con
ak_live_…. Solo se muestra una vez; si la pierdes, debes generar otra.
La clave queda scoped a un solo tenant (un workspace de Aurora) con scope aurora.api.platform. Cualquier acción que ejecute Claude Code se hace con la identidad de tu workspace y se registra en el audit log.
Paso 2: Agregar Aurora MCP a Claude Code
Un solo comando:
claude mcp add aurora \
--transport http \
https://developers.aurorainbox.com/mcp \
--header "Authorization: Bearer ak_live_REEMPLAZA_TU_CLAVE"
Esto agrega Aurora a tu config de usuario (~/.claude.json). Para verificar que quedó registrado:
claude mcp list
Deberías ver aurora en la lista con estado connected. Si aparece failed, revisa que la clave esté completa y empiece con ak_live_.
Paso 3: Probar la conexión
Abre Claude Code en cualquier proyecto y pídele algo simple:
> Lista los primeros 5 contactos de mi cuenta de Aurora Inbox.
Claude Code va a llamar a la herramienta list_contacts y devolver un array con id, name, phone, email, companyName. Si la respuesta llega, el setup funciona.
Qué herramientas expone Aurora MCP
Aurora MCP cubre las 10 áreas funcionales del producto. Cada herramienta refleja 1:1 un endpoint REST de la Platform V1 API.
| Categoría | Herramientas representativas | Caso de uso |
|---|---|---|
| Chats | search_chats, get_chat, create_chat, assign_chat_agents, set_chat_owner |
Triage de bandeja, asignación a agentes |
| Mensagens | send_message (1 msg/seg por tenant), notas internas con note=true |
Respuestas, follow-ups, comentarios para el equipo |
| Chatbots | start_chatbot, stop_chatbot, list_chat_chatbots, list_chatbots |
Activar workflows en chats específicos |
| Contatos | list_contacts, get_contact, create_contact, update_contact, upsert_contact, delete_contact |
CRM básico desde el agente |
| Empresas | list_companies, get_company, create_company, update_company |
Cuentas B2B |
| Oportunidades | create_opportunity, update_opportunity, delete_opportunity, list_chat_opportunities |
Mover deals en el embudo |
| Canais | Listar y revisar status de WhatsApp Cloud API, WhatsApp Business, Messenger, Instagram | Diagnóstico multi-canal |
| Equipos / Usuarios | Tools de Team y User para invitar, asignar y consultar | Onboarding programático |
| Webhooks | create_webhook, list_webhooks, delete_webhook (máx. 5 por tenant) |
Eventos out-bound a tu infraestructura |
| Diagnóstico | health, whoami |
Validar conectividad y permisos |
O ChannelType que aceptan create_chat y endpoints relacionados son: 0=WhatsApp Cloud API, 1=WhatsApp Business, 2=Messenger, 3=Instagram.
Tres prompts de ejemplo end-to-end
Triage matutino
Busca en Aurora todos los chats de WhatsApp sin contestar de las últimas 24 horas.
Para cada uno, lee el último mensaje del cliente y dame un resumen de una línea
y la prioridad (alta/media/baja) basada en si menciona dinero, urgencia o queja.
Claude Code llama a search_chats(unanswered=true) y luego get_chat(id) para cada uno. Tú obtienes una lista priorizada en lenguaje natural.
Crear contacto y abrir oportunidad
Tengo un lead nuevo: Daniel Martínez, +52 55 1234 5678, daniel@empresa.mx,
Empresa "Logística MX". Créalo en Aurora y abre una oportunidad en el embudo
"Ventas Q3" del equipo de ventas con monto estimado de $80,000 MXN.
Claude Code encadena upsert_contact → create_chat (canal WhatsApp Cloud) → create_opportunity → update_opportunity(dealAmount=80000). Todo dentro de la sesión de chat sin que abras la UI de Aurora.
Follow-up masivo
Busca los chats en estado "sin respuesta del cliente" de hace más de 72 horas.
A cada uno mándale un mensaje de follow-up corto y amable preguntando si
todavía necesita ayuda. Espera 1 segundo entre envíos para respetar el rate limit.
Claude Code respeta automáticamente el rate limit de send_message (1 mensaje/segundo por tenant — si lo excede, recibe Rate limit exceeded… retry after 1s y se detiene).
Solución de problemas
Error 401 Unauthorized
La clave no se pegó completa o tiene espacios. Vuelve a generar y pégala con cuidado. La clave debe empezar exactamente con ak_live_.
Error 403 Forbidden en herramientas específicas
Algunas herramientas requieren roles adicionales (ej. delete_contact necesita el rol Contact Administrator). Revisa los roles del usuario asociado a la clave en Integraciones → Developer Portal → Permisos.
Las herramientas no aparecen en claude mcp list
Reinicia Claude Code (Ctrl+C e claude de nuevo). Si persiste, ejecuta curl https://developers.aurorainbox.com/.well-known/mcp.json y verifica que el servidor responda.
Rate limit en send_message
Aurora limita envíos a 1 mensaje por segundo por tenant para proteger la calidad de número en Meta. Si tu agente quiere mandar 100 mensajes, secuéncialos con 1 segundo de espera o usa el endpoint /Platform/V1/Messaging/Bulk (no expuesto vía MCP por diseño).
Cómo lo hace Aurora MCP
A diferencia de pegar el endpoint de WhatsApp Cloud API directo a un agente, Aurora MCP da:
- Auth simple: una clave
ak_live_*reusa el mismo sistema de Platform API que ya tenías. Sin OAuth de tres patas, sin tokens que expiran. - Audit log nativo: cada llamada queda registrada en Aurora con el
keyIdque la originó. - Rate limits por tenant: tu agente no puede degradar la calidad de número de Meta enviando demasiado rápido.
- Multicanal: la misma herramienta funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — el agente elige el canal con
channelType. - CRM detrás: cada chat ya está vinculado a un contacto y puede generar oportunidades — no es solo "enviar mensaje".
Plan recomendado para empezar: Aurora IA $179 USD/mes ($3,200 MXN) que incluye GPT-5, RAG nativo, agendamiento embarcado y MCP server.
Empieza tu prueba gratuita y conecta Claude Code en 5 minutos.
Perguntas frequentes
¿Aurora MCP es gratis?
El servidor MCP está incluido en cualquier plan pagado de Aurora Inbox (CRM $99 USD, IA $179 USD, IA Plus $329 USD). El trial de 14 días también lo incluye sin restricción.
¿Funciona con Claude Code en modo CLI y en modo IDE (VS Code/JetBrains)?
Sí. La config queda en ~/.claude.json y aplica a todas las superficies de Claude Code.
¿Mi clave queda visible en logs de Claude Code?
Claude Code maskea headers Authorization en su debug log. Aún así, trata ak_live_* como password — no la commitees a git.
¿Puedo darle una clave por agente o por desarrollador?
Sí, recomendado. Genera una clave por humano y por máquina; revoca individualmente desde el Developer Portal sin afectar las demás.
¿Soporta multi-tenant?
Cada clave es scoped a un tenant. Si manejas varios workspaces de Aurora, genera una clave por workspace y agrégalas con nombres distintos: claude mcp add aurora-prod … e claude mcp add aurora-staging ….
¿Qué pasa si Anthropic actualiza el protocolo MCP?
Aurora soporta la versión 2025-03-26 (la spec estable de Anthropic) sobre transporte streamable-http. Las versiones futuras se agregarán manteniendo backward-compat según el spec oficial.
¿Puedo conectar otros agentes (Codex, Cursor, Claude Desktop) al mismo Aurora?
Sí. Misma clave, mismo endpoint. Cada cliente tiene un setup ligeramente distinto — revisa nuestras guías para Codex CLI, Claude Desktop, Cursor e VS Code Copilot.
