GitHub Copilot CLI: MCP, instrucciones e historial de sesiones

Por CodeAgentSwarm · Actualizado el 31 de octubre de 2026

Los servidores MCP dan a GitHub Copilot CLI herramientas extra, los archivos de instrucciones le cuentan cómo funciona tu proyecto y las sesiones guardadas te dejan seguir donde lo dejaste. Esta guía explica dónde vive cada cosa y qué comandos sirven para comprobarla. La probamos con Copilot CLI 1.0.93 el 8 de octubre de 2026.

Comprueba qué cargará una sesión

GitHub Copilot CLI

Con tres comandos resuelves casi todas las dudas antes de empezar: qué servidores MCP hay configurados, qué archivos de instrucciones se aplican en esta carpeta y cómo seguir con tu última sesión. Si todavía no tienes Copilot instalado, empieza por cómo instalar y usar GitHub Copilot CLI.

bash
copilot mcp list
copilot instruction list
copilot --continue

Todo lo que verás aquí vive dentro de ~/.copilot, salvo que definas COPILOT_HOME, que mueve la carpeta entera.

Añade un servidor MCP en mcp-config.json

Tus servidores MCP personales van en ~/.copilot/mcp-config.json, dentro de la clave mcpServers. Un servidor local es un proceso que corre en tu equipo y se comunica por stdio, así que necesita type: "local", el command que lo arranca y sus args. Este es el ejemplo de la documentación de GitHub:

json
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    }
  }
}

"tools": ["*"] expone todas las herramientas del servidor. Si pones nombres concretos, solo verá esos. Fuente: Adding MCP servers for GitHub Copilot CLI, revisada el 8 de octubre de 2026.

Cómo añadir un servidor MCP desde la línea de comandos

Si prefieres no tocar el JSON, copilot mcp add escribe en el mismo archivo de usuario por ti. Pon el comando de un servidor local después de --, o usa --transport http y una URL para uno remoto.

bash
# Servidor local (stdio)
copilot mcp add playwright -- npx @playwright/mcp@latest

# Servidor remoto (HTTP)
copilot mcp add --transport http docs https://your-mcp-server.example/mcp

# Comprueba el resultado
copilot mcp list
copilot mcp get playwright

En la 1.0.93, copilot mcp add también acepta --env CLAVE=VALOR y --header, que puedes repetir, y --tools con "*" para todas las herramientas, una lista separada por comas o "" para ninguna. Más adelante gestionas el servidor con copilot mcp enable, disable y remove. Dentro de una sesión, /mcp abre un panel con cada servidor y su estado, y /mcp list muestra lo mismo como texto.

La URL HTTP del ejemplo es inventada, no un servicio real. Añade solo servidores de confianza y no dejes tokens en archivos que vayas a subir al repositorio. Añadir un servidor no aprueba sus acciones: Copilot sigue preguntando antes de usar sus herramientas salvo que las permitas, como explica el modo YOLO de GitHub Copilot CLI.

Dónde puede vivir la configuración MCP

OrigenDóndePara qué
Usuario~/.copilot/mcp-config.jsonServidores que quieres en todos los proyectos
Proyecto, local.mcp.json en el proyectoAjustes de una sola copia del repositorio
Proyecto, compartido.github/mcp.json en el proyectoConfiguración que subes al repositorio para el equipo
Una sesión--additional-mcp-configProbar un servidor sin guardarlo

Los plugins también pueden traer sus propios servidores. --additional-mcp-config admite una cadena JSON o la ruta de un archivo precedida de @, se puede repetir y se suma a tu configuración de usuario solo durante esa sesión.

bash
copilot --additional-mcp-config @./extra-mcp.json
copilot --disable-mcp-server playwright
copilot --disable-builtin-mcps

El servidor MCP de GitHub integrado

Copilot CLI trae el servidor MCP de GitHub ya conectado, así que las herramientas de GitHub están disponibles sin configurar nada. Por defecto la CLI recibe solo una parte de esas herramientas; --enable-all-github-mcp-tools activa el resto (según copilot help en la 1.0.93). --disable-builtin-mcps apaga todos los servidores integrados, que en la 1.0.93 son github-mcp-server y githubiq. Para quitar uno solo, usa --disable-mcp-server con su nombre.

Instrucciones propias: copilot-instructions.md y AGENTS.md

ArchivoA quién se aplica
~/.copilot/copilot-instructions.mdA ti, en todos los proyectos
.github/copilot-instructions.mdA todo el que trabaje en el repositorio
.github/instructions/**/*.instructions.mdAl repositorio, repartido en varios archivos
AGENTS.md, CLAUDE.md, GEMINI.mdAl repositorio, compartido con otros agentes

Copilot lee las instrucciones del repositorio desde la raíz de git y desde tu carpeta actual. Ojo con un detalle: un AGENTS.md en tu carpeta personal no se carga, así que tus reglas personales van en copilot-instructions.md. COPILOT_CUSTOM_INSTRUCTIONS_DIRS añade más carpetas y --no-custom-instructions arranca una sesión sin ninguna. Fuente: Adding custom instructions for GitHub Copilot CLI, revisada el 8 de octubre de 2026.

