Configuration du serveur MCP GitHub pour GitHub Entreprise

Découvrez comment configurer le serveur MCP (Model Context Protocol) GitHub pour qu’il fonctionne avec GitHub Enterprise Server ou GitHub Enterprise Cloud avec résidence des données.

Tool navigation

Dans cet article

Le GitHub serveur MCP peut être configuré pour fonctionner avec GitHub Enterprise Server et GitHub Enterprise Cloud avec résidence des données. Les étapes de configuration diffèrent selon que vous utilisez le serveur MCP distant ou local.

À propos de la configuration du serveur MCP d’entreprise

Le GitHub serveur MCP prend en charge deux types de déploiement d’entreprise :

          [
          GitHub Enterprise Cloud avec résidence des données
          ](#configuring-the-remote-mcp-server-for-github-enterprise-cloud-with-data-residency)
          **: prend en charge les configurations de serveur MCP distantes et locales

          [
          GitHub Enterprise Server
          ](#configuring-the-local-mcp-server-for-enterprise)
          **: prend **en charge uniquement la configuration du serveur MCP local**

Important

          GitHub Enterprise Server ne prend **pas** en charge l’hébergement de serveur MCP distant. Si vous utilisez GitHub Enterprise Server, vous **devez** utiliser la configuration de serveur MCP locale décrite dans [Configuration du serveur MCP local pour l’entreprise](#configuring-the-local-mcp-server-for-enterprise). Ignorez la section de configuration du serveur MCP distante ci-dessous.

Prerequisites

  • Une instance GitHub Enterprise Server ou un compte GitHub Enterprise Cloud avec résidence de données
  • Serveur GitHub MCP configuré dans votre éditeur. Consultez « Configuration du serveur MCP GitHub ».

Configuration du serveur MCP distant pour GitHub Enterprise Cloud avec résidence des données

Remarque

Cette section s’applique uniquement à GitHub Enterprise Cloud avec résidence des données. Si vous utilisez GitHub Enterprise Server, passez à la configuration du serveur MCP local pour l’entreprise.

          GitHub Enterprise Cloud avec résidence des données peut utiliser le serveur MCP distant. Pour le configurer, vous devez mettre à jour l’URL du serveur MCP pour qu’elle pointe vers votre GitHub Enterprise Cloud instance.

Par exemple, si votre GitHub Enterprise Cloud instance est https://octocorp.ghe.com, l’URL du serveur MCP serait https://copilot-api.octocorp.ghe.com/mcp.

  1. Dans Visual Studio Code, ouvrez la palette de commandes en appuyant sur Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Tapez et sélectionnez MCP : Ouvrir la configuration utilisateur.

  3. Dans le fichier de paramètres, recherchez la servers section. Si vous avez déjà configuré le serveur MCP GitHub, vous verrez une entrée github.

  4. Mettez à jour le champ url pour qu’il pointe vers votre instance GitHub Enterprise Cloud.

           **Option A : Avec l’authentification 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
    }
  ]
}

           **Option B : Avec l’authentification OAuth**
    JSON
    {
  "servers": {
    "github": {
      "type": "http",
      "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
    }
  }
}

    Remplacez SUBDOMAIN.ghe.com par votre GHE.com sous-domaine.

  5. Enregistrez le fichier.

  6. Lorsque vous utilisez OAuth avec GitHub Enterprise Cloud avec résidence des données, configurez vos VS Code paramètres pour qu’ils pointent vers votre GitHub Enterprise Cloud instance. Ajoutez les éléments suivants à vos VS Code paramètres utilisateur :

    {
  "github-enterprise.uri": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
}

  7. Redémarrez ou rechargez Visual Studio Code la fenêtre pour que les modifications prennent effet.

          GitHub Enterprise Cloud avec résidence des données peut recourir au serveur MCP distant. Pour le configurer, vous devez mettre à jour l’URL du serveur MCP pour qu’elle pointe vers votre GitHub Enterprise Cloud instance.

Par exemple, si votre GitHub Enterprise Cloud instance est https://octocorp.ghe.com, l’URL du serveur MCP serait https://copilot-api.octocorp.ghe.com/mcp.

  1. Dans la barre de Visual Studio menus, cliquez sur Affichage, puis sur GitHub Copilot Chat.
  2. Au bas du volet de discussion, sélectionnez Agent dans la liste déroulante mode.
  3. Dans la Discussion avec Copilot fenêtre, cliquez sur l’icône outils, puis cliquez sur l’icône plus dans la fenêtre du sélecteur d’outils.
  4. Dans la fenêtre contextuelle « Configurer le serveur MCP », remplissez les champs.
    1. Pour « ID de serveur », tapez github.
    2. Pour « Type », sélectionnez « HTTP/SSE » dans la liste déroulante.
    3. Pour « URL », tapez https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp, en remplaçant YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.
    4. Ajoutez un nouvel en-tête sous « En-têtes », appelé « Autorisation » et définissez la valeur Bearer YOUR_GITHUB_PAT, en remplaçant « YOUR_GITHUB_PAT » par votre personal access token.
  5. Cliquez sur Enregistrer.
          GitHub Enterprise Cloud avec résidence des données peut recourir au serveur MCP distant. Pour le configurer, vous devez mettre à jour l’URL du serveur MCP pour qu’elle pointe vers votre GitHub Enterprise Cloud instance.

