Skip to main content

Configuración del servidor MCP de GitHub para GitHub Enterprise

Aprenda a configurar el servidor de protocolo de contexto de modelo (MCP) de GitHub para que funcione con GitHub Enterprise Server o Nube de GitHub Enterprise con residencia de datos.

El GitHub servidor MCP se puede configurar para que funcione con GitHub Enterprise Server y Nube de GitHub Enterprise con residencia de datos. Los pasos de configuración difieren en función de si usa el servidor MCP remoto o local.

Acerca de la configuración del servidor MCP empresarial

El GitHub servidor MCP admite dos tipos de implementación empresarial:


          [
          Nube de GitHub Enterprise con residencia de datos
          ](#configuring-the-remote-mcp-server-for-github-enterprise-cloud-with-data-residency)
          **: admite configuraciones de servidor MCP remotas y locales.

          [
          GitHub Enterprise Server
          ](#configuring-the-local-mcp-server-for-enterprise)
          **: **solo admite la configuración del servidor MCP local**.

Importante

          GitHub Enterprise Server
          **no** admite el hospedaje remoto del servidor MCP. Si usa GitHub Enterprise Server, **debe** usar la configuración del servidor MCP local que se describe en [Configuración del servidor MCP local para empresas](#configuring-the-local-mcp-server-for-enterprise). Omita la sección de configuración remota del servidor MCP a continuación.

Prerrequisitos

  • Una instancia de GitHub Enterprise Server o una cuenta de GitHub Enterprise Cloud con residencia de datos
  • Servidor GitHub MCP configurado en el editor. Consulte Configuración del servidor MCP de GitHub.

Configuración del servidor MCP remoto para Nube de GitHub Enterprise con residencia de datos

Nota:

Esta sección solo se aplica a Nube de GitHub Enterprise con residencia de datos. Si usa GitHub Enterprise Server, pase a Configuración del servidor MCP local para empresas.

          Nube de GitHub Enterprise con residencia de datos puede usar el servidor MCP remoto. Para configurarlo, debe actualizar la dirección URL del servidor MCP para que apunte a la GitHub Enterprise Cloud instancia.

Por ejemplo, si la GitHub Enterprise Cloud instancia es https://octocorp.ghe.com, la dirección URL del servidor MCP sería https://copilot-api.octocorp.ghe.com/mcp.

  1. En Visual Studio Code, Abra la paleta de comandos presionando Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Escriba y seleccione MCP: Abra Configuración de usuario.

  3. En el archivo de configuración, busque la servers sección . Si ya ha configurado el GitHub servidor MCP, verá una github entrada.

  4. Actualice el campo url para que apunte a la instancia GitHub Enterprise Cloud.

           **Opción A: con autenticación PAT**
    
    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:github_mcp_pat}"
          }
        }
      },
      "inputs": [
        {
          "type": "promptString",
          "id": "github_mcp_pat",
          "description": "GitHub PAT",
          "password": true
        }
      ]
    }
    
           **Opción B: Con la autenticación de OAuth**
    
    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
        }
      }
    }
    

    Reemplace SUBDOMAIN.ghe.com con su subdominio GHE.com.

  5. Guarde el archivo.

  6. Al usar OAuth con Nube de GitHub Enterprise con residencia de datos, configura tus VS Code ajustes para que apunten a tu GitHub Enterprise Cloud instancia. Agregue lo siguiente a la VS Code configuración del usuario:

    {
      "github-enterprise.uri": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
    }
    
  7. Reinicie Visual Studio Code o vuelva a cargar la ventana para que los cambios surtan efecto.

          GitHub Enterprise Cloud con la residencia de datos puede usar el servidor MCP remoto. Para configurarlo, debe actualizar la dirección URL del servidor MCP para que apunte a la GitHub Enterprise Cloud instancia.

Por ejemplo, si la GitHub Enterprise Cloud instancia es https://octocorp.ghe.com, la dirección URL del servidor MCP sería https://copilot-api.octocorp.ghe.com/mcp.

  1. En la barra de Visual Studio menús, haga clic en Ver y, a continuación, haga clic en Copilot Chat de GitHub.
  2. En la parte inferior del panel de chat, selecciona Agent en la lista desplegable de modo.
  3. En la Chat de Copiloto ventana, haga clic en el icono de herramientas y, a continuación, haga clic en el icono más de la ventana del selector de herramientas.
  4. En la ventana emergente "Configurar servidor MCP", rellena los campos.
    1. Para "Id. de servidor", escribe github.
    2. En "Tipo", selecciona "HTTP/SSE" en la lista desplegable.
    3. En "URL", escriba https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp, reemplazando YOURSUBDOMAIN por el GitHub Enterprise Cloud subdominio.
    4. Agregue un nuevo encabezado en "Encabezados", llamado "Autorización" y establézcalo en el valor Bearer YOUR_GITHUB_PAT, reemplazando "YOUR_GITHUB_PAT" por personal access token.
  5. Haz clic en Guardar.
          GitHub Enterprise Cloud con la residencia de datos puede usar el servidor MCP remoto. Para configurarlo, debe actualizar la dirección URL del servidor MCP para que apunte a la GitHub Enterprise Cloud instancia.

