Протокол контекста модели (MCP)

Подключитесь Copilot к внешним средствам и данным с помощью серверов протокола MCP.

В этой статье

Обзор протокола контекста модели (MCP)

Протокол контекста модели (MCP) — это открытый стандарт, определяющий, как приложения используют контекст с большими языковыми моделями (LLM). MCP предоставляет стандартный способ подключения моделей ИИ к различным источникам данных и средствам, что позволяет им эффективнее работать вместе.

Вы можете использовать MCP для расширения возможностей, GitHub Copilot интегрируя его с широким спектром существующих инструментов и сервисов. MCP работает на всех основных Copilot поверхностях — будь то работа в IDE, использование GitHub Copilot CLI, работа в GitHub Copilot app, или делегирование задач агенту на GitHub.com. Вы также можете использовать MCP для создания новых инструментов и сервисов, которые позволяют Copilotнастраивать и улучшать свой опыт.

Например, вы можете подключить средство отслеживания проблем, чтобы Copilot найти ошибку во время работы с исправлением, не запрашивая копирование проблемы в чат.

Дополнительные сведения о MCP см . в официальной документации ПО MCP. Для отображённого списка MCP-серверов от партнёров и сообщества см. GitHub Реестр MCP.

Предприятия и организации могут выбрать возможность включить или отключить использование MCP для членов своей организации или предприятия с использованием MCP-серверов в Copilot политике. Политика отключена по умолчанию. См. раздел [AUTOTITLE и Управление политиками и функциями GitHub Copilot в вашем предприятии](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies). Политика MCP применяется только к пользователям, у которых есть Copilot BusinessCopilot Enterprise подписка от организации или предприятия, настраивающего эту политику. Copilot Free, Copilot Pro, Copilot Pro+Copilot Max**** не имеют доступа к MCP под этой политикой.

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

Подключите службу один раз через GitHubпроверенные серверы MCP (соединители), а затем используйте подключение между поддерживаемыми Copilot поверхностями, не повторяя настройку или вход отдельно в каждой из них. Эти подключения также работают в сеансах, работающих в Copilot облачной песочнице, но не в сеансах, работающих в GitHub Actions. См . раздел AUTOTITLE.

Где можно использовать MCP

Настройка MCP зависит от того, где используется:Copilot

  • : GitHub Copilot app можно использовать серверы MCP, настроенные для репозитория или в локальной Copilot конфигурации. Вы также можете обнаружить и установить дополнительные серверы MCP на вкладке "Настройка ".
  • Copilot CLI: GitHub Copilot CLI поддерживает как локальные, так и удалённые MCP-серверы. GitHub MCP-сервер встроен и доступен без дополнительной конфигурации.
  • Copilot cloud agent (включая automations) и Copilot code review: GitHub.com поддерживает серверы MCP, настроенные на уровне репозитория. Конфигурация применяется к Copilot cloud agentи automationsCopilot code review. GitHub Серверы MCP и серверы Playwright MCP настроены по умолчанию.
  • IdEs: серверы MCP поддерживаются в Visual Studio Code, Visual Studio, Среды разработки JetBrainsXcode и Eclipse. Параметры подключения и проверки подлинности зависят от интегрированной среды разработки. См . раздел AUTOTITLE.

GitHub.com В чате есть предварительно настроенные средства, такие как средства для создания ветвей и поиска кода. Это отличается от параметров MCP репозитория для Copilot cloud agent и Copilot code review. См . раздел AUTOTITLE.

MCP для Copilot cloud agent

В следующих разделах описаны значения по умолчанию и конфигурации MCP для Copilot cloud agent, включая automations. Параметры MCP уровня репозитория также применяются к Copilot code reviewприведенным ниже параметрам. Для других поверхностей используйте руководства по настройке в следующих шагах.

Серверы MCP по умолчанию

Copilot cloud agent начинается с двух настроенных серверов MCP:

  • GitHub предоставляет доступ к данным репозитория, таким как проблемы и запросы на вытягивание. По умолчанию он использует специально ограниченный маркер с доступом только для чтения к текущему репозиторию. Доступ за пределами этого репозитория требует явной настройки учетных данных с более широким доступом.
  • Playwright предоставляет средства для чтения, взаимодействия и создания снимок экрана веб-страниц. По умолчанию он может получить доступ только к веб-ресурсам в собственной среде агента через localhost или 127.0.0.1.

Эти значения по умолчанию относятся к облачной среде. Например, Copilot CLI включает GitHub сервер MCP без дополнительной настройки, но настраиваете другие серверы отдельно.

Личные серверы MCP

Личные серверы MCP подключаются Copilot к средствам и данным для собственного рабочего процесса. Настройте сервер один раз, чтобы сделать его доступным в каждом запущенном облачном сеансе. Эти серверы доступны только для вас и не влияют на других пользователей, работающих в одном репозитории.

