Uso del servidor MCP de GitHub

Nota:

El servidor MCP de GitHub está actualmente en versión preliminar pública y está sujeto a cambios.

Acerca del servidor MCP de GitHub

El servidor MCP de GitHub es un servidor del Protocolo de contexto de modelo (MCP) proporcionado y mantenido por GitHub. MCP te permite integrar funcionalidades de inteligencia artificial con otras herramientas y servicios, lo que mejora la experiencia de desarrollo al proporcionar asistencia de inteligencia artificial con reconocimiento del contexto.

Para más información sobre MCP, consulta la documentación oficial de MCP.

Puedes acceder al servidor MCP de GitHub de forma remota a través de Visual Studio Code, u otros editores que admitan MCP remoto; o bien, puedes ejecutarlo localmente en cualquier editor compatible con MCP, lo que te permite elegir entre la comodidad de una solución hospedada o la personalización de una configuración autohospedada.

Si deseas usar el servidor MCP remoto de GitHub, puedes hacerlo en unos pocos pasos, sin ninguna configuración local. Esto es especialmente útil para los usuarios que desean aprovechar rápidamente las funcionalidades de inteligencia artificial de GitHub sin la sobrecarga de administrar un servidor MCP local.

La ejecución local del servidor MCP de GitHub requiere un poco más de configuración, pero permite una mayor personalización y control sobre las interacciones de IA.

El servidor MCP de GitHub se puede usar para:

Automatizar y optimizar las tareas relacionadas con el código.
Conectar herramientas de terceros (como cursor, windsurf o futuras integraciones) para aprovechar las funcionalidades de contexto e inteligencia artificial de GitHub.
Habilitar los flujos de trabajo basados en la nube que funcionan desde cualquier dispositivo, sin configuración local.

Disponibilidad

Actualmente hay una amplia compatibilidad con servidores MCP locales en clientes como Visual Studio Code, IDE de JetBrains, XCode y otros.

La compatibilidad con servidores MCP remotos está creciendo, con editores como Visual Studio Code (con OAuth o PAT), Visual Studio (solo PAT), Windsurf (solo PAT) y Cursor (solo PAT) que proporcionan esta funcionalidad.

Para averiguar si tu editor preferido admite servidores MCP remotos, consulta la documentación del editor específico.

Requisitos previos

Una cuenta de GitHub.
Visual Studio Code, u otro editor compatible con MCP.

Configuración del servidor MCP de GitHub en Visual Studio Code

Las instrucciones siguientes te guían a través de la configuración del servidor MCP de GitHub en Visual Studio Code. Otros editores compatibles con MCP pueden tener pasos similares, pero el proceso exacto puede variar.

Puedes optar por configurar el servidor MCP de GitHub de forma remota o local, en función de tus necesidades y preferencias. También puedes configurar el servidor MCP de GitHub para:

Un repositorio específico. Esto te permitirá compartir los servidores MCP con cualquiera que abra el proyecto en Visual Studio Code. Para ello, crea un archivo .vscode/mcp.json en la raíz del repositorio.
Tu instancia personal de Visual Studio Code. Serás la única persona que tenga acceso a los servidores MCP configurados. Para ello, agrega la configuración al archivo settings.json en Visual Studio Code. Los servidores MCP configurados de esta manera estarán disponibles en todas las áreas de trabajo.

El servidor MCP remoto de GitHub usa la autenticación de OAuth de un solo clic de forma predeterminada, pero también puedes configurarla manualmente para usar un personal access token (PAT) para la autenticación. Si usas OAuth, el servidor MCP tendrá el mismo acceso que tu cuenta personal. Si usas un PAT, el servidor MCP tendrá acceso a los ámbitos concedidos por el PAT.

Nota:

Si eres un Enterprise Managed User con restricciones de PAT, no podrás usar la autenticación PAT. Si tienes restricciones de directiva de acceso de OAuth, necesitarás que las aplicaciones de OAuth para cada cliente estén habilitadas (excepto Visual Studio Code y Visual Studio).

Configuración remota del servidor MCP con OAuth

Nota:

