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.
Prerequisites
Antes de ejecutar el comando, asegúrate de tener:
- Aurora Inbox Workspace active (the free trial sirve para probar todo el flujo).
- WhatsApp Business number connected in Aurora (via OAuth with Meta or manual registration).
- Claude Code instalado (
npm install -g @anthropic-ai/claude-codeo el instalador oficial). - Key Platform API
ak_live_*generada en el Developer Portal (más abajo).
Step 1: Generate the Aurora key
- Enter your workspace at
app.aurorainbox.com. - Go to Integrations → Developer Portal (Direct URL: https://app.aurorainbox.com/integrations/developer-portal).
- Click on Generate new keyGive it a descriptive name (e.g.
claude-code-laptop-alex). - Copy the key — it starts with
ak_live_…It is only displayed once; if you lose it, you must generate another one.
The key is scoped to a single tenant (an Aurora workspace) with 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
You should see Aurora en la lista con estado connected. Si aparece failed, revisa que la clave esté completa y empiece con ak_live_.
Step 3: Test the connection
Abre Claude Code en cualquier proyecto y pídele algo simple:
> List the first 5 contacts from my Aurora Inbox account.
Claude Code va a llamar a la herramienta list_contacts and return an array with id, yam, phone, e-mail, companyName. Si la respuesta llega, el setup funciona.
What tools does Aurora MCP offer?
Aurora MCP covers all 10 functional areas of the product. Each tool mirrors a Platform V1 API REST endpoint 1:1.
| Category | Representative tools | Use case |
|---|---|---|
| Chats | search_chats, get_chat, create_chat, assign_chat_agents, set_chat_owner |
Tray triage, agent assignment |
| Messages | send_message (1 ms/sec per tenant), internal notes with note=true |
Responses, follow-ups, and feedback for the team |
| Chatbots | start_chatbot, stop_chatbot, list_chat_chatbots, list_chatbots |
Activate workflows in specific chats |
| Contacts | list_contacts, get_contact, create_contact, update_contact, upsert_contact, delete_contact |
Basic CRM from the agent |
| Companies | list_companies, get_company, create_company, update_company |
B2B Accounts |
| Opportunities | create_opportunity, update_opportunity, delete_opportunity, list_chat_opportunities |
Moving deals through the funnel |
| Channels | List and review the status of WhatsApp Cloud API, WhatsApp Business, Messenger, and Instagram. | Multi-channel diagnostics |
| Equipment / Users | Team and User tools for inviting, assigning, and querying | Programmatic onboarding |
| Webhooks | create_webhook, list_webhooks, delete_webhook (máx. 5 por tenant) |
Outbound events to your infrastructure |
| Diagnosis | health, whoami |
Validate connectivity and permissions |
The ChannelType that accept create_chat y endpoints relacionados son: 0=WhatsApp Cloud API, 1=WhatsApp Business, 2=Messenger, 3=Instagram.
Three example end-to-end prompts
Morning triage
Search Aurora for all unanswered WhatsApp chats from the last 24 hours. For each one, read the customer's last message and give me a one-line summary and the priority (high/medium/low) based on whether it mentions money, urgency, or a complaint.
Claude Code llama a search_chats(unanswered=true) and then get_chat(id) para cada uno. Tú obtienes una lista priorizada en lenguaje natural.
Make contact and open opportunity
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 (WhatsApp Cloud channel) → create_opportunity → update_opportunity(dealAmount=80000). Todo dentro de la sesión de chat sin que abras la UI de Aurora.
Massive follow-up
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).
Troubleshooting
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 in specific tools
Algunas herramientas requieren roles adicionales (ej. delete_contact necesita el rol Contact Administrator). Revisa los roles del usuario asociado a la clave en Integrations → Developer Portal → Permissions.
The tools do not appear in claude mcp list
Reinicia Claude Code (Ctrl+C and claude de nuevo). Si persiste, ejecuta curl https://developers.aurorainbox.com/.well-known/mcp.json y verifica que el servidor responda.
Rate limit in 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).
How Aurora MCP does it
A diferencia de pegar el endpoint de WhatsApp Cloud API directo a un agente, Aurora MCP da:
- Simple Auth: a key
ak_live_*reusa el mismo sistema de Platform API que ya tenías. Sin OAuth de tres patas, sin tokens que expiran. - Native audit logEach call is recorded in Aurora with the
keyIdthat originated it. - Rate limits per tenant: tu agente no puede degradar la calidad de número de Meta enviando demasiado rápido.
- Multi-channel: la misma herramienta funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — el agente elige el canal con
channelType. - CRM behind: cada chat ya está vinculado a un contacto y puede generar oportunidades — no es solo "enviar mensaje".
Recommended plan to start with: Aurora IA $179 USD/month ($3,200 MXN) que incluye GPT-5, RAG nativo, agendamiento embarcado y MCP server.
Start your free trial y conecta Claude Code en 5 minutos.
Frequently Asked Questions
Is Aurora MCP free?
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 … and claude mcp add aurora-staging ….
¿Qué pasa si Anthropic actualiza el protocolo MCP?
Aurora supports version 2025-03-26 (la spec estable de Anthropic) sobre transporte streamable-http. Las versiones futuras se agregarán manteniendo backward-compat según el official spec.
¿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 and VS Code Copilot.