Por ejemplo, si la GitHub Enterprise Cloud instancia es https://octocorp.ghe.com, la dirección URL del servidor MCP sería https://copilot-api.octocorp.ghe.com/mcp.

  1. En la esquina inferior derecha, haz clic en .

  2. En el menú, selecciona "Open Chat", asegúrate de que estás en modo Agente y, después, haz clic en el icono de herramientas (denominado "Configure your MCP server") en la parte inferior de la ventana de chat.

  3. Haz clic en Add MCP Tools.

  4. En el mcp.json archivo, agregue la siguiente configuración, reemplazando YOURSUBDOMAIN por el GitHub Enterprise Cloud subdominio y YOUR_GITHUB_PAT por personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud con la residencia de datos puede usar el servidor MCP remoto. Para configurarlo, debe actualizar la dirección URL del servidor MCP para que apunte a la GitHub Enterprise Cloud instancia.

Por ejemplo, si la GitHub Enterprise Cloud instancia es https://octocorp.ghe.com, la dirección URL del servidor MCP sería https://copilot-api.octocorp.ghe.com/mcp.

  1. Abre GitHub Copilot para la extensión Xcode y ve a "Settings".

    • Como alternativa, en un área de trabajo activa de Xcode, puedes encontrar los valores si haces clic en Editor en la barra de menús, seleccionas GitHub Copilot y, después, haces clic en Open GitHub Copilot for Xcode Settings.
  2. Selecciona la pestaña MCP y, después, haz clic en Edit Config.

  3. Agregue la siguiente configuración, reemplazando YOURSUBDOMAIN por el GitHub Enterprise Cloud subdominio y YOUR_GITHUB_PAT por personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud con la residencia de datos puede usar el servidor MCP remoto. Para configurarlo, debe actualizar la dirección URL del servidor MCP para que apunte a la GitHub Enterprise Cloud instancia.

Por ejemplo, si la GitHub Enterprise Cloud instancia es https://octocorp.ghe.com, la dirección URL del servidor MCP sería https://copilot-api.octocorp.ghe.com/mcp.

  1. Haz clic en el icono Copilot () en la barra de estado de la parte inferior de Eclipse.

  2. En el menú, selecciona Open Chat y, en la ventana de chat, haz clic en el icono "Configure Tools...".

    • Como alternativa, puedes seleccionar Edit preferences, después en el panel de la izquierda expandir GitHub Copilot y hacer clic en MCP.
  3. Agregue la siguiente configuración en "Configuraciones de servidor", reemplazando YOURSUBDOMAIN por el GitHub Enterprise Cloud subdominio y YOUR_GITHUB_PAT por personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
  4. Haga clic en Aplicar.

Configuración del servidor MCP local para empresas

Tanto GitHub Enterprise Server como GitHub Enterprise Cloud con residencia de datos soportan el servidor MCP local. Puede configurar el servidor local mediante la GITHUB_HOST variable de entorno o la marca de --gh-host línea de comandos.

Consideraciones importantes

  • Para GitHub Enterprise Server: Prefije el nombre de host con el https:// esquema URI, ya que, de lo contrario, tiene http:// como valor predeterminado, que GitHub Enterprise Server no admite.
  • Para GitHub Enterprise Cloud con residencia de datos: use https://YOURSUBDOMAIN.ghe.com como nombre de host.

Configuración con Docker

Para configurar el servidor MCP local con Docker en Visual Studio Code:

  1. En Visual Studio Code, Abra la paleta de comandos presionando Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Escriba y seleccione MCP: Abra Configuración de usuario.

  3. En el archivo de configuración, busque la servers sección o créela si no existe.

  4. Agregue la siguiente configuración:

           **Para GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    Reemplace por YOUR_GHES_HOSTNAME el GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com).

           **Para GitHub Enterprise Cloud con residencia de datos:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    Reemplace YOURSUBDOMAIN con su subdominio GitHub Enterprise Cloud.

  5. Guarde el archivo.

  6. Reinicie Visual Studio Code o vuelva a cargar la ventana para que los cambios surtan efecto.