El servidor MCP de GitHub no está disponible para los usuarios de GitHub Enterprise Server. Si usas GitHub Enterprise Server, puedes instalar localmente el servidor MCP de GitHub. Consulta Configuración del servidor MCP local.

No es necesario crear un PAT ni instalar ningún software adicional para usar el servidor MCP remoto de GitHub con OAuth. Puedes configurarlo directamente en Visual Studio Code. También puedes instalar conjuntos de herramientas individuales, ya sea en modo de solo lectura o con acceso de lectura y escritura completo, lo que te permite adaptar las funcionalidades del servidor a tus necesidades específicas. Para obtener más información, consulta Configuración de la herramienta.

En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).
Escribe: mcp: add server y presiona Entrar.
En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).
En el campo Dirección URL del servidor, escribe https://api.githubcopilot.com/mcp/ y presiona Entrar.
En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.
En Elegir dónde guardar la configuración, selecciona dónde deseas guardar la configuración del servidor MCP.
- Visual Studio Code se abrirá y agregará la configuración al archivo seleccionado en el editor o creará un nuevo archivo si no existe.
En la ventana emergente Visual Studio Code para autorizar el servidor MCP con OAuth, haz clic en Permitir y selecciona tu cuenta personal en la lista.

Configuración remota del servidor MCP con PAT

Para configurar el servidor MCP remoto de GitHub con un PAT, asegúrate de que has creado un PAT con los ámbitos necesarios para el acceso que deseas conceder al servidor MCP. Para más información, consulta Administración de tokens de acceso personal.

Deberás configurar manualmente el servidor MCP en Visual Studio Code para usar el PAT para la autorización.

En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).
Escribe: mcp: add server y presiona Entrar.
En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).
En el campo Dirección URL del servidor, escribe https://api.githubcopilot.com/mcp/ y presiona Entrar.
En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.
En Elegir dónde guardar la configuración, selecciona dónde deseas guardar la configuración del servidor MCP.
- Visual Studio Code se abrirá y agregará la configuración al archivo seleccionado en el editor o creará un nuevo archivo si no existe.
En la ventana emergente Visual Studio Code para rechazar la autorización de OAuth, haz clic en Cancelar.

Tendrás que editar manualmente el archivo de configuración para usar un PAT. En el archivo de configuración, al final de la línea url, agrega lo siguiente:

JSON

    ,
      "headers": {
        "Authorization": "Bearer ${input:github_token}"
      }
    },
  },
  "inputs": [
    {
      "id": "github_token",
      "type": "promptString",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

    ,
      "headers": {
        "Authorization": "Bearer ${input:github_token}"
      }
    },
  },
  "inputs": [
    {
      "id": "github_token",
      "type": "promptString",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

Aparecerá un botón de "Reiniciar" en el archivo. Haz clic en "Reiniciar" para reiniciar el servidor MCP con la nueva configuración.
En la paleta de comandos, verás una solicitud para escribir el token de GitHub. Escribe el PAT que creaste anteriormente y presiona Entrar.
- El servidor MCP ahora se configurará para usar el PAT para la autorización.

Configuración del servidor MCP local

Nota:

Si eres un usuario de GitHub Enterprise Server y tu empresa tiene habilitadas restricciones de PAT, solo puedes usar puntos de conexión de API para ámbitos permitidos por la directiva PAT de tu empresa. Si todos los puntos de conexión de API están restringidos, no podrás usar el servidor MCP. Si no estás seguro acerca de la directiva PAT de tu empresa, ponte en contacto con el administrador de la empresa para obtener más información.

El uso de un servidor MCP de GitHub localmente requiere tener Docker instalado y ejecutándose en la máquina. Además, solo puedes autenticarte con un PAT, ya que OAuth no es compatible con los servidores MCP locales.

Asegúrate de que tienes Docker instalado y ejecutándose en la máquina. Consulta Instrucciones de instalación de Docker.
Crea un PAT con (al menos) los ámbitos read:packages y repo. Para más información, consulta Administración de tokens de acceso personal.

Decide si deseas configurar el servidor MCP para un repositorio específico o para la instancia personal de Visual Studio Code.

Si usas un repositorio específico, abre el archivo .vscode/mcp.json en Visual Studio Code y agrega la siguiente configuración:

JSON

   {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }

   {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }

Si usas tu instancia personal de Visual Studio Code, abre el archivo settings.json en Visual Studio Code:
- Presiona Ctrl+Mayús+P (Windows/Linux) o Cmd+Mayús+P (macOS).
- Escribe Preferencias: abrir Configuración (JSON) y selecciónala.
- Agregue la siguiente configuración:

JSON

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }
}

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "github_token",
        "description": "GitHub Personal Access Token",
        "password": true
      }
    ],
    "servers": {
      "github": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "GITHUB_PERSONAL_ACCESS_TOKEN",
          "ghcr.io/github/github-mcp-server"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
        }
      }
    }
  }
}