bash
copilot instruction list

Carpetas de skills

  • Skills del proyecto: .github/skills/, .agents/skills/ o .claude/skills/.
  • Skills personales: ~/.copilot/skills/ o ~/.agents/skills/.
  • Se gestionan con copilot skill list, add, remove, enable y disable.

Como Copilot también lee .claude/skills/ y .agents/skills/, un proyecto puede tener un único juego de skills para varios agentes. Mira cómo compartir skills entre agentes.

Dónde se guardan las sesiones y cómo reanudarlas

Cada sesión tiene su propia carpeta. workspace.yaml guarda el ID, la carpeta de trabajo, el nombre y las fechas; events.jsonl guarda la conversación.

text
~/.copilot/session-state/<id-de-sesion>/
  workspace.yaml
  events.jsonl
ComandoQué hace
copilot --resumeAbre un selector con tus sesiones guardadas
copilot --resume=<valor>Reanuda por ID de sesión, prefijo del ID de 7 o más caracteres hexadecimales o nombre exacto (sin distinguir mayúsculas)
copilot --continueReanuda la sesión más reciente
copilot --session-id=<uuid>Reanuda esa sesión o usa el UUID para una nueva
copilot -n "mi tarea"Pone nombre a una sesión nueva para reanudarla luego por nombre
Según copilot help en GitHub Copilot CLI 1.0.93.

Dentro de una sesión, /rename le cambia el nombre. copilot sessions import importa una sesión guardada en JSONL. Añade --allow-all-tools al comando de reanudar solo si quieres que esa sesión use herramientas sin preguntarte.

Busca y reabre sesiones en CodeAgentSwarm

El soporte de GitHub Copilot CLI llega en CodeAgentSwarm 2.5.0, en beta. Con ella, el historial de conversaciones muestra tus sesiones de Copilot junto a las de tus otros agentes. Puedes filtrar por agente y proyecto, buscar dentro de los mensajes, guardar una conversación en marcadores y reabrirla en Chat o en la terminal.

Conversaciones de GitHub Copilot CLI filtradas en el historial de CodeAgentSwarm
Captura real de CodeAgentSwarm, tomada durante el desarrollo de la 2.5.0, con una conversación de ejemplo creada para pruebas.

Los turnos de un subagente quedan dentro de la sesión que lo lanzó, así que cada fila es una conversación que puedes reanudar. Una sesión iniciada en Chat continúa en la terminal con copilot --resume. La primera vez que Copilot se abre en una carpeta, te pregunta si confías en ella; contesta una vez o pide que recuerde la carpeta.

Conversación de Chat reanudada en la terminal de GitHub Copilot CLI con la pregunta de confianza en la carpeta
Captura real de CodeAgentSwarm, tomada durante el desarrollo de la 2.5.0: la sesión iniciada en Chat continúa en la terminal y Copilot pide confianza en la carpeta.

También puedes guardar una sesión como atajo y limpiar sesiones antiguas conversación a conversación.

La entrada MCP de CodeAgentSwarm es opcional

Si lo permites en Settings > Privacy, CodeAgentSwarm añade sus herramientas de tareas y títulos como una entrada en ~/.copilot/mcp-config.json y una sección breve en copilot-instructions.md. Tus servidores no cambian.

Al desactivar la opción solo se quita la entrada de CodeAgentSwarm. Copilot funciona igual sin ella. Si tu organización de GitHub desactiva los servidores MCP de terceros para Copilot, Copilot solo arranca el servidor integrado de GitHub, así que faltan las herramientas de CodeAgentSwarm y la app te avisa en el Chat. Para usarlas, inicia sesión con una cuenta que permita servidores MCP.

Para modelos y uso mensual, lee modelos, créditos de IA y límites de GitHub Copilot CLI. Para tener varias sesiones de Copilot a la vez, mira la guía del enjambre de agentes con GitHub Copilot CLI.

Preguntas frecuentes

¿Dónde está el archivo de configuración MCP de GitHub Copilot CLI?

Tus servidores personales están en ~/.copilot/mcp-config.json. Un proyecto puede añadir .mcp.json o .github/mcp.json. Ejecuta copilot mcp list para ver todos los servidores que cargará una sesión.

¿Tengo que añadir yo el servidor MCP de GitHub?

No. Viene integrado y funciona sin configurar nada. Arranca Copilot con --disable-builtin-mcps si quieres una sesión sin él.

¿Copilot CLI lee AGENTS.md?

Sí, el del repositorio: en la raíz de git y en tu carpeta actual. Un AGENTS.md en tu carpeta personal no se carga; para instrucciones personales usa ~/.copilot/copilot-instructions.md.

¿Cómo reanudo una sesión de GitHub Copilot CLI?

Ejecuta copilot --continue para la sesión más reciente, copilot --resume para elegir una de la lista, o copilot --resume con un ID, un prefijo del ID o un nombre para una concreta.

¿CodeAgentSwarm puede reabrir sesiones que empecé en la terminal?

Sí, a partir de la 2.5.0. El historial de conversaciones muestra las sesiones de Copilot, busca en sus mensajes y reabre cualquiera en Chat o en la terminal.