Adición de servidores MCP para CLI de GitHub Copilot

Extienda las capacidades de Copilot conectando servidores del Protocolo de Contexto de Modelo (MCP) para proporcionar herramientas y contexto adicionales.

En este artículo

El Protocolo de contexto de modelo (MCP) es un estándar abierto que define cómo las aplicaciones comparten contexto con modelos de lenguaje grandes (LLM). Puede conectar servidores MCP a CLI de GitHub Copilot para otorgar Copilot acceso a herramientas externas, orígenes de datos y servicios. Para obtener información general sobre MCP, consulta Acerca del Protocolo de contexto de modelo (MCP).

Adición de un servidor MCP

Nota:

El GitHub servidor MCP está integrado CLI de Copilot y ya está disponible sin ninguna configuración adicional. Los pasos siguientes son para agregar otros servidores MCP.

Si su organización o empresa ha configurado una dirección URL del Registro y una directiva de lista de permitidos, esas opciones se aplican a CLI de Copilot. La dirección URL del Registro configurada aparecerá como origen de detección y solo se pueden ejecutar los servidores permitidos por la directiva de lista de permitidos.

Puede agregar servidores MCP de las maneras siguientes:

Para obtener instrucciones de instalación, herramientas disponibles y direcciones URL para servidores MCP específicos, consulte el GitHub Registro de MCP.