Guarde el archivo.
En la paleta de comandos, verás una solicitud para escribir el token de GitHub. Escribe el PAT que creaste anteriormente y presiona Entrar.
- El servidor MCP ahora se configurará para que se ejecute localmente con el PAT para la autorización.

Configuración de herramientas

El servidor MCP de GitHub admite la instalación de conjuntos de herramientas individuales, ya sea en modo de solo lectura o con acceso de lectura y escritura completo, lo que te permite adaptar las funcionalidades del servidor a tus necesidades específicas. Para ver las opciones de instalación con un solo clic de cada conjunto de herramientas, consulta el repositorio del servidor MCP de GitHub.

Uso del servidor MCP de GitHub en Visual Studio Code

El servidor MCP de GitHub te permite realizar una amplia gama de acciones en GitHub, mediante Copilot Chat en Visual Studio Code.

Para abrir Copilot Chat haz clic en el icono de la barra de título de Visual Studio Code.
En el cuadro Copilot Chat, selecciona Agent en el menú emergente.
Para ver las acciones disponibles, en el cuadro Copilot Chat, haz clic en el icono Seleccionar herramientas.
- En la lista desplegable Herramientas, en Servidor MCP:GitHub, verás una lista de acciones disponibles.
En el cuadro Copilot Chat, escribe un comando o una pregunta relacionados con la acción que deseas realizar y presiona Entrar.
- Por ejemplo, puedes pedir al servidor MCP de GitHub que cree una nueva propuesta, enumere solicitudes de incorporación de cambios o recupere información del repositorio.
El servidor MCP de GitHub procesará la solicitud y proporcionará una respuesta en la interfaz de chat.
- En el cuadro Copilot Chat, es posible que se te pida que proporciones permisos adicionales o proporciones más información para completar la acción.
Sigue las instrucciones que aparecen para completar la acción.

Solución de problemas

Si tienes problemas al usar el servidor MCP de GitHub, hay algunos pasos comunes de solución de problemas que puedes seguir.

Problemas de autorización

Si tienes problemas para autorizar el servidor MCP, asegúrate de que:

Has iniciado sesión en GitHub en el IDE de tu elección.

Si te estás autenticando con un personal access token (PAT), asegúrate de que:

El PAT de GitHub es válido y tiene los ámbitos necesarios para las acciones que deseas realizar.
Has escrito el PAT correcto cuando se te solicita en Visual Studio Code.

Problemas del modo de agente de Copilot

Si tienes problemas con el modo de agente de Copilot Chat, asegúrate de que:

Has seleccionado el agente correcto en el cuadro Copilot Chat.
Has configurado correctamente el servidor MCP en Visual Studio Code.
Tienes los permisos necesarios para realizar las acciones que intentas ejecutar.

Sugerencias generales

Si tienes otros problemas con el servidor MCP de GitHub, estas son algunas sugerencias generales que te ayudarán a solucionar los problemas:

Comprueba los registros de salida del servidor MCP para ver los mensajes de error.
Si ejecutas el servidor MCP localmente, asegúrate de que el entorno local esté configurado correctamente para ejecutar contenedores de Docker.
Intenta reiniciar el servidor MCP o el IDE.

Información adicional

Extensión del agente de codificación de Copilot con el protocolo de contexto de modelo (MCP)

En este artículo