Skip to main content

Añadir servidores MCP para CLI de GitHub Copilot

Amplíe las capacidades de Copilot con la conexión de servidores del Protocolo de Contexto de Modelo (MCP) para proporcionar herramientas y contexto adicionales.

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 proporcionar a Copilot acceso a herramientas externas, fuentes 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 servidor MCP GitHub está integrado en CLI de Copilot y ya está disponible sin ninguna configuración adicional. Los pasos siguientes son para agregar otros servidores MCP.

Puede agregar servidores MCP mediante el comando interactivo /mcp add dentro de la CLI o editando el archivo de configuración directamente.

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

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, Agente de codificación de Copiloty otros 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 Server-Sent Events, que está en desuso en la especificación MCP, pero todavía se admite para la compatibilidad con versiones anteriores. <!-- markdownlint-disable-line GHD046 -->
      
  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.

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 Extensión del agente de codificación de GitHub Copilot con el protocolo de contexto de modelo (MCP).

Administración de servidores MCP

Puede administrar los servidores MCP configurados mediante los siguientes /mcp comandos en CLI de Copilot.

  •         **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 es utilizado por Copilot para la sesión actual.
    
  •         **Habilite un servidor deshabilitado anteriormente:** Use el comando `/mcp enable SERVER-NAME`.
    

Uso de servidores MCP

Una vez que haya agregado un servidor MCP, Copilot puede usar automáticamente las herramientas que proporciona cuando sean relevantes para su solicitud. 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

  •         [AUTOTITLE](/copilot/concepts/about-mcp)
    
  •         [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)
    
  •         [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)