Par exemple, si votre GitHub Enterprise Cloud instance est https://octocorp.ghe.com, l’URL du serveur MCP serait https://copilot-api.octocorp.ghe.com/mcp.

  1. Dans le coin inférieur droit, cliquez sur .

  2. Dans le menu, sélectionnez « Ouvrir la conversation » Assurez-vous d’être en mode Assistant, puis cliquez sur l’icône Outils (appelée « Configurer votre serveur MCP ») en bas de la fenêtre de conversation.

  3. Cliquez sur Ajouter des outils MCP.

  4. Dans le mcp.json fichier, ajoutez la configuration suivante, en remplaçant YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine et YOUR_GITHUB_PAT par votre personal access token:

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

          GitHub Enterprise Cloud avec résidence des données peut recourir au serveur MCP distant. Pour le configurer, vous devez mettre à jour l’URL du serveur MCP pour qu’elle pointe vers votre GitHub Enterprise Cloud instance.

Par exemple, si votre GitHub Enterprise Cloud instance est https://octocorp.ghe.com, l’URL du serveur MCP serait https://copilot-api.octocorp.ghe.com/mcp.

  1. Ouvrez l’extension GitHub Copilot pour Xcode et accédez à « Paramètres ».

    • Vous pouvez également, dans un espace de travail Xcode actif, trouver les paramètres en cliquant sur Éditeur dans la barre de menu, en sélectionnant GitHub Copilot, puis en cliquant sur Ouvrir GitHub Copilot pour les paramètres Xcode.

  2. Sélectionnez l’onglet MCP, puis cliquez sur Modifier la configuration.

  3. Ajoutez la configuration suivante, en remplaçant YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine et YOUR_GITHUB_PAT par votre personal access token:

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

          GitHub Enterprise Cloud avec résidence des données peut recourir au serveur MCP distant. Pour le configurer, vous devez mettre à jour l’URL du serveur MCP pour qu’elle pointe vers votre GitHub Enterprise Cloud instance.

Par exemple, si votre GitHub Enterprise Cloud instance est https://octocorp.ghe.com, l’URL du serveur MCP serait https://copilot-api.octocorp.ghe.com/mcp.

  1. Cliquez sur l’icône Copilot () dans la barre d’état en bas d’Eclipse.

  2. Dans le menu, sélectionnez Ouvrir la conversation et, dans la fenêtre de conversation, cliquez sur l’icône « Configurer les outils... ».

    • Vous pouvez également sélectionner Modifier les préférences, puis, dans le volet gauche, développez GitHub Copilot et cliquez sur MCP.

  3. Ajoutez la configuration suivante sous « Configurations du serveur », en remplaçant YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine et YOUR_GITHUB_PAT par votre personal access token:

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

  4. Cliquez sur Appliquer.

Configuration du serveur MCP local pour l’entreprise

GitHub Enterprise Server et GitHub Enterprise Cloud avec résidence des données prennent en charge le serveur MCP local. Vous pouvez configurer le serveur local à l’aide de la GITHUB_HOST variable d’environnement ou de l’indicateur de --gh-host ligne de commande.

Considérations importantes

  • Pour GitHub Enterprise Server : préfixez le nom d’hôte avec le schéma URI https://, sinon il prend par défaut http://, que GitHub Enterprise Server ne prend pas en charge.
  • Pour GitHub Enterprise Cloud ayant la résidence des données : utilisez https://YOURSUBDOMAIN.ghe.com comme nom d'hôte.

Configuration avec Docker

Pour configurer le serveur MCP local avec Docker dans Visual Studio Code:

  1. Dans Visual Studio Code, ouvrez la palette de commandes en appuyant sur Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Tapez et sélectionnez MCP : Ouvrir la configuration utilisateur.

  3. Dans le fichier de paramètres, recherchez la section servers ou créez-la si elle n’existe pas.

  4. Ajouter la configuration suivante :

           **Pour 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"
      }
    }
  }
}

    Remplacez par YOUR_GHES_HOSTNAME votre GitHub Enterprise Server nom d’hôte (par exemple, https://github.example.com).

           **Pour la résidence des GitHub Enterprise Cloud données :**
    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"
      }
    }
  }
}

    Remplacez YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.

  5. Enregistrez le fichier.

  6. Redémarrez ou rechargez Visual Studio Code la fenêtre pour que les modifications prennent effet.