Перед настройкой личного сервера MCP проверьте, охватывает GitHubли необходимая служба проверенными серверами MCP (соединителями). GitHub-проверенные серверы MCP доступны как в облаке, так и в локальных сеансах, а GitHub также обрабатывает конфигурацию сервера MCP и проверку подлинности для вас. В отличие от этого, личные серверы MCP поддерживают только проверку подлинности на основе ключей и доступны только в облачных песочницах. См . раздел AUTOTITLE.

Используйте личные серверы MCP для подключений, необходимых для репозиториев или для которых требуются собственные учетные данные. Чтобы предоставить общую конфигурацию для сотрудников, работающих в определенном репозитории, используйте вместо этого конфигурацию уровня репозитория .

  1. Перейдите на Copilot домашнюю страницу github.com/copilot.
  2. В меню слева выберите меню "Настройка ".
  3. Проверьте, охватывает ли необходимая служба проверенным сервером GitHubMCP.
  4. Если проверенный GitHubсервер MCP не соответствует вашим потребностям и вы хотите настроить собственный сервер MCP, выберите раскрывающееся меню "Добавить" и выберите сервер MCP.
  5. Введите имя сервера, тип транспорта, URL-адрес или команду запуска и другую необходимую конфигурацию.
  6. Если требуется проверка подлинности, создайте секреты в личных секретах сервера MCP с именами, префиксами COPILOT_MCP_, например COPILOT_MCP_API_KEY, и на них ссылаются в конфигурации сервера.
  7. Нажмите кнопку "Добавить сервер".

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

Limitations

  • Личные серверы MCP доступны в каждом облачном сеансе. В настоящее время нельзя выбрать, какие серверы следует включить для отдельного сеанса.
  • Пользовательские серверы HTTP и SSE MCP не поддерживают параметры запроса в URL-адресах. Передайте эти значения в качестве заголовков запросов.
  • Если сервер недоступен, проверьте его конфигурацию и убедитесь, что все необходимые секреты существуют и доступны для учетной записи или организации, в которой выполняется сеанс.
  • В общей сложности можно использовать до 50 серверов MCP в общей сложности в конфигурациях личного и репозитория.

Конфигурация уровня репозитория

Серверы MCP уровня репозитория подключаются Copilot к средствам и данным для работы в определенном репозитории. Администраторы репозитория настраивают эти серверы в параметрах GitHub.comрепозитория, а конфигурация доступна всем пользователям с доступом на запись в репозиторий. Эти параметры применяются как к Copilot in the cloud (включая automations) так и Copilot code review. Вы можете отключить средство MCP для проверки кода отдельно.

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

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

Этот параметр репозитория отличается от файлов конфигурации проекта MCP, используемых Copilot CLI. Используйте руководство по настройке для вашей поверхности, а не предполагайте, что одно и то же расположение конфигурации применяется везде.

Automations может использовать средства на этих серверах MCP, но только те средства, которые вы выбираете для каждого automation. См . раздел AUTOTITLE.

Предупреждение

При делегировании работы Copilot@mentioning с ним или назначении его проблемы или запроса на вытягивание использует Copilot настроенные средства MCP автономно и не запрашивает утверждение перед вызовом. Для этих рабочих процессов просмотрите каждый сервер и разрешите только средства и доступ, необходимые для выполнения задач.

При настройке MCP-серверов для использования Copilot cloud agent и Copilot code review, имейте в виду:

  • Copilot cloud agent и Copilot code review поддерживают только инструменты MCP. В настоящее время они не поддерживают ресурсы или подсказки, предоставляемые сервером MCP.
  • Для серверов MCP, настроенных в параметрах репозитория или профилях пользовательских агентов, Copilot cloud agent и Copilot code review в настоящее время не поддерживают удаленные серверы, использующие OAuth для проверки подлинности и авторизации.

Copilot code review кроме того, требуются средства для объявления annotations.readOnlyHint: true. Средства с этой заметкой, отсутствующие или заданные, false исключены.

Инструкции по настройке, проверке подлинности и проверке см. в разделе Настройте MCP-серверы для вашего репозитория.

Серверы MCP для пользовательских агентов

Для Copilot cloud agentэтого профиля агента можно определить серверы MCP для этого пользовательского агента, а не сделать их доступными для каждого агента, работающего в репозитории. mcp-servers Свойство профиля не используется пользовательскими агентами, работающими непосредственно в idEs.

Для Copilot cloud agentэтого сначала обрабатываются конфигурации сервера по умолчанию, а затем пользовательские конфигурации агента, а затем параметры репозитория. Более поздние конфигурации могут переопределить более ранние параметры. Этот порядок не описывает приоритет файла проекта в Copilot CLI.

