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.

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 tu 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