Skip to main content

Конфигурирование GitHub MCP Server для GitHub Enterprise

Узнайте, как настроить сервер GitHub Model Context Protocol (MCP) для работы с GitHub Enterprise Server или GitHub Enterprise Cloud с размещением данных.

          GitHub MCP-сервер можно настроить на работу с GitHub Enterprise Server и GitHub Enterprise Cloud с размещением данных. Шаги настройки различаются в зависимости от того, используете ли вы удалённый или локальный MCP-сервер.

О конфигурации корпоративного MCP-сервера

          GitHub MCP-сервер поддерживает два типа корпоративных развертываний:

* ** GitHub Enterprise Cloud с размещением данных **: Поддерживает как удалённые, так и локальные конфигурации серверов MCP * ** GitHub Enterprise Server **: Поддерживает только локальную конфигурацию сервера MCP

Внимание

          GitHub Enterprise Server
          **не поддерживает** удалённое размещение MCP-серверов. Если вы используете GitHub Enterprise Server, **необходимо** использовать локальную конфигурацию сервера MCP, описанную в [разделе Configuring the local MCP server for enterprise](#configuring-the-local-mcp-server-for-enterprise). Пропустите раздел конфигурации удалённых MCP серверов ниже.

Необходимые условия

  • Экземпляр GitHub Enterprise Server или GitHub Enterprise Cloud аккаунт с Место расположения данных
  • MCP-сервер настроен GitHub в вашем редакторе. См . раздел AUTOTITLE.

Настройка удалённого MCP-сервера для GitHub Enterprise Cloud с размещением данных

Примечание.

Этот раздел применяется только к GitHub Enterprise Cloud с размещением данных. Если вы используете GitHub Enterprise Server, перейдите к Configuring local MCP server for enterprise.

          GitHub Enterprise Cloud с размещением данных можно использовать удалённый MCP-сервер. Для настройки нужно обновить URL сервера MCP, чтобы он указывал на ваш GitHub Enterprise Cloud экземпляр.

Например, если ваш GitHub Enterprise Cloud экземпляр — https://octocorp.ghe.com, URL сервера MCP будет https://copilot-api.octocorp.ghe.com/mcp.

  1. В Visual Studio Code откройте палитру команд, нажав Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Введите и выберите MCP: Open User Configuration.

  3. В файле настроек найдите раздел.servers Если вы уже настроили GitHub MCP-сервер, вы увидите запись github .

  4. Обновите url поле, чтобы оно указывало на ваш GitHub Enterprise Cloud экземпляр.

           **Вариант А: с 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
        }
      ]
    }
    
           **Вариант B: с аутентификацией OAuth**
    
    JSON
    {
      "servers": {
        "github": {
          "type": "http",
          "url": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
        }
      }
    }
    

    Замените SUBDOMAIN.ghe.com на свой GHE.com поддомен.

  5. Сохраните файл.

  6. При использовании OAuth с GitHub Enterprise Cloud с размещением данных, настройте VS Code настройки так, чтобы указывать на ваш GitHub Enterprise Cloud экземпляр. Добавьте следующее в вашиVS Code пользовательские настройки:

    {
      "github-enterprise.uri": "https://copilot-api.SUBDOMAIN.ghe.com/mcp"
    }
    
  7. Перезагрузите Visual Studio Code или перезагрузите окно, чтобы изменения вступили в силу.

          GitHub Enterprise Cloud С проживанием данных можно использовать удалённый MCP-сервер. Для настройки нужно обновить URL сервера MCP, чтобы он указывал на ваш GitHub Enterprise Cloud экземпляр.

Например, если ваш GitHub Enterprise Cloud экземпляр — https://octocorp.ghe.com, URL сервера MCP будет https://copilot-api.octocorp.ghe.com/mcp.

  1. В строке Visual Studio меню нажмите «Просмотр», затем нажмите GitHub Copilot Chat.
  2. В нижней части панели чата выберите агент в раскрывающемся списке режима.
  3. В Copilot Chat окне нажмите иконку инструментов, затем значок плюса в окне выбора инструментов.
  4. Во всплывающем окне "Настройка сервера MCP" заполните поля.
    1. Для «Server ID» введите github.
    2. В поле "Тип" в раскрывающемся списке выберите "HTTP/SSE".
    3. Для «URL» введите https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp, замените YOURSUBDOMAIN на ваш GitHub Enterprise Cloud поддомен.
    4. Добавьте новый заголовок в разделе «Заголовки», называемый «Авторизация», и установите значение Bearer YOUR_GITHUB_PAT, заменяя «YOUR_GITHUB_PAT» на ваш personal access token.
  5. Нажмите кнопку Сохранить.
          GitHub Enterprise Cloud С проживанием данных можно использовать удалённый MCP-сервер. Для настройки нужно обновить URL сервера MCP, чтобы он указывал на ваш GitHub Enterprise Cloud экземпляр.

