Гайды

GitHub Copilot MCP: как подключить сервер

14 октября 2026 · 17 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 14 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

GitHub Copilot MCP: как подключить сервер — в VS Code сервер настраивается через файл mcp.json с ключом servers, в Copilot CLI добавляется командой /mcp add или правкой файла ~/.copilot/mcp-config.json. Дальше сервер запускается, вы подтверждаете доверие, выбираете доступные инструменты и проверяете их пробным вызовом. Ниже — оба пути по шагам.

Что даёт MCP в GitHub Copilot и где он работает

Model Context Protocol — открытый стандарт, описывающий, как приложения используют контекст с большими языковыми моделями. В документации GitHub сказано, что MCP позволяет интегрировать возможности искусственного интеллекта с другими инструментами и службами, расширяя возможности разработки за счёт контекстной помощи. Проще говоря, MCP-сервер отдаёт ассистенту инструменты и данные, которых у него самого нет: доступ к репозиториям, к внешним API, к справочникам.

GitHub поддерживает собственный MCP-сервер — он предоставляется и поддерживается GitHub. Этот сервер даёт ассистенту доступ к функциям платформы: работа с репозиториями, issues, pull request’ами и другими объектами. Помимо него подключаются сторонние серверы — от Azure до Playwright, — и именно их добавление описывает инструкция по Copilot CLI.

Где всё это живёт. Документация GitHub разводит несколько поверхностей. В IDE — VS Code, Visual Studio, JetBrains, Xcode, Eclipse — настройка идёт через интерфейс редактора или конфигурационный файл. В Copilot CLI серверы добавляются командами и правкой JSON. Отдельно существует GitHub MCP-сервер, встроенный в Copilot CLI: он уже доступен без дополнительной конфигурации, и инструкция описывает шаги для добавления остальных серверов.

Разделение важно по одной причине: у каждой поверхности свой файл конфигурации и свой способ запуска. Copilot CLI хранит пользовательские серверы в ~/.copilot/mcp-config.json, а на уровне проекта читает .mcp.json и .github/mcp.json; файл VS Code в этом перечне документации GitHub не назван. Если вы работаете в обоих местах, проверьте сервер в каждом клиенте отдельно.

Ещё одно различие — удалённый и локальный сервер. В документации GitHub указано, что GitHub MCP-сервер в VS Code настраивается как удалённо, так и локально. Удалённый размещается на стороне GitHub и назван рекомендуемым вариантом для большинства пользователей. Локальный работает на вашем компьютере и рекомендуется тем, кто хочет настроить свою систему или имеет определённые требования к безопасности. Выбор влияет на то, где хранятся учётные данные и кто отвечает за обновления сервера.

Стоит развести два похожих сюжета. Настройка MCP для локальных инструментов разработчика — тема этой статьи. Настройка MCP-серверов для репозитория и облачного coding agent в GitHub Actions — отдельная история со своими политиками и правами; она остаётся за рамками разбора.

Для оценки контекста: по нашему прогону 14 октября 2026 года мы скачали топ-10 выдачи DuckDuckGo (ru-RU) по запросу о подключении MCP-сервера к GitHub Copilot: текст отдали 6 из 10. Медиана объёма читаемого текста топа — 2505 слов. Метку 2026 года несут 6 из 6 прочитанных страниц. Это говорит о том, что тема живая и материалы по ней обновляются.

Что нужно заранее: план Copilot, режим агента, политика организации

Предпосылки делятся на три группы: аккаунт, лицензия и организационные политики.

Аккаунт GitHub нужен в любом случае — он назван первым пунктом в списке необходимых условий. Для работы в IDE потребуется доступ к Copilot: документация GitHub отдельно упоминает этот пункт в перечне требований.

С лицензиями ситуация тоньше, чем кажется. В документации GitHub сказано, что GitHub MCP-сервер доступен всем пользователям GitHub независимо от типа тарифного плана. При этом отдельные инструменты внутри сервера наследуют требования к доступу тех функций GitHub, которые они вызывают. Если функция требует платной лицензии GitHub или Copilot, аналогичный MCP-инструмент потребует той же подписки. Пример из той же документации: инструменты, взаимодействующие с Copilot Cloud Agent, требуют платной лицензии Copilot.

