Uso del servidor MCP de GitHub

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 obtener una introducción completa al servidor MCP de GitHub y una introducción a MCP, consulta Acerca del Protocolo de contexto de modelo (MCP).

Requisitos previos

• Una cuenta de GitHub.
• Visual Studio Code, u otro editor compatible con MCP.
• If you are a member of an organization or enterprise with a Copilot para empresas or Copilot para empresas plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.

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 solo puede acceder a los ámbitos que apruebes durante el inicio de sesión. En contextos propiedad de la organización, el acceso también puede estar limitado por directivas de administrador que controlan qué ámbitos y aplicaciones se permiten. Si usas un PAT, el servidor MCP tendrá acceso a los ámbitos concedidos por el PAT, que también está sujeto a las restricciones de PAT configuradas por la organización.

Si eres un Enterprise Managed User, PAT está deshabilitado de forma predeterminada, a menos que lo habilite un administrador de empresa. Si PAT está deshabilitado, 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 (aplicación host MCP) estén habilitadas (excepto Visual Studio Code y Visual Studio ya que son IDE de Microsoft propios con la integración nativa de Copilot).

• Configuración remota del servidor MCP con OAuth
• Configuración remota del servidor MCP con PAT
• Configuración del servidor MCP local

Configuración remota del servidor MCP con OAuth

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.

1. En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).

2. Escribe: mcp: add server y presiona Entrar.

3. En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).

4. En el campo Dirección URL del servidor, escribe https://api.githubcopilot.com/mcp/ y presiona Entrar.

5. En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.

6. 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.

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

1. En Visual Studio Code, abre la paleta de comandos presionando Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+P (Mac).

2. Escribe: mcp: add server y presiona Entrar.

3. En la lista, selecciona HTTP (HTTP o Eventos enviados por el servidor).

4. En el campo Dirección URL del servidor, escribe https://api.githubcopilot.com/mcp/ y presiona Entrar.

5. En Introducir id. de servidor, presiona Entrar para usar el identificador de servidor predeterminado o escribe un identificador de servidor personalizado.

6. 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.

7. En la ventana emergente Visual Studio Code para rechazar la autorización de OAuth, haz clic en Cancelar.

8. 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
       }
     ]
   }
   

9. Aparecerá un botón de "Reiniciar" en el archivo. Haz clic en "Reiniciar" para reiniciar el servidor MCP con la nueva configuración.

   

10. 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

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.

1. Asegúrate de que tienes Docker instalado y ejecutándose en la máquina. Consulta Instrucciones de instalación de Docker.

2. 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.

3. 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}"
           }
         }
       }
     }
   

   • 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}"
           }
         }
       }
     }
   }
   

4. Guarde el archivo.

5. 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.

1. Para abrir Copilot Chat haz clic en el icono de la barra de título de Visual Studio Code.
2. En el cuadro Copilot Chat, selecciona Agent en el menú emergente.
3. Para ver las acciones disponibles, en el cuadro Copilot Chat, haz clic en el icono Seleccionar herramientas.
   • En la lista desplegable Tools, en MCP Server: GitHub, verás una lista de acciones disponibles.
4. 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.
5. 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.
6. 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.

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.

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }