Skip to main content

Using the GitHub MCP Server

Learn how to use the GitHub Model Context Protocol (MCP) server to extend Copilot Chat.

Nota:

The remote GitHub MCP server is currently in versión preliminar pública and subject to change; use of the GitHub MCP server locally is generally available (GA).

While in versión preliminar pública, access to the remote GitHub MCP server through OAuth in Copilot is governed by the Copilot Editor preview features policy at the organization or enterprise level. PAT access to the server is managed by PAT policies.

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 los servidores MCP remotos crece y hay editores como Visual Studio Code (con OAuth o PAT), Visual Studio (solo PAT), IDE de JetBrains (solo PAT), Xcode (solo PAT), Eclipse (solo PAT), Windsurf (solo PAT) y Cursor (solo PAT) que ya proporcionan esta funcionalidad.

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

Prerequisites

Setting up the GitHub MCP server in Eclipse

The instructions below guide you through setting up the GitHub MCP server in Eclipse. Other MCP-compatible editors may have similar steps, but the exact process may vary.

We recommend setting up the GitHub MCP server remotely. Eclipse only supports using a personal access token (PAT) for authentication with the GitHub MCP server.

Nota:

If you are an Enterprise Managed User with PAT restrictions, you won't be able to use PAT authentication.

For information on setting up the GitHub MCP server locally, see the GitHub MCP server repository.

Remote MCP server configuration with PAT

To configure the remote GitHub MCP server with a PAT, ensure you have created a PAT with the necessary scopes for the access you want to grant to the MCP server. For more information, see Administración de tokens de acceso personal.

  1. To open the Copilot Chat panel, click the Copilot icon () in the status bar at the bottom of Eclipse.
  2. From the menu, select "Edit preferences".
  3. In the left pane, expand GitHub Copilot and click MCP.
  4. Add the following configuration, replacing YOUR_GITHUB_PAT with the PAT you created:
JSON
  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

Using the GitHub MCP server in Eclipse

The GitHub MCP server enables you to perform a wide range of actions on GitHub, via Copilot Chat in Eclipse.

  1. To open the Copilot Chat panel, click the Copilot icon () in the status bar at the bottom of Eclipse, then click Open Chat.
  2. At the bottom of the chat panel, select Agent from the mode dropdown.
  3. To see the available actions, in the Copilot Chat box, click the tools icon.
    • Under github, you will see a list of available actions.
  4. In the Copilot Chat box, type a command or question related to the action you want to perform, and press Enter.
    • For example, you can ask the GitHub MCP server to create a new issue, list pull requests, or retrieve repository information.
  5. The GitHub MCP server will process your request and provide a response in the chat interface.
    • In the Copilot Chat box, you may be asked to give additional permissions or provide more information to complete the action.
  6. Follow the prompts to complete the action.

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.

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 el servidor MCP correctamente en el IDE.
  • 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.

Further reading