Практический вывод: сам факт подключения сервера от тарифа не зависит, а вот набор доступных инструментов — зависит. Вы можете успешно добавить сервер и обнаружить, что часть инструментов в нём недоступна.

Третий слой — политики. Если вы член организации или предприятия с планом Copilot Business или Copilot Enterprise, политика MCP в Copilot должна быть включена, чтобы использовать MCP с Copilot. Это настройка на стороне администратора, и без неё подключение не заработает, сколько бы вы ни правили локальные файлы.

В Copilot CLI действует похожее правило: если организация или предприятие настроили URL реестра и политику списка разрешений, эти настройки применяются к CLI. Настроенный URL реестра отображается как источник обнаружения, и запускаться могут только серверы, разрешённые политикой списка разрешений. То есть в корпоративной среде список доступных серверов определяет администратор.

Отдельно про аутентификацию. Удалённый GitHub MCP-сервер по умолчанию использует аутентификацию OAuth в один клик. Второй вариант — personal access token (PAT). Разница в объёме прав: при OAuth сервер получает доступ только к тем областям, которые вы утвердили при входе, а в контекстах организации доступ может ограничиваться административными политиками. При PAT сервер получает доступ к объёмам, которые предоставлены самому токену, и на них тоже распространяются ограничения организации.

Для пользователей Enterprise Managed User есть особенность: PAT по умолчанию отключён, если администратор предприятия его не включил. При ограничениях политики доступа OAuth потребуется включённое приложение OAuth для каждого клиента — кроме Visual Studio Code и Visual Studio.

Режим агента — четвёртая предпосылка для IDE. В инструкции GitHub для JetBrains сервер настраивается из чата в режиме агента, а Microsoft в руководстве по Visual Studio связывает серверы MCP с режимом агента Copilot. В разделе GitHub про VS Code режим отдельно не назван.

Соберём предпосылки в таблицу.

Проверьте эти пункты до правки конфигурации. Большинство случаев «сервер добавлен, но ничего не работает» упирается именно в эту таблицу.

Подключение в VS Code: mcp.json, ключ servers, запуск и доверие серверу

В VS Code есть два маршрута: через панель расширений и вручную через файл конфигурации. Документация GitHub описывает удалённую конфигурацию через вид MCP Registry в панели расширений и отдельно отсылает к инструкции по ручной настройке удалённого или локального сервера.

Маршрут через панель расширений выглядит так. Откройте панель расширений — значок в боковой панели или сочетание Ctrl + Shift + X на Windows и Linux, Command + Shift + X на Mac. В строке поиска расширений введите @mcp github, чтобы искать в галерее серверов MCP. Выберите GitHub MCP-сервер из результатов поиска и на странице с деталями нажмите «Установить». При запросе убедитесь, что вы доверяете серверу для запуска.

Этот путь удобен тем, что не требует ручного редактирования JSON: редактор сам создаёт нужную запись. Минус — вы ограничены тем, что есть в галерее.

Ручной маршрут даёт полный контроль, но раздел GitHub про VS Code его не расписывает и отсылает к документации самого сервера. Файл mcp.json с ключом servers и адресом удалённого сервера GitHub та же документация приводит в разделах про JetBrains, Xcode и Eclipse, а Microsoft в руководстве по Visual Studio называет среди читаемых расположений .vscode\mcp.json в папке решения. Запись из этих разделов приведена ниже.

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Для локального сервера, запускаемого процессом, тип и поля отличаются: указывается команда запуска и аргументы, а при необходимости — переменные среды с ключами API или токенами. Точный набор полей для конкретного сервера берите из его собственной документации: у каждого сервера свои команда, аргументы и переменные.

В разделе GitHub про VS Code запуск связан с доверием: при запросе нужно убедиться, что вы доверяете серверу для запуска. Подтверждение защищает от запуска произвольного кода, ведь локальный сервер выполняется на вашей машине.

