How to connect VS Code + GitHub Copilot to WhatsApp with 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.

Prerequisites

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.
  • Aurora Inbox Workspace active (the free trial sirve para probar todo).
  • WhatsApp Business number connected in Aurora (via OAuth with Meta or manual registration).
  • Key Platform API ak_live_* generada en el Developer Portal (siguiente paso).

Paso 1: Generar tu clave Aurora

  1. Enter your workspace at app.aurorainbox.com.
  2. Go to Integrations → Developer Portal (Direct URL: https://app.aurorainbox.com/integrations/developer-portal).
  3. Click on Generate new key. Dale un nombre descriptivo, por ejemplo vscode-copilot-laptop-alex.
  4. Copy the key — it starts with ak_live_…It is only displayed once; if you lose it, you must generate another one.

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_REPLACE_YOUR_KEY con la clave que copiaste del Developer Portal. Guarda con Ctrl+S / Cmd+S.

Notas importantes:

  • He 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:

List the first 5 contacts from my Aurora Inbox account.

Copilot llama a list_contacts y devuelve un array con 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 CRM básico desde el editor
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.

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 and then 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) with 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.

Troubleshooting

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 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 prompt pide mandar 100 mensajes, Copilot debe espaciarlos. Si excede, recibe Rate limit exceeded… retry after 1s y se detiene.

How Aurora MCP does it

A diferencia de pegar el endpoint de WhatsApp Cloud API directo a Copilot, Aurora MCP entrega:

  • Simple Auth: a key ak_live_* y 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 keyId que la originó — sabes exactamente qué clave de qué dev hizo qué cosa.
  • Rate limits per tenant: Copilot no puede degradar la calidad de número de Meta enviando demasiado rápido aunque le pidas hacerlo.
  • Multi-channel: la misma herramienta sirve 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" sin estado.

Recommended plan to start with: Aurora IA $179 USD/month ($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.

Start your free trial y conecta VS Code + Copilot en 5 minutos.

Frequently Asked Questions

¿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 and Cursor. Y si quieres entender el protocolo a fondo, lee What is MCP and how does AI connect with WhatsApp? or explore 10 casos de uso reales.

Create your AI chatbot

Aurora Inbox centralizes all your company's conversations and responds to your customers instantly

Active Aurora

Most recent posts

Create your AI chatbot

With Aurora IA Advisor, you'll never have to worry about unanswered messages again. Offer your customers a personalized and fluid interaction, while you can dedicate your time to continue growing your business.

Active Aurora