Pour configurer le serveur MCP local Visual Studio avec Docker, vous devez modifier manuellement le fichier mcp.json.

  1. Ouvrez le mcp.json fichier dans Visual Studio. Le fichier se trouve généralement dans votre répertoire de profil utilisateur.

  2. Ajouter la configuration suivante :

           **Pour 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"
        }
      }
    }
  }
}

    Remplacez par YOUR_GHES_HOSTNAME votre GitHub Enterprise Server nom d’hôte (par exemple, https://github.example.com).

              ** Pour GitHub Enterprise Cloud avec résidence des données :**
    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"
        }
      }
    }
  }
}

    Remplacez YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.

  3. Enregistrez le fichier.

Pour configurer le serveur MCP local avec Docker dans les IDE JetBrains :

  1. Dans le coin inférieur droit, cliquez sur .

  2. Dans le menu, sélectionnez « Ouvrir la conversation » Assurez-vous d’être en mode Assistant, puis cliquez sur l’icône Outils (appelée « Configurer votre serveur MCP ») en bas de la fenêtre de conversation.

  3. Cliquez sur Ajouter des outils MCP.

  4. Ajouter la configuration suivante :

           **Pour 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"
      }
    }
  }
}

    Remplacez par YOUR_GHES_HOSTNAME votre GitHub Enterprise Server nom d’hôte (par exemple, https://github.example.com).

           **Pour la résidence des GitHub Enterprise Cloud données :**
    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"
      }
    }
  }
}

    Remplacez YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.

Pour configurer le serveur MCP local avec Docker dans Xcode :

  1. Ouvrez l’extension GitHub Copilot pour Xcode et accédez à « Paramètres ».

    • Vous pouvez également, dans un espace de travail Xcode actif, trouver les paramètres en cliquant sur Éditeur dans la barre de menu, en sélectionnant GitHub Copilot, puis en cliquant sur Ouvrir GitHub Copilot pour les paramètres Xcode.

  2. Sélectionnez l’onglet MCP, puis cliquez sur Modifier la configuration.

  3. Ajouter la configuration suivante :

           **Pour 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"
      }
    }
  }
}

    Remplacez par YOUR_GHES_HOSTNAME votre GitHub Enterprise Server nom d’hôte (par exemple, https://github.example.com).

              ** Pour GitHub Enterprise Cloud avec résidence des données :**
    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"
      }
    }
  }
}

    Remplacez YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.

Pour configurer le serveur MCP local avec Docker dans Eclipse :

  1. Cliquez sur l’icône Copilot () dans la barre d’état en bas d’Eclipse.

  2. Dans le menu, sélectionnez Ouvrir la conversation et, dans la fenêtre de conversation, cliquez sur l’icône « Configurer les outils... ».

    • Vous pouvez également sélectionner Modifier les préférences, puis, dans le volet gauche, développez GitHub Copilot et cliquez sur MCP.

  3. Ajoutez la configuration suivante sous « Configurations du serveur » :

           **Pour 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"
      }
    }
  }
}

    Remplacez par YOUR_GHES_HOSTNAME votre GitHub Enterprise Server nom d’hôte (par exemple, https://github.example.com).

              ** Pour GitHub Enterprise Cloud avec résidence des données :**
    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"
      }
    }
  }
}

    Remplacez YOURSUBDOMAIN par votre GitHub Enterprise Cloud sous-domaine.

  4. Cliquez sur Appliquer.

Configuration lors de la génération à partir de la source

Si vous créez le serveur MCP à partir de la source au lieu d’utiliser Docker, vous pouvez définir la GITHUB_HOST variable d’environnement ou utiliser l’indicateur --gh-host de ligne de commande :

          **Utilisation de la variable d’environnement :**

export GITHUB_HOST="https://YOUR_GHES_OR_GHEC_HOSTNAME"
./github-mcp-server stdio

          **Utilisation de l’indicateur de ligne de commande :**

./github-mcp-server --gh-host \
  "https://YOUR_GHES_OR_GHEC_HOSTNAME" stdio

Remplacez YOUR_GHES_OR_GHEC_HOSTNAME par votre nom d’hôte GitHub Enterprise Server (par exemple, https://github.example.com) ou nom d’hôte GitHub Enterprise Cloud (par exemple, https://octocorp.ghe.com).

Étapes suivantes