Диалог доверия — не формальность. Пока доверие не подтверждено, сервер не стартует, и его инструменты ассистенту недоступны. Переключатель запросов доверия для обновлённых серверов Microsoft описывает в руководстве по Visual Studio 2026 версии 18.7 и новее; раздел GitHub про VS Code такую настройку не упоминает.

Отдельный слой — утверждения инструментов. В руководстве Microsoft по Visual Studio Copilot запрашивает подтверждение перед запуском средства, а администраторы организации могут задать список разрешений серверов MCP. Для VS Code раздел GitHub ограничивается подтверждением доверия при установке и проверкой списка серверов.

Проверка настройки в VS Code выполняется через палитру команд. Откройте её сочетанием Ctrl + Shift + P на Windows и Linux или Command + Shift + P на Mac. Введите и выберите «MCP: Список серверов». GitHub MCP-сервер должен быть указан как настроенный сервер. Если он там есть, конфигурация прочитана корректно.

Порядок действий для VS Code:

1. Убедитесь, что выполнены предпосылки: аккаунт, доступ к Copilot, политика организации.
2. Решите, нужен удалённый сервер или локальный.
3. Добавьте сервер через панель расширений или вручную в mcp.json под ключом servers.
4. Для ручной настройки сверьтесь с документацией самого сервера.
5. Подтвердите доверие серверу при запросе.
6. Проверьте список серверов через палитру команд.
7. Если сервер просит входа, пройдите авторизацию.

Если вы только осваиваете Copilot в редакторе, начните с базовой настройки — как использовать Copilot в VS Code, а MCP добавляйте поверх рабочей конфигурации.

Подключение в Copilot CLI: /mcp add и файл mcp-config.json

В Copilot CLI логика другая: серверы добавляются командами, а хранятся в пользовательском конфигурационном файле. Документация GitHub перечисляет четыре способа: команда /mcp add в интерактивном режиме, подкоманда copilot mcp add из терминала, ручное редактирование конфигурационного файла и добавление серверов для каждого репозитория. Отдельно упоминается поиск и установка из реестра в экспериментальном режиме.

Начнём с интерактивного режима. Введите /mcp add — откроется форма конфигурации. Навигация между полями выполняется клавишей Tab.

Поля заполняются так. Рядом с именем сервера введите уникальное имя — оно будет использоваться для обозначения сервера. Рядом с типом сервера выберите тип, нажав соответствующее число. Дальше набор полей зависит от типа.

Для локального сервера или STDIO указывается команда запуска вместе с аргументами. Пример из документации — npx @playwright/mcp@latest. Эти значения соответствуют свойствам command и args в конфигурационном файле JSON. Дополнительно можно задать переменные среды в виде пар ключ-значение JSON, например {"API_KEY": "YOUR-API-KEY"}. Переменная PATH наследуется от вашей среды автоматически, а все остальные переменные нужно указать здесь.

Для HTTP или SSE указывается URL удалённого сервера, например https://mcp.context7.com/mcp. При необходимости задаются HTTP-заголовки в формате JSON, например {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

Отдельное поле — инструменты. Рядом с разделом «Инструменты» укажите, какие инструменты с сервера должны быть доступны. Значение * включает все инструменты; можно перечислить имена через запятую без кавычек. Значение по умолчанию — *.

Сохраните конфигурацию сочетанием Ctrl + S. Сервер добавляется и становится доступен сразу, без перезапуска CLI.

Второй путь — из терминала, без входа в интерактивный режим: подкоманда copilot mcp add. Сервер при этом добавляется в пользовательскую конфигурацию в ~/.copilot/mcp-config.json. Этот файл можно править и вручную — структура та же, что показывает форма.

Третий путь — серверы для каждого репозитория. Такая конфигурация привязана к конкретному проекту, и её удобно коммитить вместе с кодом, чтобы у всей команды был одинаковый набор инструментов.

Четвёртый — поиск и установка из реестра. Документация помечает этот режим как экспериментальный и отсылает за инструкциями по установке, списком доступных инструментов и URL-адресами конкретных серверов к GitHub Реестру MCP.

Управление добавленными серверами идёт двумя наборами команд: /mcp в интерактивном режиме и copilot mcp с терминала. Через них серверы просматриваются, включаются и удаляются.

Сравним два пути подключения.

