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