Например, если ваш GitHub Enterprise Cloud экземпляр — https://octocorp.ghe.com, URL сервера MCP будет https://copilot-api.octocorp.ghe.com/mcp.

  1. В правом нижнем углу щелкните .

  2. В меню выберите "Открыть чат", убедитесь, что вы находитесь в режиме агента, а затем щелкните значок инструментов ("Настроить сервер MCP") в нижней части окна чата.

  3. Нажмите кнопку "Добавить инструменты MCP".

  4. В mcp.json файле добавьте следующую конфигурацию, заменив YOURSUBDOMAIN на ваш GitHub Enterprise Cloud поддомен и YOUR_GITHUB_PAT на вашу personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud С проживанием данных можно использовать удалённый MCP-сервер. Для настройки нужно обновить URL сервера MCP, чтобы он указывал на ваш GitHub Enterprise Cloud экземпляр.

Например, если ваш GitHub Enterprise Cloud экземпляр — https://octocorp.ghe.com, URL сервера MCP будет https://copilot-api.octocorp.ghe.com/mcp.

  1. Откройте GitHub Copilot для расширения Xcode и перейдите к разделу "Параметры".

    • Кроме того, в активной рабочей области Xcode можно найти параметры, щелкнув редактор в строке меню, выбрав GitHub Copilot, а затем нажмите кнопку "Открыть GitHub Copilot для параметров Xcode.
  2. Перейдите на вкладку MCP и нажмите кнопку "Изменить конфигурацию".

  3. Добавьте следующую конфигурацию, заменяя YOURSUBDOMAIN ваш GitHub Enterprise Cloud поддомен и YOUR_GITHUB_PAT ваш personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
          GitHub Enterprise Cloud С проживанием данных можно использовать удалённый MCP-сервер. Для настройки нужно обновить URL сервера MCP, чтобы он указывал на ваш GitHub Enterprise Cloud экземпляр.

Например, если ваш GitHub Enterprise Cloud экземпляр — https://octocorp.ghe.com, URL сервера MCP будет https://copilot-api.octocorp.ghe.com/mcp.

  1. Щелкните значок Copilot () в строке состояния в нижней части Eclipse.

  2. В меню выберите "Открыть чат " и в окне чата щелкните "Настройка инструментов..." икона.

    • Кроме того, можно выбрать параметры редактирования, а затем в левой области разверните узел GitHub Copilot и щелкните MCP.
  3. Добавьте следующую конфигурацию в разделе «Конфигурации серверов», заменяя YOURSUBDOMAIN на ваш GitHub Enterprise Cloud поддомен и YOUR_GITHUB_PAT на вашу personal access token:

    JSON
    {
      "servers": {
        "github": {
          "url": "https://copilot-api.YOURSUBDOMAIN.ghe.com/mcp",
          "requestInit": {
            "headers": {
              "Authorization": "Bearer YOUR_GITHUB_PAT"
            }
          }
        }
      }
    }
    
  4. Нажмите кнопку "Применить".

Настройка локального MCP-сервера для корпоративного предприятия

И то GitHub Enterprise Server , и GitHub Enterprise Cloud с проживанием данных поддерживают локальный MCP-сервер. Вы можете настроить локальный сервер, используя либо GITHUB_HOST переменную среды, либо --gh-host флаг командной строки.

Важные замечания

  •         **Для : Приставьте GitHub Enterprise Server** имя хозяина с помощью `https://` URI-схема, так как по умолчанию используется `http://`, которая GitHub Enterprise Server не поддерживается.
    
  •         **Для GitHub Enterprise Cloud с data residency**: используйте `https://YOURSUBDOMAIN.ghe.com` как имя хоста.
    

Конфигурация с Docker

Чтобы настроить локальный MCP-сервер с помощью Docker в :Visual Studio Code

  1. В Visual Studio Code откройте палитру команд, нажав Ctrl+Shift+P (Windows/Linux) / Command+Shift+P (Mac).

  2. Введите и выберите MCP: Open User Configuration.

  3. В файле настроек найдите раздел servers или создайте его, если его нет.

  4. Добавьте следующую конфигурацию.

           **Для 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"
          }
        }
      }
    }
    

    Замените YOUR_GHES_HOSTNAME имя GitHub Enterprise Server хозяина (например, https://github.example.com).

           **Для GitHub Enterprise Cloud с резидентством по данным:**
    
    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"
          }
        }
      }
    }
    

    Замените YOURSUBDOMAIN на свой GitHub Enterprise Cloud поддомен.

  5. Сохраните файл.

  6. Перезагрузите Visual Studio Code или перезагрузите окно, чтобы изменения вступили в силу.