Ключевое отличие в моменте запуска: в CLI сервер доступен сразу после сохранения конфигурации, в VS Code при запросе нужно подтвердить доверие серверу. Вопросы доверия к конфигурациям CLI документация GitHub выносит в справочник команд GitHub Copilot CLI.

Проверка: список инструментов и пробный вызов с ограниченными правами

Подключение без проверки — это предположение. Проверка состоит из двух шагов: убедиться, что сервер виден, и убедиться, что его инструменты действительно вызываются.

Шаг первый — список серверов. В VS Code откройте палитру команд и выберите «MCP: Список серверов»: GitHub MCP-сервер должен отображаться как настроенный. В Copilot CLI список серверов смотрится через команды /mcp в интерактивном режиме или copilot mcp с терминала. Если сервер в списке есть, конфигурация прочитана.

Шаг второй — список инструментов. У сервера их может быть много, и не все они вам нужны. В CLI это решается полем «Инструменты»: вместо * перечислите нужные имена через запятую. Для VS Code раздел GitHub выбор инструментов не описывает; в Visual Studio, по руководству Microsoft, средства после включения сервера отключены по умолчанию и включаются вручную.

Шаг третий — пробный вызов. Начните с инструмента, который читает данные и ничего не меняет. В документации Microsoft по интеграции Azure MCP с Copilot CLI приведён пример запроса: «List my Azure resource groups». Это образец формулировки для проверки — запрос на чтение списка ресурсов, результат которого виден сразу и который ничего не ломает.

Логика проверки одинакова для любого сервера. Сначала инструмент, который только читает. Потом — тот, который меняет состояние, и только после того, как вы убедились в корректности первого. Права сужайте заранее: если сервер поддерживает выбор инструментов, включите минимум, а расширяйте по мере необходимости.

Отдельно проверьте авторизацию. Если сервер требует входа, убедитесь, что вход выполнен и что выданные области соответствуют вашим ожиданиям. При OAuth сервер видит только утверждённые при входе области; при PAT — объёмы, предоставленные токеном. Ошибка в этом месте выглядит как «инструмент есть, но возвращает отказ».

Для пробного вызова удобно подготовить формулировку заранее. Промпт, чтобы проверить доступные инструменты MCP-сервера и выполнить безопасный вызов на чтение:

Перечисли инструменты MCP-сервера, которые сейчас доступны в этой сессии.
Для каждого укажи назначение одной строкой и отметь, меняет ли он состояние.
Затем выбери один инструмент, который только читает данные, и вызови его
с минимальными параметрами, чтобы показать результат. Ничего не изменяй
и не создавай. Если инструментов нет, скажи об этом прямо.

В этом промпте под себя меняют перечень серверов, если их несколько, и предметную область — вместо общего «данные» можно указать [ваши репозитории] или [ваши ресурсы].

Вариации той же задачи:

Покажи список MCP-серверов, подключённых в этой сессии, и для каждого
перечисли доступные инструменты. Отдельно отметь серверы, которые
сейчас не отвечают.

Вызови инструмент чтения из MCP-сервера [имя сервера] и покажи
сырой результат. Не интерпретируй его, просто выведи.

Сравни набор инструментов двух MCP-серверов: [сервер 1] и [сервер 2].
Покажи, какие задачи покрывает каждый и где они пересекаются.

Проверь, доступен ли инструмент [имя инструмента]. Если да — опиши
его параметры. Если нет — перечисли, какие инструменты этого сервера
доступны сейчас.

Составь список инструментов MCP-сервера [имя сервера], которые меняют
состояние, и предложи, какие из них стоит оставить отключёнными
при обычной работе.

Вызови инструмент чтения из MCP-сервера [имя сервера] и покажи,
какие области доступа он использовал. Ничего не изменяй.

Эти формулировки — наши предлагаемые упражнения. Результат зависит от того, какие серверы вы подключили и какие права им выдали.

Отключение, удаление и типовые ошибки: сервер не стартует, инструментов не видно

Отключение и удаление — часть настройки. В VS Code запись удаляется из mcp.json под ключом servers; остановку сервера раздел GitHub про VS Code не описывает. В Copilot CLI управление идёт командами /mcp в интерактивном режиме и copilot mcp с терминала; удаление записи из ~/.copilot/mcp-config.json даёт тот же результат.