Usar el comando /mcp add

  1. En modo interactivo, escriba /mcp add. Se muestra un formulario de configuración. Use tab para navegar entre campos.

  2. Junto a Nombre del servidor, escriba un nombre único para el servidor MCP. Este es el nombre que usará para hacer referencia al servidor.

  3. Junto a Tipo de servidor, seleccione un tipo presionando el número correspondiente. Están disponibles los siguientes tipos:

    • Local o STDIO: inicia un proceso local y se comunica a través de la entrada y salida estándar (stdin/stdout). Ambas opciones funcionan de la misma manera. STDIO es el nombre de tipo de protocolo MCP estándar, por lo que elija esto si desea que la configuración sea compatible con VS Code, y agente en la nube de Copilototros clientes MCP.
    • HTTP o SSE: se conecta a un servidor MCP remoto. HTTP usa el transporte HTTP que se puede transmitir. SSE usa el HTTP heredado con el transporte de eventos enviados por el servidor, que está en desuso en la especificación de MCP, pero todavía se admite para la compatibilidad con versiones anteriores.

  4. Los campos restantes dependen del tipo de servidor seleccionado:

    • Si eligió Local o STDIO:

      • Junto a Comando, escriba el comando para iniciar el servidor, incluidos los argumentos. Por ejemplo: npx @playwright/mcp@latest. Esto corresponde a las propiedades command y args del archivo de configuración JSON.
      • Junto a Variables de entorno, especifique opcionalmente las variables de entorno que necesita el servidor, como claves de API o tokens, como pares clave-valor JSON. Por ejemplo: {"API_KEY": "YOUR-API-KEY"}. La PATH variable se hereda automáticamente del entorno. Todas las demás variables de entorno deben configurarse aquí.

    • Si eligió HTTP o SSE:

      • Junto a DIRECCIÓN URL, pegue la dirección URL del servidor remoto. Por ejemplo: https://mcp.context7.com/mcp.
      • Junto a Encabezados HTTP, opcionalmente especifique encabezados HTTP como JSON. Por ejemplo: {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

  5. Junto a Herramientas, especifique qué herramientas del servidor deben estar disponibles. Escriba * para incluir todas las herramientas o proporcione una lista separada por comas de nombres de herramientas (sin comillas necesarias). El valor predeterminado es *.

  6. Presione Ctrl+S para guardar la configuración. El servidor MCP se agrega y está disponible inmediatamente sin reiniciar la CLI.

Uso del copilot mcp add subcomando

Puede agregar servidores MCP desde el terminal mediante el copilot mcp add subcomando, sin entrar en modo interactivo. El servidor se agrega a la configuración de usuario en ~/.copilot/mcp-config.json.

Para los servidores locales (stdio), proporcione el comando después de --:

Shell
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

Para los servidores remotos (HTTP/SSE), especifique el transporte y proporcione la dirección URL:

Shell
copilot mcp add --transport http SERVER-NAME URL

También puede pasar opciones adicionales:

  • --env KEY=VALUE: establezca variables de entorno para el servidor. Repita la repetición para varias variables.
  • --header "HEADER: VALUE": establezca encabezados HTTP para servidores remotos. Repita esto para varios encabezados.
  • --transport TRANSPORT: establezca el tipo de transporte (stdio, httpo sse). El valor predeterminado es stdio.
  • --tools TOOLS: especifique las herramientas que se van a habilitar. Use * para todas las herramientas (valor predeterminado), una lista separada por comas o "" para ninguna.
  • --timeout MS: establece un tiempo de espera en milisegundos.

Ejemplos

Agregue un servidor stdio local:

Shell
copilot mcp add context7 -- npx -y @upstash/context7-mcp

Agregue un servidor local con variables de entorno:

Shell
copilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Agregue un servidor HTTP remoto:

Shell
copilot mcp add --transport http notion \
  https://mcp.notion.com/mcp

Agregue un servidor remoto con un encabezado de autorización:

Shell
copilot mcp add --transport http \
  --header "Authorization: Bearer YOUR-TOKEN" \
  stripe https://mcp.stripe.com

Edición del archivo de configuración

También puede agregar servidores MCP editando el archivo de configuración en ~/.copilot/mcp-config.json. Esto resulta útil si desea compartir configuraciones o agregar varios servidores a la vez.

En el ejemplo siguiente se muestra un archivo de configuración con un servidor local y un servidor HTTP remoto:

JSON
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

Para obtener más información sobre la configuración del servidor MCP, consulte Configuración de servidores MCP para el repositorio.

Adición de servidores MCP por repositorio

Puede configurar servidores MCP para un proyecto específico agregando un archivo JSON al repositorio. Esto es útil cuando quieres que los servidores solo estén disponibles mientras trabajas en ese proyecto, o cuando quieres compartir una configuración de MCP con colaboradores haciendo commit de ella en el repositorio.

CLI de Copilot busca la configuración de nivel de proyecto en las siguientes ubicaciones:

CaminoUso recomendado
.mcp.json (en cualquier directorio del directorio de trabajo hasta la raíz del repositorio)Configuración local o por extracción; habitualmente ubicada en la raíz del proyecto.
.github/mcp.jsonConfiguración compartida que se registra en el repositorio

Cuando empiece CLI de Copilot dentro de un repositorio de Git, la CLI le guiará desde el directorio de trabajo actual hasta la raíz del repositorio y carga los archivos de configuración de MCP a lo largo del proceso. Si ambos .mcp.json y .github/mcp.json existen en el mismo directorio, .mcp.json tiene prioridad. Cuando los nombres de servidor entran en conflicto, las definiciones de archivos más cerca del directorio de trabajo tienen prioridad. Las definiciones de nivel de proyecto también tienen prioridad sobre las de ~/.copilot/mcp-config.json. Para obtener más información sobre la confianza relativa, consulte Referencia de comandos de la CLI de GitHub Copilot.

Los archivos a nivel de proyecto pueden usar el objeto de nivel superior mcpServers que se muestra en ~/.copilot/mcp-config.json, o el formato simple de nivel superior, donde cada clave es el nombre de un servidor MCP. Por ejemplo, esta configuración usa el mcpServers objeto :

JSON
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

El mismo servidor también se puede configurar con el formato simple de nivel superior:

JSON
{
  "playwright": {
    "type": "local",
    "command": "npx",
    "args": ["@playwright/mcp@latest"]
  }
}

Nota:

Los servidores MCP a nivel de proyecto solo se cargan después de que confirmes que la carpeta es de confianza al iniciar por primera vez. Se omiten silenciosamente en directorios que no son de confianza. Para obtener más información sobre la confianza de carpetas, consulte Acerca de GitHub Copilot CLI.

En el modo de aviso (copilot -p), los servidores MCP de nivel de proyecto se cargan automáticamente si el directorio actual ya es de confianza. Si el directorio no es de confianza, los servidores MCP de nivel de proyecto se omiten de forma predeterminada. Para cargarlos de todos modos, establezca la variable de entorno GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP en true, ya que el modo de prompt no puede mostrar un aviso de confianza interactivo. Para obtener más información, vea Referencia de comandos de la CLI de GitHub Copilot.

El .vscode/mcp.json archivo de VS Code no es leído por CLI de Copilot. Usa la clave serversde nivel superior no admitida. Para migrar un existente .vscode/mcp.json a un formato que acepta la CLI, consulte Referencia de comandos de la CLI de GitHub Copilot.

Búsqueda e instalación desde el registro

Nota:

El /mcp search comando es actualmente una característica experimental. Para usarlo, comience CLI de Copilot con la opción de --experimental línea de comandos o escriba /experimental on durante una sesión.

Puede detectar e instalar servidores MCP directamente desde el GitHub Registro de MCP mediante el /mcp search comando en modo interactivo. Esto le permite examinar los servidores disponibles, ver sus detalles e instalarlos sin rellenar manualmente el formulario de configuración.

Si su organización ha configurado una dirección URL del registro de MCP personalizada, /mcp search se conecta a ese registro en lugar del registro predeterminado GitHub .

  1. En modo interactivo, escriba /mcp search para examinar los servidores superiores por estrellas o /mcp search QUERY para buscar un servidor específico. Por ejemplo:

    /mcp search context7

  2. Se muestra una lista navegable con teclado de servidores coincidentes. Use las teclas de dirección para examinar los resultados.

  3. Seleccione un servidor para abrir su formulario de configuración. El formulario se rellena previamente con la configuración del servidor del Registro. Rellene los campos obligatorios, como claves de API o tokens.

  4. Presione Ctrl+S para guardar. El servidor se agrega a su mcp-config.json y se inicia inmediatamente.

Administración de servidores MCP

Puede administrar los servidores MCP configurados mediante los /mcp comandos en modo interactivo o los copilot mcp subcomandos desde el terminal.

Uso de comandos /mcp en modo interactivo

  • Enumerar servidores MCP configurados: Use el comando /mcp show. Esto muestra todos los servidores MCP configurados y su estado actual.

  • Ver detalles sobre un servidor específico: Use el comando /mcp show SERVER-NAME. Esto muestra el estado del servidor especificado y la lista de herramientas que proporciona.

  • Edite la configuración de un servidor: Use el comando /mcp edit SERVER-NAME.

  • Eliminar un servidor: Use el comando /mcp delete SERVER-NAME.

  • Deshabilitar un servidor: Use el comando /mcp disable SERVER-NAME. Un servidor deshabilitado permanece configurado, pero no lo usa Copilot para la sesión actual.

  • Habilite un servidor deshabilitado anteriormente: Use el comando /mcp enable SERVER-NAME.

Uso copilot mcp de subcomandos desde el terminal

También puede administrar servidores MCP desde el terminal sin entrar en modo interactivo.

  • Enumerar todos los servidores configurados:

    Shell
    copilot mcp list

    Enumera los servidores de todos los orígenes de configuración (usuario, área de trabajo y complemento). Agregue --json para la salida JSON.

  • Ver los detalles del servidor:

    Shell
    copilot mcp get SERVER-NAME

    Muestra el tipo, el estado y las herramientas disponibles de un servidor. Agregue --json para la salida JSON.

  • Quitar un servidor:

    Shell
    copilot mcp remove SERVER-NAME

    Quita el servidor de la configuración del usuario.

Uso de servidores MCP

Una vez que haya agregado un servidor MCP, Copilot puede usar automáticamente las herramientas que proporciona cuando sea pertinente para el mensaje. También puede hacer referencia directamente a un servidor MCP y herramientas específicas en un mensaje para asegurarse de que se usan.

Lectura adicional