Чтобы настроить локальный MCP-сервер с Docker, Visual Studioнужно вручную редактировать файл mcp.json .

  1.        `mcp.json` Откройте файл в Visual Studio. Файл обычно находится в папке вашего профиля пользователя.
    
  2. Добавьте следующую конфигурацию.

           **Для 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"
            }
          }
        }
      }
    }
    

    Замените YOUR_GHES_HOSTNAME имя GitHub Enterprise Server хозяина (например, https://github.example.com).

           **Для GitHub Enterprise Cloud с резидентством по данным:**
    
    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"
            }
          }
        }
      }
    }
    

    Замените YOURSUBDOMAIN на свой GitHub Enterprise Cloud поддомен.

  3. Сохраните файл.

Чтобы настроить локальный MCP-сервер с помощью Docker в IDE JetBrains:

  1. В правом нижнем углу щелкните .

  2. В меню выберите "Открыть чат", убедитесь, что вы находитесь в режиме агента, а затем щелкните значок инструментов ("Настроить сервер MCP") в нижней части окна чата.

  3. Нажмите кнопку "Добавить инструменты MCP".

  4. Добавьте следующую конфигурацию.

           **Для 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"
          }
        }
      }
    }
    

    Замените YOUR_GHES_HOSTNAME имя GitHub Enterprise Server хозяина (например, https://github.example.com).

           **Для GitHub Enterprise Cloud с резидентством по данным:**
    
    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"
          }
        }
      }
    }
    

    Замените YOURSUBDOMAIN на свой GitHub Enterprise Cloud поддомен.

Чтобы настроить локальный MCP-сервер с помощью Docker в Xcode:

  1. Откройте GitHub Copilot для расширения Xcode и перейдите к разделу "Параметры".

    • Кроме того, в активной рабочей области Xcode можно найти параметры, щелкнув редактор в строке меню, выбрав GitHub Copilot, а затем нажмите кнопку "Открыть GitHub Copilot для параметров Xcode.
  2. Перейдите на вкладку MCP и нажмите кнопку "Изменить конфигурацию".

  3. Добавьте следующую конфигурацию.

           **Для 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"
          }
        }
      }
    }
    

    Замените YOUR_GHES_HOSTNAME имя GitHub Enterprise Server хозяина (например, https://github.example.com).

           **Для GitHub Enterprise Cloud с резидентством по данным:**
    
    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"
          }
        }
      }
    }
    

    Замените YOURSUBDOMAIN на свой GitHub Enterprise Cloud поддомен.

Чтобы настроить локальный MCP-сервер с помощью Docker в Eclipse:

  1. Щелкните значок Copilot () в строке состояния в нижней части Eclipse.

  2. В меню выберите "Открыть чат " и в окне чата щелкните "Настройка инструментов..." икона.

    • Кроме того, можно выбрать параметры редактирования, а затем в левой области разверните узел GitHub Copilot и щелкните MCP.
  3. Добавьте следующую конфигурацию в разделе "Конфигурации сервера":

           **Для 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"
          }
        }
      }
    }
    

    Замените YOUR_GHES_HOSTNAME имя GitHub Enterprise Server хозяина (например, https://github.example.com).

           **Для GitHub Enterprise Cloud с резидентством по данным:**
    
    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"
          }
        }
      }
    }
    

    Замените YOURSUBDOMAIN на свой GitHub Enterprise Cloud поддомен.

  4. Нажмите кнопку "Применить".

Конфигурация при сборке из источника

Если вы собираете MCP-сервер из исходного кода, а не с помощью Docker, можно установить GITHUB_HOST переменную среды или использовать --gh-host флаг командной строки:

          **Использование переменной среды:**
export GITHUB_HOST="https://YOUR_GHES_OR_GHEC_HOSTNAME"
./github-mcp-server stdio
          **Использование флага командной строки:**
./github-mcp-server --gh-host \
  "https://YOUR_GHES_OR_GHEC_HOSTNAME" stdio

Замените YOUR_GHES_OR_GHEC_HOSTNAME на GitHub Enterprise Server имя хоста (например https://github.example.com) или GitHub Enterprise Cloud имя хоста (например, https://octocorp.ghe.com).

Дальнейшие действия