# Настройте MCP-серверы для вашего репозитория
Настройте серверы Model Context Protocol (MCP) для вашего репозитория, чтобы предоставлять Copilot облачный агентОбзор кода Copilot доступ к внешним инструментам и источникам данных.
## Prerequisite
Перед тем как настраивать MCP-серверы для вашего репозитория, прочитайте [О протоколе контекста модели (MCP)](/ru/copilot/concepts/context/mcp) и [AUTOTITLE.](/ru/copilot/concepts/agents/cloud-agent/mcp-and-cloud-agent)
## Introduction
Администратор репозитория позволяет настроить серверы MCP для использования в репозитории. Для этого используется конфигурация в формате JSON, указывающая сведения о серверах MCP, которые вы хотите использовать. Вы вводите конфигурацию JSON напрямую в настройки репозитория на GitHub.com.
Эта конфигурация MCP на уровне репозитория используется и Copilot облачный агентОбзор кода Copilot. Для информации об отключении использования MCP-серверов с Обзор кода Copilotпомощью , см. [Отключение инструментов MCP для Обзор кода Copilot](#disabling-mcp-tools-for-code-review).
> \[!NOTE]
>
> * Поддержка навыков агентов и MCP-серверов Обзор кода Copilot сейчас Публичный предварительный просмотр в системе и может измениться.
> * Существующие конфигурации MCP репозитория, которые ранее управлялись в настройках Copilot облачный агент , автоматически перемещались на новую страницу общих настроек MCP. Никаких действий по миграции не требуется.
По умолчанию MCP-серверы GitHub и Playwright MCP-серверы включены. Вы можете добавить свои собственные MCP-серверы вместе с этими настройками по умолчанию.
Администраторы организаций и предприятий также могут настраивать MCP-серверы в рамках Пользовательские агенты использования YAML frontmatter. Дополнительные сведения см. в разделе [Настройка пользовательских агентов](/ru/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).
> \[!WARNING]
> После настройки MCP-сервера Copilot вы сможете самостоятельно пользоваться инструментами, предоставленными сервером, и не будут спрашивать вашего одобрения перед их использованием.
При настройке MCP-серверов для использования Copilot облачный агент и Обзор кода Copilot, имейте в виду:
* Copilot облачный агент и Обзор кода Copilot поддерживают только инструменты MCP. В настоящее время они не поддерживают ресурсы или подсказки, предоставляемые сервером MCP.
* Copilot облачный агент и Обзор кода Copilot в настоящее время не поддерживают удалённые MCP-серверы, использующие OAuth для аутентификации и авторизации.
## Добавление конфигурации MCP в репозиторий
Администраторы репозитория могут настроить серверы MCP, выполнив следующие действия.
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню ** и нажмите кнопку **"Параметры**".
3. В разделе «Код и автоматизация» боковой панели нажмите **Copilot** « **MCP-серверы**».
4. На странице «Протокол контекста модели (MCP)» добавьте свою конфигурацию в разделе «Конфигурация MCP».
В следующих разделах этой статьи объясняется, как записать конфигурацию JSON, которую необходимо ввести здесь.
5. **Нажмите «Сохранить конфигурацию MCP**».
Ваша конфигурация будет проверена, чтобы обеспечить правильный синтаксис.
6. Если ваш MCP-сервер требует переменную, ключ или секрет, добавьте секрет агента или переменную с именем с префиксом .`COPILOT_MCP_` В вашей конфигурации MCP будут доступны только секреты и переменные агентов с префиксом `COPILOT_MCP_` имен. См [. раздел AUTOTITLE](/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).
## Написание конфигурации JSON для серверов MCP
Серверы MCP настраивают с помощью специального формата JSON. JSON должен содержать `mcpServers` объект, где ключ — это имя сервера MCP (например, `sentry`), а значение — объект с конфигурацией для этого сервера MCP.
```json copy
{
"mcpServers": {
"MCP SERVER 1": {
"command": "VALUE",
"args": [ VALUES ],
...
},
"MCP SERVER 2": {
"command": "VALUE",
"args": [ VALUES ],
...
},
...
}
}
```
Объект конфигурации может содержать следующие ключи:
**Обязательные ключи для локальных и удаленных серверов MCP**
* `tools` (`string[]`): Средства с сервера MCP для включения. Вы можете найти список инструментов в документации сервера или в коде. Настоятельно рекомендуется использовать специальные средства только для чтения, так как агент сможет использовать эти средства автономно и не попросит вас сначала утвердить. Вы также можете включить все средства, в том числе `*` в массив.
* `type` (`string`): Copilot облачный агент принимает `"local"`, `"stdio"`, `"http"`, или `"sse"`.
**Локальные ключи MCP**
* `command` (`string`): Обязательный. Команда, выполняемая для запуска сервера MCP.
* `args` (`string[]`): Обязательный. Аргументы, которые необходимо передать в `command`.
* `env` (`object`): Необязательно. Переменные среды для передачи серверу. Этот объект должен отображать имя переменной среды, которая должна быть доступна вашему MCP-серверу, в одну из следующих версий:
* Подстановка — ссылка на секрет или переменную в вашей Copilot среде, например `$COPILOT_MCP_API_KEY` или `${COPILOT_MCP_API_KEY}`. Ссылки на названия должны начинаться с `COPILOT_MCP_`.
* Буквальное значение строки.
**Удаленные ключи MCP**
* `url` (`string`): Обязательный. URL-адрес сервера MCP.
* `headers` (`object`): Необязательно. Заголовки для присоединения к запросам к серверу. Этот объект должен сопоставить имена заголовочных ключей с одним из следующих элементов:
* Подстановка — ссылка на секрет или переменную в вашей Copilot среде, например `$COPILOT_MCP_API_KEY` или `${COPILOT_MCP_API_KEY}`. Ссылки на названия должны начинаться с `COPILOT_MCP_`.
* Буквальное значение строки.
Обратите внимание, что все `string` поля, `string[]` кроме `tools` и поддерживают `type` подстановку переменной или секретом, который вы настроили в вашей Copilot среде.
### Замена переменных
Для ссылок на переменные среды, настроенные в вашей Copilot среде, поддерживаются следующие синтаксические паттерны:
| Syntax | Example |
| ----------------- | ---------------------------------------- |
| `$VAR` | `$COPILOT_MCP_API_KEY` |
| `${VAR}` | `${COPILOT_MCP_API_KEY}` |
| `${VAR:-default}` | `${COPILOT_MCP_API_KEY:-fallback_value}` |
## Примеры конфигураций
Примеры ниже показывают конфигурации серверов MCP для разных провайдеров.
* [Часовой](#example-sentry)
* [Понятие](#example-notion)
* [Azure](#example-azure)
* [Cloudflare](#example-cloudflare)
* [Azure DevOps](#example-azure-devops)
* [Atlassian](#example-atlassian)
### Пример: Sentry
[Сервер Sentry MCP](https://github.com/getsentry/sentry-mcp) предоставляет Copilot аутентифицированный доступ к исключениям, записанным в [Sentry](https://sentry.io).
```javascript copy
// If you copy and paste this example, you will need to remove the comments prefixed with `//`, which are not valid JSON.
{
"mcpServers": {
"sentry": {
"type": "local",
"command": "npx",
// We can use the $SENTRY_HOST environment variable which is passed to
// the server because of the `env` value below.
"args": ["@sentry/mcp-server@latest", "--host=$SENTRY_HOST"],
"env": {
// We can specify an environment variable value as a string...
"SENTRY_HOST": "https://contoso.sentry.io",
// or refer to a variable or secret in your Copilot environment
// with a name starting with `COPILOT_MCP_`
"SENTRY_ACCESS_TOKEN": "$COPILOT_MCP_SENTRY_ACCESS_TOKEN"
}
}
}
}
```
### Пример: понятие
[Сервер MCP Notion](https://github.com/makenotion/notion-mcp-server) предоставляет Copilot аутентифицированный доступ к заметкам и другому контенту от [Notion](https://notion.so).
```javascript copy
// If you copy and paste this example, you will need to remove the comments prefixed with `//`, which are not valid JSON.
{
"mcpServers": {
"notionApi": {
"type": "local",
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
// We can use the $NOTION_API_KEY environment variable which is passed to
// the server because of the `env` value below.
"OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer $NOTION_API_KEY\", \"Notion-Version\": \"2022-06-28\"}",
"mcp/notion"
],
"env": {
// The value of the `COPILOT_MCP_NOTION_API_KEY` secret will be passed to the
// server command as an environment variable called `NOTION_API_KEY`
"NOTION_API_KEY": "$COPILOT_MCP_NOTION_API_KEY"
},
"tools": ["*"]
}
}
}
```
### Пример: Azure
Репозиторий [Microsoft MCP](https://github.com/microsoft/mcp) включает Azure MCP-сервер, который позволяет Copilot понимать ваши Azure-специфические файлы и Azure ресурсы в вашей подписке при внесении изменений в код.
Чтобы автоматически настроить репозиторий с помощью `copilot-setup-steps.yml` файла для аутентификации с помощью Azure, а также секретов для аутентификации, клонируйте репозиторий локально, а затем запустите команду [Azure Developer CLI](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/?ref_product=copilot\&ref_type=engagement\&ref_style=button)`azd cloud-agent config` в корне репозитория.
После выполнения команды и объединения созданного запроса на вытягивание вы можете добавить конфигурацию MCP в свой репозиторий.
```json copy
{
"mcpServers": {
"Azure": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@azure/mcp@latest",
"server",
"start"
],
"tools": ["*"]
}
}
}
```
### Пример: Cloudflare
Сервер [](https://github.com/cloudflare/mcp-server-cloudflare) Cloudflare MCP создает подключения между службами Cloudflare, включая обработку документации и анализа данных.
```json copy
{
"mcpServers": {
"cloudflare": {
"type": "sse",
"url": "https://docs.mcp.cloudflare.com/sse",
"tools": ["*"]
}
}
}
```
### Пример: Azure DevOps
MCP-сервер [Azure DevOps ](https://github.com/microsoft/azure-devops-mcp) создает бесшовное соединение между Copilot и вашими Azure DevOps-сервисами, включая рабочие элементы, конвейеры или документацию.
Чтобы использовать Azure DevOps MCP-сервер с Copilot облачный агент, необходимо обновить copilot-setup-steps.yml файл репозитория, включив Azure этап входа.
1. Настройте OIDC в Microsoft Entra приложении, доверяя GitHub. См. [Используйте действие Azure Login с OpenID Connect](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect).
2. Настройте доступ к организации и проектам Azure DevOps для идентификации приложения. См. статью ["Добавление пользователей организации" и управление доступом](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/add-organization-users).
3. Добавьте файл рабочего процесса Actions в репозиторий `.github/workflows/copilot-setup-steps.yml` , если его еще нет.
4. Добавьте Azure шаг входа в рабочий процесс `copilot-setup-steps`.
```yaml copy
# Этот рабочий процесс использует действия, которые не сертифицированы GitHub.
# Они предоставляются сторонним поставщиком, и на них распространяются
# отдельные условия обслуживания, политика конфиденциальности и поддержка
# документации.
on:
workflow_dispatch:
permissions:
id-token: write
contents: read
jobs:
copilot-setup-steps:
runs-on: ubuntu-latest
permissions:
id-token: write
contents: read
environment: copilot
steps:
- name: Azure login
uses: azure/login@a457da9ea143d694b1b9c7c869ebb04ebe844ef5
with:
client-id: ${{ secrets.AZURE_CLIENT_ID }}
tenant-id: ${{ secrets.AZURE_TENANT_ID }}
allow-no-subscriptions: true
```
Эта конфигурация гарантирует `azure/login` , что действие выполняется при Copilot облачный агент выполнении.
5. Настройте секреты для себя `AZURE_CLIENT_ID` и `AZURE_TENANT_ID` как агентов на уровне организации или репозитория. Дополнительные сведения см. в разделе [Настройте секреты и переменные для облачного агента Copilot](/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).
6. Настройте Azure DevOps MCP-сервер, добавив объект `ado` в конфигурацию MCP с помощью инструментов, которые вы хотите использовать Copilot.
```json copy
{
"mcpServers": {
"ado": {
"type": "local",
"command": "npx",
"args": ["-y", "@azure-devops/mcp", "", "-a", "azcli"],
"tools": ["wit_get_work_item", "wit_get_work_items_batch_by_ids", ...]
}
}
}
```
### Пример: Atlassian
[Сервер Atlassian MCP](https://github.com/atlassian/atlassian-mcp-server) предоставляет Copilot аутентифицированный доступ к вашим приложениям Atlassian, включая Jira, Compass и Confluence.
Для получения дополнительной информации об аутентификации на сервере Atlassian MCP с использованием ключа API см. раздел [«Конфигурирование аутентификации через API](https://support.atlassian.com/atlassian-rovo-mcp-server/docs/configuring-authentication-via-api-token/) token» в документации Atlassian.
```javascript copy
// If you copy and paste this example, you will need to remove the comments prefixed with `//`, which are not valid JSON.
{
"mcpServers": {
"atlassian-rovo-mcp": {
"command": "npx",
"type": "local",
"tools": ["*"],
"args": [
"mcp-remote@latest",
"https://mcp.atlassian.com/v1/mcp",
// We can use the $ATLASSIAN_API_KEY environment variable which is passed
// to the server because of the `env` value below.
"--header",
"Authorization: Basic $ATLASSIAN_API_KEY"
],
"env": {
// The value of the `COPILOT_MCP_ATLASSIAN_API_KEY` secret will be passed
// to the server command as an environment variable
// called `ATLASSIAN_API_KEY`.
"ATLASSIAN_API_KEY": "$COPILOT_MCP_ATLASSIAN_API_KEY"
}
}
}
}
```
## Повторное использование конфигурации MCP из Visual Studio Code
Если вы уже настроили MCP-серверы в VS Code, вы можете использовать аналогичную конфигурацию для настроек MCP вашего репозитория на GitHub.
В зависимости от VS Code настройки, вы можете найти настройки MCP в файле `.vscode/mcp.json` репозитория или в приватном `settings.json` файле компьютера.
Чтобы адаптировать конфигурацию для настроек репозитория MCP на GitHub, вам понадобится:
1. Добавьте ключ `tools` для каждого MCP-сервера, указывая, какие инструменты будут доступны для Copilot.
2. Если вы настроили, `inputs`переключитесь на использование `env` напрямую.
3. Если вы настроили параметр `envFile`, переключитесь на использование `env` напрямую.
4. Обновите все ссылки `inputs` на конфигурацию `args` , чтобы вместо этого ссылаться на переменные `env` среды.
Для получения дополнительной информации о MCP в VS Code, см. [VS Code документацию](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).
## Проверка конфигурации MCP
После настройки конфигурации MCP необходимо протестировать его, чтобы убедиться, что он настроен правильно.
### Валидировать с помощью Copilot облачный агент
1. Создайте проблему в репозитории, затем назначите её на Copilot.
2. Подождите несколько секунд и Copilot оставьте 👀 реакцию по этому вопросу.
3. Подождите ещё несколько секунд и Copilot создам pull request, который появится в таймлайне задачи.
4. Нажмите на созданный pull request в таймлайне и дождитесь, пока появится событие «Copilot начал работу».
5. Нажмите **«Просмотр сессии** », чтобы открыть Copilot облачный агент логи.
6. Нажмите кнопку многоточия (**...**) в правом верхнем углу просмотра журналов, затем нажмите **Copilot** в боковой панели.
7. Щелкните шаг "Пуск СЕРВЕРА MCP"\*\*, \*\*чтобы развернуть журналы.
8. Если серверы MCP успешно запущены, вы увидите их инструменты, перечисленные в нижней части журналов.
Если вашим MCP-серверам нужны зависимости, которые по умолчанию не установлены на GitHub Actions Runner, `uv` например и `pipx`, или требуют специальных шагов настройки, возможно, потребуется создать `copilot-setup-steps.yml` файл рабочего процесса Actions для их установки. Дополнительные сведения см. в разделе [Настройка среды разработки](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment).
### Валидировать с помощью Обзор кода Copilot
1. Откройте pull request в репозитории.
2. Запросите отзыв у Copilot.
3. Откройте связанную сессию обзора из таймлайн pull request, **нажав View session**. В журналах сессий просмотрите раздел «Настройка среды», чтобы увидеть, какие MCP-серверы и инструменты были запущены и вызваны.
## Настройка встроенного GitHub MCP-сервера
GitHub MCP-сервер по умолчанию активирован и подключается GitHub с помощью специально ограниченного токена, который имеет доступ только для чтения текущего репозитория.
Если вы хотите разрешить Copilot доступ к данным вне текущего репозитория, вы можете предоставить им personal access token более широкий доступ.
1. Создайте personal access token с соответствующими правами. Мы рекомендуем использовать fine-grained personal access token, где можно ограничить доступ токена только для чтения в определённых репозиториях. Для получения дополнительной информации см personal access tokens. [Управление личными маркерами доступа](/ru/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
2. На GitHubперейдите на главную страницу репозитория.
3. Под именем репозитория щелкните ** Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню ** и нажмите кнопку **"Параметры**".
4. В разделе «Код и автоматизация» боковой панели нажмите **Copilot** « **MCP-серверы**».
5. Добавьте свою конфигурацию в разделе «MCP configuration». Например, вы можете добавить следующее:
```javascript copy
// If you copy and paste this example, you will need to remove the comments prefixed with `//`, which are not valid JSON.
{
"mcpServers": {
"github-mcp-server": {
"type": "http",
// Remove "/readonly" to enable wider access to all tools.
// Then, use the "X-MCP-Toolsets" header to specify which toolsets you'd like to include.
// Use the "tools" field to select individual tools from the toolsets.
"url": "https://api.githubcopilot.com/mcp/readonly",
"tools": ["*"],
"headers": {
"X-MCP-Toolsets": "repos,issues,users,pull_requests,code_security,secret_protection,actions,web_search"
}
}
}
}
```
Для получения дополнительной информации о наборах инструментов обратитесь [к README](https://github.com/github/github-mcp-server?tab=readme-ov-file#available-toolsets) в документации GitHub по Remote MCP Server.
6. **Нажмите «Сохранить конфигурацию MCP**».
7. Добавьте секрет агента с `COPILOT_MCP_GITHUB_PERSONAL_ACCESS_TOKEN`personal access token вашим значением. Вы можете настроить это как на уровне организации, так и на уровне репозитория. Дополнительные сведения см. в разделе [Настройте секреты и переменные для облачного агента Copilot](/ru/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).
Для информации об использовании GitHub MCP-сервера в других условиях см. [Использование GitHub MCP сервера в вашем IDE](/ru/copilot/customizing-copilot/using-model-context-protocol/using-the-github-mcp-server).
## Отключение инструментов MCP для проверки кода
> \[!NOTE]
> Поддержка навыков агентов и MCP-серверов Обзор кода Copilot сейчас Публичный предварительный просмотр в системе и может измениться.
В настройках репозитория по умолчанию включено использование инструментов MCP by Обзор кода Copilot by.
Отключите эту настановку, если хотите, чтобы настроенные MCP-серверы были доступны только для Copilot облачный агент, а не для Обзор кода Copilot.
Если отключить эту начёт, Обзор кода Copilot не будет вызывать MCP tools для просмотров pull request в этом репозитории, включая инструменты с серверов по умолчанию GitHub и Playwright MCP.
1. На GitHubперейдите на главную страницу репозитория.
2. Под именем репозитория щелкните ** Settings**. Если вкладка "Параметры" не отображается, выберите **раскрывающееся меню ** и нажмите кнопку **"Параметры**".
3. В разделе «Код и автоматизация» боковой панели нажмите **Copilot** « **Code review**».
4. Нажмите переключатель **Разрешить Copilot использовать инструменты MCP при просмотре pull request** чтобы отключить настройки.
## Дальнейшие действия
* [Добавление MCP-серверов для интерфейс командной строки GitHub Copilot](/ru/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)
* [Использование обзора кода GitHub Copilot](/ru/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review)
* [Создание кастомных агентов для Copilot облачный агент](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents)
* [Настройка среды разработки](/ru/copilot/how-tos/use-copilot-agents/cloud-agent/customize-the-agent-environment)
* [Расширение GitHub Copilot Chat с помощью серверов Model Context Protocol (MCP)](/ru/copilot/customizing-copilot/extending-copilot-chat-with-mcp)