Herramientascopilot cli mcp
Copilot CLI MCP: conecta y comprueba un servidor
Configura un servidor MCP en GitHub Copilot CLI, prueba una consulta de solo lectura y revisa las rutas, las políticas y los permisos antes de usarlo.
- Autor: humAIns
- 9 min de lectura
índice · 7 apartados
MCP conecta GitHub Copilot CLI con herramientas y fuentes externas, como un servicio de documentación. Se configura desde la terminal con copilot mcp add o desde /mcp add dentro de una sesión; ver un servidor en la lista confirma que existe una configuración, no que una petición haya invocado su herramienta. Para comprobarlo, prueba una consulta pública de solo lectura y verifica la llamada y la fuente antes de confiar en el resultado.
Requisitos y controles antes de conectar
Necesitas tener GitHub Copilot CLI instalado, iniciar sesión con una cuenta que pueda usarlo y trabajar en una carpeta que tengas autorización para abrir. En cuentas gestionadas, una política de la organización o empresa puede limitar conectores y servidores MCP; tener acceso al CLI no garantiza que cualquier servidor externo esté permitido. Consulta la documentación de Copilot CLI y las reglas de tu equipo.
GitHub MCP ya está integrado en Copilot CLI y disponible sin configuración adicional. Este tutorial añade un servidor distinto para consultar documentación pública: Microsoft Learn MCP. No confundir GitHub Copilot CLI con Microsoft 365 Copilot, que es otro producto.
Antes de empezar, actualiza o verifica tu CLI mediante sus procedimientos oficiales y confirma que la sintaxis sigue vigente en la guía de GitHub para añadir servidores MCP. No uses una carpeta de trabajo con datos de clientes para la primera prueba. Elige un directorio de prueba confiable y evita incluir código privado, credenciales o información confidencial en las preguntas.
Añadir Microsoft Learn MCP por HTTP
Microsoft publica un servidor MCP remoto para buscar documentación pública de Learn y recuperar artículos y ejemplos de código. Su endpoint oficial es https://learn.microsoft.com/api/mcp; la página de Microsoft declara que usa Streamable HTTP, no requiere autenticación y está disponible públicamente sin coste. El contenido es documentación pública, no información de perfil ni formación privada. Revisa las condiciones y limitaciones de Microsoft Learn MCP antes de utilizarlo.
Desde la terminal, ejecuta:
copilot mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp
El comando registra microsoft-learn como servidor HTTP en la configuración del usuario. GitHub documenta la forma copilot mcp add --transport http NOMBRE URL. En este ejemplo no hacen falta cabeceras de autorización ni claves: no añadas credenciales. La configuración de forma no interactiva puede habilitar todas las herramientas del servidor por defecto (*); consulta el manual y limita las herramientas a las estrictamente necesarias cuando la interfaz o el servicio lo permita.
También puedes hacerlo en una sesión interactiva: inicia copilot, escribe /mcp add, navega por el formulario con Tab, asigna un nombre único (microsoft-learn), elige tipo HTTP e introduce el endpoint oficial. Revisa las herramientas que quedarán disponibles y guarda con Ctrl+S. El servidor aparece disponible sin reiniciar el CLI, de acuerdo con la documentación de GitHub.
Un servidor remoto recibe solicitudes de red desde el cliente: no es lo mismo que un proceso local, pero tampoco significa que debas enviarle cualquier contenido. Microsoft Learn está destinado a buscar documentación pública; mantén la prueba en ese ámbito. No uses comandos de descarga de terceros ni actives aprobaciones globales de herramientas para conectarlo.
Comprobar la conexión: lista, detalles y llamada
Primero revisa la configuración desde otra línea de comandos:
copilot mcp list
copilot mcp get microsoft-learn
list muestra servidores configurados y su estado; get enseña detalles, tipo, estado y herramientas disponibles. Estos comandos no demuestran por sí solos que una petición haya usado el servidor: confirman la configuración y ayudan a diagnosticar disponibilidad.
Después, inicia una sesión interactiva de Copilot CLI y formula una consulta inequívoca que requiera documentación de Learn, por ejemplo:
Busca en Microsoft Learn la documentación oficial sobre cómo declarar una variable en PowerShell. Devuelve el título y el enlace de la página. No ejecutes comandos ni cambies archivos.
En la conversación, inspecciona el detalle de la llamada a herramienta. Comprueba que se invocó microsoft-learn, que la respuesta corresponde a la pregunta y que el enlace apunta a una página de Microsoft Learn pertinente. Si la interfaz no muestra qué herramienta se llamó o no puedes verificar la procedencia, no des por demostrada la conexión: una respuesta plausible puede proceder del propio modelo. Esta guía ofrece un procedimiento reproducible, no afirma que se haya ejecutado la prueba en tu equipo.
No pruebes con datos privados, solicitudes de escritura o acciones que cambien sistemas. La primera comprobación debe ser de lectura y el resultado debe poder verificarse directamente en la fuente enlazada.
Dónde guarda Copilot CLI la configuración
La configuración de usuario se guarda por defecto en ~/.copilot/mcp-config.json. Si defines COPILOT_HOME, el directorio de configuración se desplaza al directorio indicado y el fichero pasa a estar allí. No publiques el contenido de ese archivo sin revisarlo: otras configuraciones pueden contener credenciales o cabeceras sensibles aunque el ejemplo de Learn no las necesite.
Para una configuración asociada a un repositorio, Copilot CLI busca .mcp.json y .github/mcp.json desde la carpeta de trabajo hacia la raíz del repositorio. GitHub documenta que una carpeta de proyecto debe ser de confianza; en caso contrario, sus servidores pueden omitirse. Las definiciones del proyecto prevalecen sobre las de usuario si el nombre del servidor coincide. Si ambos archivos existen en el mismo directorio, .mcp.json tiene precedencia; las definiciones en directorios más cercanos al directorio actual prevalecen sobre las de directorios superiores.
No confundas estos archivos con .vscode/mcp.json: GitHub indica que Copilot CLI no lo lee, y su clave superior servers no es compatible con esta configuración. No copies una configuración de VS Code sin adaptarla al formato documentado para CLI. La referencia oficial de configuración MCP detalla archivos, precedencia y confianza de carpetas.
Diagnóstico si no aparece o no conecta
Si microsoft-learn no aparece en copilot mcp list, revisa si el comando de alta terminó correctamente y si estás consultando el mismo directorio de configuración. Comprueba COPILOT_HOME si está definida: podrías estar leyendo una configuración distinta a ~/.copilot/mcp-config.json. No edites ni elimines archivos de configuración ajenos al servidor que estás probando.
Si aparece pero el estado no es conectado, comprueba el transporte HTTP, la URL exacta y la conectividad al servicio. Consulta también las políticas de la organización y la confianza de la carpeta cuando el servidor provenga de un archivo de proyecto. Un fallo podría deberse a la configuración, la red, el servicio o una restricción administrativa; no atribuyas la causa sin evidencia. La página de Microsoft Learn MCP advierte que el endpoint es para clientes MCP mediante Streamable HTTP y puede responder con error si se abre directamente en un navegador.
Si el servidor figura conectado pero Copilot no lo usa, redacta una petición que necesite explícitamente información de Learn y revisa el detalle de la llamada. Si no puedes identificar la invocación, la prueba sigue sin estar verificada. Contrasta la interfaz con la guía de gestión de servidores MCP de GitHub.
Para dejar de usarlo temporalmente, ejecuta copilot mcp disable microsoft-learn: la entrada se conserva y queda deshabilitada. Para quitar la entrada de la configuración de usuario, usa copilot mcp remove microsoft-learn. Antes de retirar un servidor de proyecto, identifica el archivo que lo define y modifica solo ese registro con permiso de su responsable; no borres configuraciones compartidas que no te pertenecen. La retirada no equivale a desinstalar todo Copilot CLI.
Seguridad: el tipo de servidor importa
Un servidor remoto HTTP recibe solicitudes del cliente a través de la red. Un servidor STDIO, en cambio, inicia un proceso local y se comunica mediante entrada y salida estándar; ese proceso puede operar con los permisos del usuario y del entorno donde se ejecuta. Ambos requieren evaluar quién los publica, qué herramientas exponen y qué datos pueden recibir.
Aplica permisos mínimos: usa una carpeta autorizada, revisa herramientas disponibles y habilita solo las necesarias cuando sea posible. No aceptes una aprobación de herramienta sin entender su efecto. No compartas claves, tokens, información de clientes ni código privado en la consulta. Las opciones de autorización y las políticas pueden variar según la cuenta, el servidor y la organización; consulta la documentación vigente antes de conectar un servicio de trabajo.
Si quieres distinguir conexiones MCP de procedimientos reutilizables, consulta nuestra guía sobre skills de GitHub Copilot. Para el flujo MCP en otro cliente, tienes el tutorial de Copilot MCP en VS Code; y para una explicación del uso del CLI y sus precauciones generales, revisa GitHub Copilot CLI en la terminal. También puedes leer nuestras recomendaciones sobre privacidad de la IA en el trabajo.
Si trabajas en marketing y buscas aplicar IA a tareas profesionales, puedes consultar el curso de IA para marketing de humAIns. Es una formación en IA aplicada al marketing, no un curso de programación ni una formación específica de Copilot CLI. Para valorar tu siguiente paso, completa el diagnóstico gratuito ¿Cuánto te queda?.
Preguntas frecuentes
¿MCP y las skills son lo mismo?
No. MCP da acceso a herramientas o fuentes externas mediante servidores; las skills contienen instrucciones y recursos para procedimientos especializados. Una skill puede explicar cuándo usar un servidor MCP, pero no crea la conexión ni determina sus permisos.
¿El servidor MCP de GitHub ya está incluido?
Sí. GitHub documenta que GitHub MCP viene integrado en Copilot CLI. Este ejemplo añade Microsoft Learn MCP para consultar documentación pública; no modifica ni reemplaza el servidor incorporado.
¿Funciona en Copilot CLI la configuración MCP de VS Code?
No directamente. GitHub CLI no lee .vscode/mcp.json. Usa la configuración de usuario de Copilot CLI o sus archivos de proyecto .mcp.json y .github/mcp.json, teniendo presente la confianza y precedencia descritas en el manual.
¿Cómo compruebo o retiro el servidor?
Ejecuta copilot mcp list y copilot mcp get microsoft-learn para revisar configuración y estado; luego comprueba en una conversación que se invocó la herramienta y verifica el enlace de respuesta. Usa copilot mcp disable microsoft-learn para conservarlo desactivado o copilot mcp remove microsoft-learn para quitar la entrada de usuario.