VS Code es el IDE más instalado del mundo y GitHub Copilot es el asistente de IA estándar en miles de equipos de ingeniería. Si tu setup diario ya combina ambos, con cinco líneas en settings.json también puede manejar WhatsApp Business: leer la bandeja, abrir oportunidades en el CRM, enviar follow-ups y conectar webhooks — sin salir del editor. Esta guía deja Aurora MCP cargado en Copilot Chat en menos de 5 minutos.
Requisitos previos
Antes de tocar la configuración, confirma:
- VS Code instalado (versión Stable o Insiders, ambas funcionan; recomendado >= 1.95).
- Suscripción activa de GitHub Copilot — Individual ($10 USD/mes) o Business ($19 USD/mes). Copilot se paga aparte de Aurora; no está incluido en ningún plan de Aurora Inbox.
- La extensión oficial GitHub Copilot Chat habilitada en tu VS Code.
- Workspace de Aurora Inbox activo (el trial gratuito sirve para probar todo).
- Número de WhatsApp Business conectado en Aurora (vía OAuth con Meta o registro manual).
- Clave Platform API
ak_live_*generada en el Developer Portal (siguiente paso).
Paso 1: Generar tu clave Aurora
- Entra a tu workspace en
app.aurorainbox.com. - Ve a Integraciones → Developer Portal (URL directa: https://app.aurorainbox.com/integrations/developer-portal).
- Click en Generar nueva clave. Dale un nombre descriptivo, por ejemplo
vscode-copilot-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) con scope aurora.api.platform. Cualquier acción que ejecute Copilot pasa con la identidad de tu workspace y se registra en el audit log de Aurora con ese keyId.
Paso 2: Editar settings.json de VS Code
VS Code guarda la config de MCP para Copilot en el settings.json del usuario (no en el del workspace, salvo que quieras forzar una clave a un proyecto específico).
Para abrirlo:
- Pulsa
Ctrl+Shift+P(Windows/Linux) oCmd+Shift+P(macOS) para abrir la paleta de comandos. - Escribe
Preferences: Open User Settings (JSON)y presiona Enter.
VS Code abre el archivo settings.json del usuario. Pega el siguiente bloque dentro del JSON raíz (si ya tienes contenido, agrégalo como una clave más, separando con coma):
{
"github.copilot.mcp.servers": {
"aurora": {
"url": "https://developers.aurorainbox.com/mcp",
"headers": {
"Authorization": "Bearer ak_live_REEMPLAZA_TU_CLAVE"
}
}
}
}
Reemplaza ak_live_REEMPLAZA_TU_CLAVE con la clave que copiaste del Developer Portal. Guarda con Ctrl+S / Cmd+S.
Notas importantes:
- El
settings.jsondebe seguir siendo JSON válido. Si VS Code te marca subrayado rojo, abre la paleta y correJSON: Validate— un trailing comma o un bracket suelto rompen toda la config de MCP. - No commitees este archivo a un repo público. La clave es equivalente a un password.
- Si trabajas con varios workspaces de Aurora, registra varios servers (
aurora-prod,aurora-staging) con claves distintas.
Paso 3: Reload Window y verificar
Para que Copilot levante el servidor MCP nuevo, recarga la ventana:
Ctrl+Shift+P/Cmd+Shift+P.- Escribe
Developer: Reload Windowy presiona Enter.
Después de recargar:
- Abre el panel de Copilot Chat (icono de chat en la barra lateral o
Ctrl+Alt+I/Cmd+Ctrl+I). - En la parte superior del panel verás un icono de MCP / Tools (parecido a un enchufe). Click ahí.
- Debe aparecer
auroraen la lista de servers, con estado conectado y las herramientas listadas (search_chats,send_message,create_contact, etc.).
Si aparece como failed o no aparece, revisa la sección de troubleshooting al final.
Para una prueba rápida, en el chat de Copilot escribe:
Lista los primeros 5 contactos de mi cuenta de Aurora Inbox.
Copilot llama a list_contacts y devuelve 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 |
| Mensajes | 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 |
| Contactos | list_contacts, get_contact, create_contact, update_contact, upsert_contact, delete_contact |
CRM básico desde el editor |
| 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 |
| Canales | 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 |
Los ChannelType que aceptan create_chat y endpoints relacionados son: 0=WhatsApp Cloud API, 1=WhatsApp Business, 2=Messenger, 3=Instagram.
Tres prompts de ejemplo en Copilot Chat
Mientras programas la integración de un webhook
Estoy escribiendo un endpoint que recibe webhooks de Aurora. Lista los webhooks
que ya tengo configurados en mi tenant y dime para qué eventos están suscritos.
Luego ayúdame a registrar uno nuevo en https://api.miapp.com/aurora-events
para el evento "MessageReceived".
Copilot llama a list_webhooks y luego create_webhook, y aprovecha que está en VS Code para sugerirte el handler en tu archivo abierto. Programar la integración y darla de alta en el mismo turno.
Triage matutino sin abandonar el editor
Antes de retomar el código de ayer, busca en Aurora todos los chats de WhatsApp
sin contestar de las últimas 24 horas. Dame un resumen de una línea por cada
uno y márcalos por prioridad (alta/media/baja).
Copilot encadena search_chats(unanswered=true) con get_chat(id) por cada chat. Recibes la lista priorizada en el panel sin abrir el navegador.
Lead nuevo que cae en Slack
Tengo un lead nuevo: Daniel Martínez, +52 55 1234 5678, daniel@empresa.mx,
empresa "Logística MX". Créalo en Aurora con upsert_contact, abre un chat de
WhatsApp Cloud y crea una oportunidad en el embudo "Ventas Q3" con monto
estimado de $80,000 MXN.
Copilot encadena upsert_contact → create_chat(channelType=0) → create_opportunity → update_opportunity(dealAmount=80000). Toda la operación pasa en Copilot Chat sin tocar la UI de Aurora.
Combinar Copilot + Aurora MCP en flujos diarios
VS Code es donde los developers ya pasan ocho horas. Tener Aurora MCP cargado en Copilot Chat abre tres patrones interesantes:
- Peer programming sobre integraciones reales. Mientras escribes el cliente que consume webhooks de Aurora, Copilot puede consultar
list_webhooks, leer payloads reales deget_chaty proponer parsers correctos contra datos vivos en lugar de mocks. - Manejar WhatsApp desde la misma ventana donde escribes código. Un dev de soporte revisa un bug, encuentra el chat del cliente afectado, le manda update con
send_messagey vuelve al diff. Cero context switching al navegador. - Copilot Chat en modo agente para operaciones multi-paso. En modo agente (Agent mode), Copilot ejecuta múltiples herramientas en secuencia con poca supervisión: importar 200 leads desde un CSV con
upsert_contact, abrir oportunidades para los que califican y mandar bienvenida — todo en una sola petición en lenguaje natural, respetando el rate limit de 1 mensaje/seg.
Solución de problemas
Copilot dice "no tienes suscripción activa"
VS Code permite editar settings.json aunque tu Copilot esté caducado, pero Copilot Chat no responderá nada. Renueva tu suscripción en https://github.com/settings/copilot. El servidor MCP sigue ahí, listo para cuando Copilot vuelva.
settings.json malformado
Si pegaste el bloque y rompiste el JSON (trailing comma, llave abierta de más), VS Code muestra un subrayado rojo y Copilot ignora todo el archivo. Abre la paleta, corre JSON: Validate y corrige. La extensión Prettier o el formateo nativo (Shift+Alt+F) también ayudan a detectar el error.
El servidor aurora aparece en MCP pero con estado failed
Casi siempre es la clave: o no la copiaste completa, o tiene espacios al inicio. Vuelve a generar la clave en el Developer Portal y pégala con cuidado. Confirma que empieza exactamente con ak_live_. También revisa que no estés detrás de un proxy corporativo que esté bloqueando developers.aurorainbox.com.
El icono de MCP no aparece en Copilot Chat
Verifica:
- VS Code está actualizado (
Help → Check for Updates). - La extensión GitHub Copilot Chat está habilitada (no solo instalada).
- Después de editar
settings.json, hicisteDeveloper: Reload Window. El cambio no se aplica hot-reload en muchos builds.
"Esta herramienta no está disponible para el modelo seleccionado"
No todos los modelos de Copilot soportan tool calling (MCP) con la misma fidelidad. Si usas un modelo que no lo soporta, Copilot va a ignorar las herramientas. En el selector de modelo de Copilot Chat, elige uno con MCP completo: GPT-5, Claude Sonnet o Gemini Pro. GPT-5 y Claude Sonnet son los más fiables para encadenar varias tool calls.
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 prompt pide mandar 100 mensajes, Copilot debe espaciarlos. Si excede, recibe Rate limit exceeded… retry after 1s y se detiene.
Cómo lo hace Aurora MCP
A diferencia de pegar el endpoint de WhatsApp Cloud API directo a Copilot, Aurora MCP entrega:
- Auth simple: una clave
ak_live_*y 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ó — sabes exactamente qué clave de qué dev hizo qué cosa. - Rate limits por tenant: Copilot no puede degradar la calidad de número de Meta enviando demasiado rápido aunque le pidas hacerlo.
- Multi-canal: la misma herramienta sirve 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" sin estado.
Plan recomendado para empezar: Aurora IA $179 USD/mes ($3,200 MXN) que incluye GPT-5, RAG nativo, agendamiento embarcado y MCP server. El plan CRM ($99 USD / $1,800 MXN) y IA Plus ($329 USD / $6,000 MXN) también incluyen MCP.
Empieza tu prueba gratuita y conecta VS Code + Copilot en 5 minutos.
Preguntas frecuentes
¿Requiero pagar GitHub Copilot por separado?
Sí. Copilot es un producto de GitHub y se paga aparte: $10 USD/mes Individual o $19 USD/mes Business. No está incluido en ningún plan de Aurora. Aurora solo provee el servidor MCP — quien razona sigue siendo el modelo de Copilot. Si tu organización ya tiene Copilot Business, aprovecha esa suscripción.
¿Funciona en VS Code Insiders y en Stable?
Sí, las dos. La feature de MCP en Copilot está disponible en Stable desde 2025 y en Insiders un poco antes. La config (github.copilot.mcp.servers) es idéntica.
¿Qué modelos de Copilot soportan MCP?
GPT-5, Claude Sonnet (3.5/3.7/4 según release) y Gemini Pro soportan tool calling completo y, por tanto, MCP. Los modelos chicos pueden ignorar herramientas o llamarlas mal. Si encadenas varias tools (ej. crear contacto + abrir chat + crear oportunidad), GPT-5 y Claude Sonnet dan los mejores resultados.
¿La config se aplica a todos mis workspaces de VS Code?
Si la pegas en el settings.json de User, sí — vale para cualquier proyecto. Si la pegas en el settings.json de un workspace específico (.vscode/settings.json), solo aplica a ese proyecto. Recomendamos User para uso personal y Workspace solo cuando quieras una clave distinta por proyecto cliente.
¿Funciona con GitHub Enterprise o Copilot Business?
Sí. La configuración es la misma. En Copilot Business, valida con tu admin que las MCP servers de terceros estén permitidas — algunas orgs usan policies para restringir qué servers MCP pueden cargar los developers.
¿Hay conflictos si ya tengo otros MCP servers (Sentry, Linear, GitHub MCP)?
No. github.copilot.mcp.servers es un objeto que admite múltiples entradas. Aurora vive bajo la clave aurora y los demás MCP servers en sus propias claves. Copilot lista todas las herramientas en el panel de MCP y elige cuál llamar según el prompt. La única consideración es que algunos modelos chicos se confunden con muchas herramientas a la vez — si ves comportamiento errático, mueve a GPT-5 o Claude Sonnet.
¿Trabajas con otros agentes? Tenemos guías paralelas para Claude Code, Codex CLI, Claude Desktop y Cursor. Y si quieres entender el protocolo a fondo, lee qué es MCP y cómo conecta IA con WhatsApp o explora 10 casos de uso reales.