Сведения о формате профиля, поддерживаемых свойствах и правилах обработки см. в разделе Настройка пользовательских агентов.

Лучшие практики

  • Просмотрите сторонние серверы перед их включением. Проверьте свои средства, требования к проверке подлинности и доступ к данным в соответствии с требованиями вашей организации.
  • Включите только средства, необходимые задаче. В параметрах репозитория используйте tools поле, чтобы разрешить определенные инструменты, предпочтительно доступные только для чтения, а не включить все средства. В automationsполе выберите необходимые инструменты.
  • Сохраняйте учетные данные в области необходимых ресурсов. Не расширяйте доступ маркера по умолчанию, Copilot cloud agent если задача не нуждается в ней.
  • Прежде чем полагаться на него, проверьте конфигурацию. Убедитесь, какие серверы и средства доступны в сеансе агента. Инструкции по настройке среды см. в следующих шагах.

О GitHub сервере MCP

MCP-сервер GitHub — это сервер Model Context Protocol (MCP), предоставляемый и поддерживаемый GitHub.

GitHub MCP-сервер может использоваться для:

  • Автоматизация и упрощение задач, связанных с кодом.
  • Подключайте сторонние инструменты (такие как Cursor, Windsurf или будущие интеграции), чтобы использовать GitHubвозможности контекста и ИИ.
  • Включите облачные рабочие процессы, работающие с любого устройства без локальной настройки.
  • Вызывайте GitHub инструменты, такие как Copilot cloud agent (требуется GitHub Copilot подписка) и code scanning (требуется GitHub Advanced Security подписка), для помощи в генерации кода и анализе безопасности.

Чтобы научиться пользоваться GitHub MCP-сервером, смотрите Использование GitHub MCP сервера в вашем IDE.

Чтобы узнать, поддерживает ли ваш редактор MCP-сервер GitHub и какие методы подключения и аутентификации доступны, см. раздел «Поддержка по хост-приложению » в github/github-mcp-server репозитории.

Удаленный доступ

Вы можете получить доступ к GitHub MCP-серверу удалённо через Copilot Chat вход Visual Studio Code без какой-либо локальной настройки. Удалённый сервер имеет доступ к дополнительным наборам инструментов, доступным только на удалённом GitHub сервере MCP. Список таких инструментов см. Дополнительные наборы инструментов в репозитории github/github-mcp-server.

MCP-сервер также может работать локально в любом редакторе, GitHub совместимом с MCP, при необходимости.

Настройка набора инструментов

Внимание

Всегда проверяйте GitHub репозиторий сервера MCP на github/github-mcp-server для получения последних наборов инструментов и авторитетных рекомендаций по конфигурации.

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

Включение только необходимых наборов инструментов повышает производительность и безопасность вашего AI-помощника. Меньшее количество инструментов означает лучшую точность выбора инструментов и меньше ошибок. Отключение неиспользуемых наборов инструментов также освобождает токены в контекстном окне ИИ.

Наборы инструментов включают не только инструменты, но и соответствующие ресурсы MCP и подсказки, где это применимо.

Чтобы узнать, как настроить наборы инструментов для GitHub MCP-сервера, см. раздел AUTOTITLE.

Security

Для всех публичных репозиториев и приватных репозиториев, охваченных GitHub Advanced Security, взаимодействие с GitHub сервером MCP защищено push-защитой, которая блокирует секреты в ответах, созданных ИИ, и предотвращает их включение в действия, предпринимаемые от вашего имени. Вы также можете проактивно сканировать код на наличие раскрытых секретов внутри вашего AI-кодингового агента. Дополнительные сведения см. в разделе Сканирование секретов с помощью сервера GitHub MCP.

О GitHub реестре MCP

GitHub Реестр MCP — это отобранный список серверов MCP от партнёров и сообщества. Вы можете использовать реестр для обнаружения новых серверов MCP и поиска тех, которые соответствуют вашим потребностям.

Примечание.

GitHub Реестр MCP в настоящее Публичный предварительный просмотр время находится и может измениться.

Поиск агентов

Agent finder — это сервис обнаружения, который помогает GitHub Copilot найти нужные возможности — такие как MCP-серверы, инструменты, агенты и навыки — для задачи во время выполнения, вместо того чтобы требовать заранее настраивать все возможности. Как и реестр MCP, он ищет каталог возможностей и возвращает ранжированные совпадения, которые GitHub Copilot можно использовать по запросу. Agent finder реализует спецификацию открытого обнаружения агентных ресурсов (ARD).

Сведения о Copilot CLI настройке см. в разделе "Использование средства поиска агента". Предоставляет GitHub Copilot app встроенный af навык. См . раздел AUTOTITLE. Чтобы просмотреть каталог, смотрите GitHub Agent Finder.

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