Si ya usas Claude Desktop para escribir, resumir o investigar, puedes darle también acceso a tu WhatsApp Business — sin programar, sin instalar plugins exóticos y sin mover tus chats fuera de Aurora. Solo necesitas pegar un pequeño bloque de configuración, una clave que generas en 30 segundos y reiniciar la app. A partir de ese momento, Claude puede leer conversaciones, redactar respuestas, crear contactos en tu CRM y agendar follow-ups, todo dentro de la misma ventana donde le pides cualquier otra cosa. Esta guía te lleva paso a paso.
Requisitos previos
Antes de empezar, ten a la mano:
- Claude Desktop instalado (descárgalo gratis desde claude.ai/download). Disponible para macOS y Windows.
- Una cuenta de Aurora Inbox activa. Si todavía no tienes una, abre el trial gratuito de 14 días — incluye todo lo necesario para esta guía.
- Tu número de WhatsApp Business conectado dentro de Aurora (vía OAuth con Meta o registro manual).
- Una clave Platform API
ak_live_*generada en el Developer Portal (te explicamos cómo obtenerla en el siguiente paso). - Un editor de texto plano para tocar el archivo de configuración: TextEdit en macOS o Notepad en Windows funcionan perfecto. Evita Word — añade caracteres invisibles que rompen el JSON.
No necesitas saber programar. Si copiar y pegar es algo cómodo para ti, vas a terminar en menos de 10 minutos.
Paso 1: Generar tu clave en Aurora
La clave es lo que le da permiso a Claude Desktop para hablar con tu Aurora. Funciona como una contraseña: trátala con cuidado y no la pegues en chats públicos ni la subas a repositorios.
- Abre tu workspace en
app.aurorainbox.comcon la cuenta de administrador. - En el menú lateral, ve a Integraciones → Developer Portal (también puedes ir directo a https://app.aurorainbox.com/integrations/developer-portal).
- Haz clic en Generar nueva clave. Ponle un nombre que después puedas reconocer, por ejemplo
claude-desktop-mac-alexoclaude-desktop-laptop-trabajo. - Copia la clave completa — empieza con
ak_live_seguido de una cadena larga. Guárdala en tu gestor de contraseñas: solo se muestra una vez. Si la pierdes, generas otra y listo.
Cada clave queda asociada a un solo workspace de Aurora. Las acciones que ejecute Claude Desktop quedan registradas en tu audit log con el keyId de esa clave, así sabes exactamente qué pasó y cuándo.
Paso 2: Editar el config de Claude Desktop
Claude Desktop guarda sus servidores MCP en un archivo de configuración en formato JSON. Vamos a abrirlo, agregar Aurora y guardar.
Encontrar el archivo
La ruta cambia según tu sistema operativo:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
La forma más rápida de abrirlo:
- En macOS, abre Finder, presiona
Cmd + Shift + Gy pega la ruta completa:~/Library/Application Support/Claude/. Luego abreclaude_desktop_config.jsoncon TextEdit. - En Windows, abre el Explorador de archivos, pega
%APPDATA%\Claude\en la barra de direcciones y presiona Enter. Abreclaude_desktop_config.jsoncon Notepad.
Si el archivo no existe, créalo tú. Si existe pero está vacío, también está bien — lo vamos a llenar.
Pegar el snippet de Aurora
Reemplaza el contenido del archivo con esto (o si ya tienes otros servidores MCP configurados, agrega la entrada aurora dentro del objeto mcpServers):
{
"mcpServers": {
"aurora": {
"url": "https://developers.aurorainbox.com/mcp",
"headers": {
"Authorization": "Bearer ak_live_REEMPLAZA_TU_CLAVE"
}
}
}
}
Sustituye ak_live_REEMPLAZA_TU_CLAVE por la clave que copiaste en el paso anterior. Asegúrate de que la palabra Bearer siga ahí, con el espacio antes de la clave.
Guarda el archivo. Si tu editor te pregunta si quieres conservar la extensión .json, responde que sí.
Tip: Si pegaste con copy-paste y aparecen comillas raras (
"en lugar de"), reemplázalas manualmente por comillas dobles rectas. Es la causa #1 de errores al abrir Claude Desktop.
Paso 3: Reiniciar Claude Desktop y verificar
Este paso parece obvio, pero es donde más gente se atora. No basta con cerrar la ventana — Claude Desktop suele seguir corriendo en segundo plano, y el archivo de configuración solo se relee al arranque.
Cierre completo
- En macOS: clic derecho en el ícono de Claude en el Dock → Salir. O bien, con la app activa, menú Claude → Salir de Claude (
Cmd + Q). - En Windows: clic derecho en el ícono de Claude en la bandeja del sistema (esquina inferior derecha, junto al reloj) → Quit. O usa el Administrador de tareas para cerrar el proceso si no aparece.
Una vez cerrada por completo, vuelve a abrir Claude Desktop como cualquier otra app.
Probar que funciona
Abre una conversación nueva y pregunta:
¿Qué herramientas tienes disponibles?
Si Aurora MCP cargó correctamente, Claude debe mencionar herramientas como search_chats, send_message, list_contacts, create_chat, entre otras (~30 en total). Verás un pequeño icono de herramientas en la interfaz indicando que un servidor MCP está conectado.
Si todo se ve bien, intenta una pregunta práctica:
Lista los primeros 5 contactos de mi cuenta de Aurora Inbox.
Claude llamará a la herramienta list_contacts, te pedirá confirmación la primera vez (parte normal del flujo de seguridad de Anthropic) y devolverá el listado en lenguaje natural.
Qué puedes pedirle a Claude Desktop con Aurora MCP
Aurora MCP expone alrededor de 30 herramientas que cubren las áreas funcionales del producto. Aquí un resumen orientado a lo que un operador real le pediría a Claude Desktop en su día a día.
| Categoría | Qué puede hacer Claude | Ejemplo cotidiano |
|---|---|---|
| Bandeja de entrada | Buscar chats, abrirlos, marcarlos, asignarlos | "Muéstrame los chats sin contestar de hoy" |
| Mensajería | Enviar mensajes (1 por segundo por cuenta) y notas internas | "Mándale a María un mensaje de seguimiento amable" |
| Contactos | Listar, crear, actualizar, hacer upsert, borrar | "Crea a Pedro Ramírez con su teléfono +52 81 1234 5678" |
| Oportunidades | Crear, mover y consultar deals en el embudo | "Abre una oportunidad de $50,000 MXN con esta cuenta" |
| Chatbots | Activar y desactivar chatbots automáticos por chat | "Pausa el chatbot en el chat de Daniel mientras lo atiendo" |
| Canales | Funciona con WhatsApp Cloud (0), WhatsApp Business (1), Messenger (2), Instagram (3) | "Mándale por WhatsApp Cloud, no por Instagram" |
| Webhooks | Crear webhooks para recibir eventos en otras herramientas | "Configura un webhook hacia mi Zapier" |
| Diagnóstico | Verificar conectividad y permisos | "¿Estoy conectado a Aurora correctamente?" |
Cada herramienta refleja 1:1 un endpoint de la Platform V1 API de Aurora. Si quieres entender la mecánica interna, lee qué es MCP y cómo conecta IA con WhatsApp.
Cinco prompts útiles para empezar
1. Triage matutino de la bandeja
Revisa los chats de WhatsApp en Aurora que están sin contestar
de las últimas 24 horas. Dame una lista priorizada por urgencia
con un resumen de una línea por cada uno.
Claude Desktop usa search_chats(unanswered=true) y luego get_chat(id) por cada uno. Tú obtienes una vista priorizada en menos de un minuto, sin abrir Aurora.
2. Follow-up amigable a un cliente que dejó de responder
En Aurora, busca el chat con María González. Lee los últimos
mensajes y redacta un follow-up corto y cálido preguntando si
todavía necesita ayuda con la cotización. Antes de mandarlo,
muéstramelo para aprobar.
Claude busca el chat, lee el contexto, redacta y espera tu visto bueno antes de invocar send_message. Tú quedas a cargo del tono.
3. Encontrar a alguien por su número
Busca en Aurora el contacto cuyo teléfono termina en 5678.
Dame su nombre, empresa y el último mensaje que intercambiamos.
Claude usa list_contacts con filtros y luego get_chat para el último mensaje. Útil cuando alguien te pregunta "¿quién es este número?" en una junta.
4. Agendar una llamada con un lead
Crea una oportunidad nueva en el embudo "Ventas Q3" para
el contacto Carlos Pérez con monto estimado de $80,000 MXN.
Después manda un WhatsApp invitándolo a una llamada el jueves
a las 11:00 hora de México.
Claude encadena create_opportunity con monto y luego send_message. Un solo prompt termina con una oportunidad abierta y el cliente notificado.
5. Reporte rápido para tu reunión
¿Cuántos chats nuevos entraron a Aurora ayer? Agrúpalos por
canal (WhatsApp Cloud, WhatsApp Business, Instagram, Messenger)
y dame un total.
Claude consulta los chats con filtros de fecha, cuenta por canal y arma un mini reporte. Perfecto para un standup de la mañana.
Solución de problemas
"El JSON está mal formado" o Claude Desktop no arranca
El error más común. Verifica:
- Comillas dobles rectas (
"), no curly quotes (""). Word y algunos editores las convierten automáticamente. - Comas en su lugar: después de cada par clave-valor menos el último de cada bloque.
- Llaves balanceadas: todo
{debe tener su}correspondiente.
Truco: pega tu JSON completo en https://jsonlint.com — te dice exactamente qué línea tiene el problema.
La ruta del archivo no existe
Si la carpeta Claude no aparece, abre Claude Desktop al menos una vez. La app crea la carpeta en el primer arranque. Después puedes editar el archivo y reiniciar.
Editaste el archivo pero Claude no ve a Aurora
Casi siempre es porque no reiniciaste por completo. Revisa que Claude Desktop ya no esté corriendo en segundo plano (Dock en macOS, bandeja del sistema en Windows) antes de volver a abrirlo.
"Error de autenticación" o "401 Unauthorized"
La clave no se pegó completa, o tiene espacios al inicio o al final. Vuelve al Developer Portal, copia la clave completa (ak_live_ y todo lo que sigue, sin saltos de línea) y pégala de nuevo en el JSON.
"La clave expiró" o ya no funciona
Las claves no expiran solas, pero un admin pudo revocarla desde el Developer Portal. Genera una nueva, reemplázala en el JSON, guarda y reinicia.
Las herramientas no aparecen aunque todo se ve bien
Cierra Claude Desktop por completo. Espera 10 segundos. Vuelve a abrirlo. Si persiste, abre una terminal y ejecuta:
curl https://developers.aurorainbox.com/.well-known/mcp.json
Debes ver un JSON con la descripción del servidor. Si no, reporta a soporte.
Cómo lo hace Aurora MCP
Conectar un agente de IA directamente a la WhatsApp Cloud API de Meta requiere ser un BSP autorizado, manejar webhooks entrantes, controlar rate limits y construir tu propio CRM detrás. Aurora hace todo eso por ti y le entrega a Claude Desktop una superficie limpia:
- Auth simple: una clave
ak_live_*reusa el sistema de Platform API que ya estás pagando. No hay OAuth de tres patas ni tokens que expiran. - Audit log nativo: cada llamada queda asociada al
keyIdque la originó, así sabes qué hizo Claude y cuándo. - Rate limits por workspace:
send_messageestá limitado a 1 mensaje por segundo por cuenta para proteger la calidad de número con Meta. Claude lo respeta automáticamente. - Multi-canal: la misma clave funciona para WhatsApp Cloud, WhatsApp Business, Messenger e Instagram — Claude elige el canal con el parámetro
channelType. - CRM detrás: cada chat ya está vinculado a un contacto y puede generar oportunidades. No es solo "enviar mensaje", es "operar tu negocio desde Claude".
Plan recomendado para empezar: Aurora IA $179 USD/mes ($3,200 MXN) que incluye GPT-5, RAG nativo, agendamiento embarcado y el servidor MCP sin restricciones.
Empieza tu prueba gratuita de 14 días y conecta Claude Desktop en menos de 10 minutos.
Preguntas frecuentes
¿Aurora MCP es gratis?
El servidor MCP está incluido en cualquier plan pagado de Aurora Inbox: Aurora CRM $99 USD/mes ($1,800 MXN), Aurora IA $179 USD ($3,200 MXN) y Aurora IA Plus $329 USD ($6,000 MXN). El trial de 14 días también lo incluye sin restricciones.
¿Mi conversación con Claude se manda a Aurora?
No. Claude Desktop sigue procesando tus mensajes con los modelos de Anthropic (Claude Sonnet u Opus) en su infraestructura. Lo único que viaja a Aurora son las invocaciones de herramientas específicas (por ejemplo, "buscar este chat" o "mandar este mensaje"). El resto de tu conversación con Claude no toca a Aurora.
¿Puedo conectar varias cuentas de Aurora a la misma Claude Desktop?
Sí. En el archivo de configuración puedes agregar varios servidores con nombres distintos:
{
"mcpServers": {
"aurora-prod": {
"url": "https://developers.aurorainbox.com/mcp",
"headers": { "Authorization": "Bearer ak_live_PRODUCCION" }
},
"aurora-staging": {
"url": "https://developers.aurorainbox.com/mcp",
"headers": { "Authorization": "Bearer ak_live_STAGING" }
}
}
}
Cada uno aparece como un servidor MCP independiente y Claude elige el correcto según el contexto del prompt.
¿Puedo usar la misma clave en mi Mac y en mi Windows al mismo tiempo?
Sí. Una clave ak_live_* funciona desde cualquier máquina y todas las llamadas quedan en el mismo audit log. Aun así, lo recomendable es generar una clave por dispositivo (claude-desktop-mac-alex, claude-desktop-windows-alex) para poder revocar una sin afectar la otra si pierdes una laptop o cambias de equipo.
¿Qué pasa si edito mal el archivo JSON?
Claude Desktop simplemente no carga el servidor MCP defectuoso y te muestra un aviso al abrir la app. Tu cuenta de Aurora no corre ningún riesgo. Corriges el JSON, reinicias y listo. Si quieres regresar al estado anterior, borra el archivo claude_desktop_config.json y Claude Desktop vuelve a funcionar como si nunca hubieras tocado nada.
¿Otros agentes funcionan con la misma clave?
Sí. Aurora MCP soporta el protocolo MCP versión 2025-03-26 sobre transporte streamable-http, que es estándar abierto. La misma clave funciona en Claude Code, Codex CLI, Cursor y VS Code con Copilot. Cada cliente tiene su propio archivo de configuración, pero Aurora del lado de allá es el mismo. Para ideas de qué construir, revisa los 10 casos de uso de agentes en WhatsApp con Aurora MCP.