Перед удалением подумайте, что именно вы убираете. Если сервер добавлен для конкретного репозитория, его конфигурация живёт вместе с проектом. Если сервер добавлен в пользовательскую конфигурацию, он доступен во всех проектах, и удаление затронет их все.

Теперь типовые ошибки. Разберём их по симптому.

Сервер не стартует. Первая причина — не подтверждено доверие. В VS Code при запросе нужно убедиться, что вы доверяете серверу для запуска; без этого он не запустится. Вторая — неверная команда запуска для локального сервера: проверьте команду и аргументы, они должны соответствовать свойствам command и args. Третья — отсутствуют переменные среды. PATH наследуется автоматически, а ключи API и токены нужно указать явно в виде пар ключ-значение. Четвёртая — политика организации: при планах Business и Enterprise политика MCP в Copilot должна быть включена.

Инструментов не видно. Первая причина — сервер не запущен. Вторая — поле «Инструменты» в CLI задано так, что нужные инструменты не входят в список. Третья — инструмент существует, но требует платной лицензии: инструменты наследуют требования к доступу тех функций GitHub, которые вызывают. Четвёртая — не выполнена авторизация, и сервер отвечает отказом на вызовы.

Сервер виден, но вызовы отклоняются. Проверьте области доступа. При OAuth сервер работает в пределах утверждённых при входе областей, при PAT — в пределах объёмов токена, и на оба случая накладываются ограничения организации. Если у вас Enterprise Managed User и PAT отключён администратором предприятия, аутентификация по токену не сработает.

Сервер в списке, но в задаче не используется. Проверьте режим чата. В инструкциях для JetBrains и Visual Studio серверы MCP работают в режиме агента.

Порядок разбора один: сначала список серверов, потом список инструментов, потом пробный вызов на чтение, и только затем права и политики. Так вы отсекаете локальные проблемы раньше организационных.

Если ошибка возникает на этапе входа в аккаунт, посмотрите разбор произошла ошибка при регистрации Copilot.

Частые вопросы

Как подключить MCP-сервер к GitHub Copilot в VS Code?

Добавьте сервер через панель расширений по поиску @mcp github либо вручную в файле mcp.json под ключом servers. Затем подтвердите доверие серверу при запросе. Проверьте результат через палитру команд, выбрав «MCP: Список серверов». Ручную настройку инструкция GitHub отсылает к документации самого сервера.

Где хранится конфигурация MCP в Copilot CLI?

Пользовательская конфигурация лежит в файле ~/.copilot/mcp-config.json. Туда сервер попадает при добавлении через подкоманду copilot mcp add из терминала. Файл можно править вручную. Помимо пользовательской конфигурации, серверы добавляются для каждого репозитория отдельно.

Нужна ли платная подписка Copilot для MCP?

GitHub MCP-сервер доступен всем пользователям GitHub независимо от типа тарифного плана. Отдельные инструменты внутри сервера наследуют требования к доступу тех функций GitHub, которые они вызывают. Если функция требует платной лицензии GitHub или Copilot, аналогичный MCP-инструмент потребует той же подписки.

Почему сервер добавлен, а инструментов не видно?

Проверьте, запущен ли сервер: в VS Code без подтверждённого доверия он не стартует. В Copilot CLI посмотрите поле «Инструменты» — при значении * доступны все инструменты, при перечислении имён только указанные. Отдельно проверьте авторизацию и требования к лицензии у конкретного инструмента.

Как удалить MCP-сервер из Copilot?

В Copilot CLI используйте команды /mcp в интерактивном режиме или copilot mcp с терминала, либо удалите запись из ~/.copilot/mcp-config.json. В VS Code уберите запись сервера из mcp.json под ключом servers. Если сервер добавлен для репозитория, правьте конфигурацию проекта.

Если вы составляете запросы к ассистенту, пригодится материал промт для Copilot. А когда понадобится прервать длинную операцию, выручит разбор как остановить Claude Code — механика прерывания похожа в разных ассистентах.