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

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

Tool navigation

В этой статье

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

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

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

Внимание

GitHub Enterprise Serverне поддерживает удалённое размещение MCP-серверов. Если вы используете GitHub Enterprise Server, необходимо использовать локальную конфигурацию сервера MCP, описанную в разделе 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 поддомен.

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

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

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

  3. Перезагрузите 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.
  2. В нижней части панели чата выберите агент в раскрывающемся списке режима.
  3. В Копилот Чат окне нажмите иконку инструментов, затем значок плюса в окне выбора инструментов.
  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 поддомен.

  1. Сохраните файл.
  2. Перезагрузите 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 поддомен.

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

Чтобы настроить локальный 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 поддомен.

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

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

Если вы собираете 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).

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