Configuración del servidor MCP de GitHub para GitHub Enterprise

Aprenda a configurar el servidor del Protocolo de Contexto del Modelo (MCP) de GitHub para que funcione con GitHub Enterprise Server o Nube de GitHub Enterprise con residencia de datos.

Tool navigation

En este artículo

El servidor MCP GitHub se puede configurar para trabajar 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 servidor MCP GitHub 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)**: admite **solo la configuración del servidor MCP local**

Importante

GitHub Enterprise Server does no admite el alojamiento remoto del servidor MCP. Si está utilizando GitHub Enterprise Server, debe utilizar la configuración del servidor MCP local según se describe en Configurar el servidor MCP local para empresas. Omita la sección de configuración remota del servidor MCP a continuación.

Prerrequisitos

  • Un instancia de GitHub Enterprise Server una cuenta de GitHub Enterprise Cloud con diferente residencia
  • El servidor MCP GitHub 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 va a usar GitHub Enterprise Server, continúe con Cómo configurar el servidor MCP local para empresas.

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

Por ejemplo, si la instancia de GitHub Enterprise Cloud 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 con Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+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 servidor MCP GitHub , verá una entrada github.

  4. Modifique el campo url para que apunte a la instancia de 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 por su subdominio GHE.com.

  5. Guarde el archivo.

  6. Al usar OAuth con Nube de GitHub Enterprise con residencia de datos, ajuste la configuración de VS Code para que apunte a su instancia de GitHub Enterprise Cloud. Añada lo siguiente a las configuraciones de usuario de su VS Code:

    {
  "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 residencia de datos puede usar el servidor MCP remoto. Para configurar este, debe modificar la dirección URL del servidor MCP para que apunte a su instancia de GitHub Enterprise Cloud.

Por ejemplo, si la instancia de GitHub Enterprise Cloud 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 menús de Visual Studio, haz clic en Ver y, luego, en Chat de GitHub Copilot.
  2. En la parte inferior del panel de chat, selecciona Agent en la lista desplegable de modo.
  3. En la ventana chat de Copilot, haz clic en el icono de herramientas y, a continuación, haz clic en el icono de signo más de la ventana del selector de herramientas.
  4. En la ventana emergente "Configurar servidor MCP", rellena los campos.
    1. En "Id. de servidor", escriba github.
    2. En "Tipo", selecciona "HTTP/SSE" en la lista desplegable.
    3. En "URL", escriba https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp, reemplazando YOURSUBDOMAIN con su subdominio de GitHub Enterprise Cloud.
    4. Agregue un nuevo encabezado en "Encabezados", denominado "Autorización" y configúrelo con el valor Bearer YOUR_GITHUB_PAT, reemplazando "YOUR_GITHUB_PAT" por sus datos personal access token.
  5. Haz clic en Guardar.

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

Por ejemplo, si la instancia de GitHub Enterprise Cloud 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 subdominio GitHub Enterprise Cloud y YOUR_GITHUB_PAT por su 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 residencia de datos puede usar el servidor MCP remoto. Para configurar este, debe modificar la dirección URL del servidor MCP para que apunte a su instancia de GitHub Enterprise Cloud.

Por ejemplo, si la instancia de GitHub Enterprise Cloud 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 subdominio GitHub Enterprise Cloud y YOUR_GITHUB_PAT por el 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 residencia de datos puede usar el servidor MCP remoto. Para configurar este, debe modificar la dirección URL del servidor MCP para que apunte a su instancia de GitHub Enterprise Cloud.

Por ejemplo, si la instancia de GitHub Enterprise Cloud 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 su subdominio GitHub Enterprise Cloud y YOUR_GITHUB_PAT por su 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

Ambos GitHub Enterprise Server y GitHub Enterprise Cloud son compatibles con la residencia de datos y admiten 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**: añada un prefijo al nombre de host con el esquema URI `https://`, ya que, de lo contrario, tendrá `http://` como valor predeterminado, no compatibles con GitHub Enterprise Server.

  •         **Para GitHub Enterprise Cloud con residencia de datos**: utilice `https://YOURSUBDOMAIN.ghe.com` como nombre de host.

Configuración con Docker

Cómo configurar el servidor MCP local con Docker en Visual Studio Code:

  1. En Visual Studio Code, abra la paleta de comandos con Ctrl+Mayús+P (Windows/Linux) / Comando+Mayús+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 YOUR_GHES_HOSTNAME por el nombre de host GitHub Enterprise Server (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 por 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 archivo mcp.json.

  1. Abra el archivo mcp.json 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 YOUR_GHES_HOSTNAME por el nombre de host GitHub Enterprise Server (por ejemplo, https://github.example.com).

           **Para GitHub Enterprise Cloud con residencia de datos:**
    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 YOUR_GHES_HOSTNAME por el nombre de host GitHub Enterprise Server (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 por 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 YOUR_GHES_HOSTNAME por el nombre de host GitHub Enterprise Server (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 por 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 YOUR_GHES_HOSTNAME por el nombre de host GitHub Enterprise Server (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 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 por el nombre de host GitHub Enterprise Server (por ejemplo, https://github.example.com) o GitHub Enterprise Cloud hostname (por ejemplo, https://octocorp.ghe.com).

Pasos siguientes