Cómo conectar VS Code + GitHub Copilot a WhatsApp con Aurora MCP (2026)

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

  1. Entra a tu workspace en app.aurorainbox.com.
  2. Ir para Integraciones → Developer Portal (URL directa: https://app.aurorainbox.com/integrations/developer-portal).
  3. Click en Generar nueva clave. Dale un nombre descriptivo, por ejemplo vscode-copilot-laptop-alex.
  4. 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:

  1. Pulsa Ctrl+Shift+P (Windows/Linux) o Cmd+Shift+P (macOS) para abrir la paleta de comandos.
  2. 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:

  • Ele settings.json debe seguir siendo JSON válido. Si VS Code te marca subrayado rojo, abre la paleta y corre JSON: 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:

  1. Ctrl+Shift+P / Cmd+Shift+P.
  2. Escribe Developer: Reload Window y presiona Enter.

Después de recargar:

  1. Abre el panel de Copilot Chat (icono de chat en la barra lateral o Ctrl+Alt+I / Cmd+Ctrl+I).
  2. En la parte superior del panel verás un icono de MCP / Tools (parecido a un enchufe). Click ahí.
  3. Debe aparecer aurora en 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
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 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
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 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) com 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 de get_chat y 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_message y 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, hiciste Developer: 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 keyId que 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.
  • Multicanal: 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.

Perguntas frequentes

¿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)?

Não. 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 e 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.

Crie seu chatbot de IA

Aurora Inbox centraliza todas as conversas da sua empresa e responde aos seus clientes instantaneamente

Aurora Ativa

Postagens mais recentes

Crie seu chatbot de IA

Com o consultor Aurora IA, você nunca mais terá que se preocupar com mensagens não respondidas. Ofereça aos seus clientes uma interação perfeita e personalizada, enquanto você pode dedicar seu tempo para continuar a expandir seus negócios.

Aurora Ativa