Para configurar el servidor MCP local con Docker en Visual Studio, debe editar manualmente el mcp.json archivo.

  1. Abra el mcp.json archivo en Visual Studio. El archivo se encuentra normalmente en el directorio del perfil de usuario.

  2. Agregue la siguiente configuración:

           **Para GitHub Enterprise Server:**
    
    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
            }
          }
        }
      }
    }
    

    Reemplace por YOUR_GHES_HOSTNAME el GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com).

           **Para GitHub Enterprise Cloud con residencia de datos establecida:**
    
    JSON
    {
      "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "github_token",
            "description": "GitHub PAT",
            "password": true
          }
        ],
        "servers": {
          "github": {
            "command": "docker",
            "args": [
              "run",
              "-i",
              "--rm",
              "-e",
              "GITHUB_PERSONAL_ACCESS_TOKEN",
              "-e",
              "GITHUB_HOST",
              "ghcr.io/github/github-mcp-server"
            ],
            "env": {
              "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
              "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
            }
          }
        }
      }
    }
    

    Reemplace YOURSUBDOMAIN por su subdominio GitHub Enterprise Cloud.

  3. Guarde el archivo.

Para configurar el servidor MCP local con Docker en los IDE de JetBrains:

  1. En la esquina inferior derecha, haz clic en .

  2. En el menú, selecciona "Open Chat", asegúrate de que estás en modo Agente y, después, haz clic en el icono de herramientas (denominado "Configure your MCP server") en la parte inferior de la ventana de chat.

  3. Haz clic en Add MCP Tools.

  4. Agregue la siguiente configuración:

           **Para GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    Reemplace por YOUR_GHES_HOSTNAME el GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com).

           **Para GitHub Enterprise Cloud con residencia de datos:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    Reemplace YOURSUBDOMAIN con su subdominio GitHub Enterprise Cloud.

Para configurar el servidor MCP local con Docker en Xcode:

  1. Abre GitHub Copilot para la extensión Xcode y ve a "Settings".

    • Como alternativa, en un área de trabajo activa de Xcode, puedes encontrar los valores si haces clic en Editor en la barra de menús, seleccionas GitHub Copilot y, después, haces clic en Open GitHub Copilot for Xcode Settings.
  2. Selecciona la pestaña MCP y, después, haz clic en Edit Config.

  3. Agregue la siguiente configuración:

           **Para GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    Reemplace por YOUR_GHES_HOSTNAME el GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com).

           **Para GitHub Enterprise Cloud con residencia de datos:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    Reemplace YOURSUBDOMAIN con su subdominio GitHub Enterprise Cloud.

Para configurar el servidor MCP local con Docker en Eclipse:

  1. Haz clic en el icono Copilot () en la barra de estado de la parte inferior de Eclipse.

  2. En el menú, selecciona Open Chat y, en la ventana de chat, haz clic en el icono "Configure Tools...".

    • Como alternativa, puedes seleccionar Edit preferences, después en el panel de la izquierda expandir GitHub Copilot y hacer clic en MCP.
  3. Agrega la siguiente configuración en "Configuraciones de servidor":

           **Para GitHub Enterprise Server:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOUR_GHES_HOSTNAME"
          }
        }
      }
    }
    

    Reemplace por YOUR_GHES_HOSTNAME el GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com).

              **Para GitHub Enterprise Cloud con residencia de datos:**
    
    JSON
    {
      "inputs": [
        {
          "type": "promptString",
          "id": "github_token",
          "description": "GitHub PAT",
          "password": true
        }
      ],
      "servers": {
        "github": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "GITHUB_PERSONAL_ACCESS_TOKEN",
            "-e",
            "GITHUB_HOST",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}",
            "GITHUB_HOST": "https://YOURSUBDOMAIN.ghe.com"
          }
        }
      }
    }
    

    Sustituya YOURSUBDOMAIN por su subdominio GitHub Enterprise Cloud.

  4. Haga clic en Aplicar.

Configuración al compilar desde el código fuente

Si va a compilar el servidor MCP desde el origen en lugar de usar Docker, puede establecer la GITHUB_HOST variable de entorno o usar la --gh-host marca de línea de comandos:

          **Uso de la variable de entorno:**
export GITHUB_HOST="https://YOUR_GHES_OR_GHEC_HOSTNAME"
./github-mcp-server stdio
          **Usando la bandera de la línea de comandos:**
./github-mcp-server --gh-host \
  "https://YOUR_GHES_OR_GHEC_HOSTNAME" stdio

Reemplace YOUR_GHES_OR_GHEC_HOSTNAME con su GitHub Enterprise Server nombre de host (por ejemplo, https://github.example.com) o con su GitHub Enterprise Cloud nombre de host (por ejemplo, https://octocorp.ghe.com).

Pasos siguientes