{"meta":{"title":"Configurar servidores MCP para seu repositório","intro":"Configure os servidores MCP (Model Context Protocol) do seu repositório para dar a Copilot cloud agent e Copilot code review acesso a ferramentas externas e fontes de dados.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-on-github","title":"Copilot em GitHub"},{"href":"/pt/copilot/how-tos/copilot-on-github/customize-copilot","title":"Personalizar Copilot"},{"href":"/pt/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers","title":"Configurar servidores MCP"}],"documentType":"article"},"body":"# Configurar servidores MCP para seu repositório\n\nConfigure os servidores MCP (Model Context Protocol) do seu repositório para dar a Copilot cloud agent e Copilot code review acesso a ferramentas externas e fontes de dados.\n\n## Prerequisite\n\nAntes de configurar servidores MCP para seu repositório, leia [Sobre o Protocolo de Contexto de Modelo (MCP)](/pt/copilot/concepts/context/mcp) e [Protocolo de Contexto de Modelo (MCP) e agente na nuvem GitHub Copilot](/pt/copilot/concepts/agents/cloud-agent/mcp-and-cloud-agent).\n\n## Introdução\n\nComo administrador de repositório, você pode configurar servidores MCP para uso em seu repositório. Isso é feito por meio de uma configuração formatada em JSON que especifica os detalhes dos servidores MCP que você deseja usar. Insira a configuração JSON diretamente nas configurações do repositório em GitHub.com.\n\nEssa configuração de MCP no nível do repositório é compartilhada por Copilot cloud agent e Copilot code review. Para obter informações sobre como desativar o uso de servidores MCP por Copilot code review, consulte [Desativando ferramentas MCP para Copilot code review](#disabling-mcp-tools-for-code-review).\n\n> \\[!NOTE]\n> As configurações de MCP existentes do repositório, que antes eram gerenciadas nas configurações Copilot cloud agent, foram movidas automaticamente para a nova página de configurações compartilhadas do MCP. Nenhuma ação de migração é necessária.\n\nO GitHub servidor MCP e o servidor MCP do Dramaturgo são habilitados por padrão. Você pode adicionar seus próprios servidores MCP junto com esses padrões.\n\nAdministradores de organização e corporativos também podem configurar servidores MCP como parte do custom agents usando o frontmatter YAML. Para obter mais informações, consulte [Configuração de agentes personalizados](/pt/copilot/reference/custom-agents-configuration#mcp-server-configuration-details).\n\n> \\[!WARNING]\n> Depois de configurar um servidor MCP, Copilot você poderá usar as ferramentas fornecidas pelo servidor de forma autônoma e não solicitará sua aprovação antes de usá-las.\n\nAo configurar servidores MCP para uso por Copilot cloud agent e Copilot code review, tenha em mente:\n\n* Copilot cloud agent e Copilot code review dá suporte apenas a ferramentas MCP. No momento, eles não dão suporte a recursos ou prompts fornecidos pelo servidor MCP.\n* Copilot cloud agent e Copilot code review atualmente não dão suporte a servidores MCP remotos que aproveitam o OAuth para autenticação e autorização.\n\n## Adicionar uma configuração do MCP ao seu repositório\n\nOs administradores do repositório podem configurar servidores MCP seguindo estas etapas:\n\n1. Em GitHub, acesse a página principal do repositório.\n\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n3. Na barra lateral, em \"Código, planejamento e automação\", clique em **Copilot** e depois em **servidores MCP**.\n\n4. Na página \"Protocolo de Contexto de Modelo (MCP)\", adicione sua configuração na seção \"Configuração do MCP\".\n\n As seções a seguir neste artigo explicam como escrever a configuração JSON que você precisa inserir aqui.\n\n5. Clique em **Salvar configuração do MCP**.\n\n Sua configuração será validada para garantir a sintaxe adequada.\n\n6. Se o seu servidor MCP exigir uma variável, chave ou segredo, adicione um segredo ou uma variável do Agents com um nome precedido de `COPILOT_MCP_`. Somente segredos e variáveis dos Agentes, cujos nomes são prefixados com `COPILOT_MCP_`, estarão disponíveis para a configuração do MCP. Consulte [Configurar segredos e variáveis para Copilot agente de nuvem](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).\n\n## Escrever uma configuração JSON para servidores MCP\n\nVocê configura servidores MCP usando um formato JSON especial. O JSON deve conter um objeto `mcpServers`, em que a chave é o nome do servidor MCP (por exemplo, `sentry`) e o valor é um objeto com a configuração desse servidor 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\nO objeto de configuração pode conter as seguintes chaves:\n\n**Chaves necessárias para servidores MCP locais e remotos**\n\n* `tools` (`string[]`): as ferramentas do servidor MCP para habilitar. Você pode encontrar uma lista de ferramentas na documentação do servidor ou em seu código. É altamente recomendável permitir a lista de ferramentas específicas somente leitura, pois o agente poderá usar essas ferramentas de maneira autônoma e não solicitará aprovação primeiro. Você também pode habilitar todas as ferramentas incluindo `*` na matriz.\n* `type` (`string`): Copilot cloud agent aceita `\"local\"`, `\"stdio\"`, `\"http\"`ou `\"sse\"`.\n\n**Chaves específicas do MCP local**\n\n* `command` (`string`): obrigatório. O comando a ser executado para iniciar o servidor MCP.\n* `args` (`string[]`): obrigatório. Os argumentos a serem passados a `command`.\n* `env` (`object`): opcional. As variáveis de ambiente a serem passadas para o servidor. Esse objeto deve mapear o nome da variável de ambiente que deve ser exposta ao servidor MCP para um dos seguintes:\n * Uma referência de substituição para um segredo ou variável no seu ambiente do Copilot, como `$COPILOT_MCP_API_KEY` ou `${COPILOT_MCP_API_KEY}`. Os nomes referenciados devem começar com `COPILOT_MCP_`.\n * Um valor de string literal.\n\n**Chaves específicas do MCP remoto**\n\n* `url` (`string`): obrigatório. A URL do servidor MCP.\n* `headers` (`object`): opcional. Os cabeçalhos a serem anexados às solicitações ao servidor. Esse objeto deve mapear o nome das chaves de cabeçalho para um dos seguintes:\n * Uma referência de substituição para um segredo ou variável no seu ambiente do Copilot, como `$COPILOT_MCP_API_KEY` ou `${COPILOT_MCP_API_KEY}`. Os nomes referenciados devem começar com `COPILOT_MCP_`.\n * Um valor de string literal.\n\nObserve que todos os campos `string` e `string[]`, exceto `tools` e `type`, suportam a substituição por uma variável ou segredo que você configurou no seu ambiente Copilot.\n\n### Substituição de variável\n\nOs seguintes padrões de sintaxe têm suporte para referenciar variáveis de ambiente configuradas em seu Copilot ambiente:\n\n| Sintaxe | Exemplo |\n| ----------------- | ---------------------------------------- |\n| `$VAR` | `$COPILOT_MCP_API_KEY` |\n| `${VAR}` | `${COPILOT_MCP_API_KEY}` |\n| `${VAR:-default}` | `${COPILOT_MCP_API_KEY:-fallback_value}` |\n\n## Configurações de exemplo\n\nOs exemplos abaixo mostram as configurações do servidor MCP para provedores diferentes.\n\n* [Sentry](#example-sentry)\n* [Notion](#example-notion)\n* [Azure](#example-azure)\n* [Cloudflare](#example-cloudflare)\n* [Azure DevOps](#example-azure-devops)\n* [Atlassian](#example-atlassian)\n\n### Exemplo: Sentry\n\nO [servidor MCP do Sentry](https://github.com/getsentry/sentry-mcp) fornece Copilot acesso autenticado a exceções registradas no [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### Exemplo: Notion\n\nO [servidor NOÇÃO MCP](https://github.com/makenotion/notion-mcp-server) fornece Copilot acesso autenticado a anotações e outros conteúdos do [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### Exemplo: Azure\n\nO repositório MCP da Microsoft inclui o servidor MCP do Azure, que permite compreender seus arquivos específicos do Azure e os recursos do Azure na sua assinatura ao fazer alterações de código.\n\nPara configurar automaticamente seu repositório com um arquivo `copilot-setup-steps.yml` para autenticação com o Azure, além de segredos para autenticação, clone o repositório localmente e execute o comando [](https://learn.microsoft.com/en-us/azure/developer/azure-developer-cli/?ref_product=copilot\\&ref_type=engagement\\&ref_style=button) na raiz do repositório.\n\nDepois de executar o comando e mesclar a solicitação de pull criada, você poderá adicionar a configuração do MCP ao repositório.\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### Exemplo: Cloudflare\n\nO [servidor MCP Cloudflare](https://github.com/cloudflare/mcp-server-cloudflare) cria conexões entre seus serviços do Cloudflare, incluindo documentação de processamento e análise de dados.\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### Exemplo: Azure DevOps\n\nO servidor MCP [Azure DevOps](https://github.com/microsoft/azure-devops-mcp) cria uma conexão perfeita entre Copilot e seus serviços de Azure DevOps, incluindo itens de trabalho, pipelines ou documentação.\n\nPara usar o servidor MCP do Azure DevOps com Copilot cloud agent, você deve atualizar o arquivo copilot-setup-steps.yml do repositório para incluir uma etapa de fluxo de trabalho de logon do Azure.\n\n1. Configure o OIDC em um aplicativo Microsoft Entra, confiando em GitHub. Consulte [Usar a ação de login do Azure com o OpenID Connect](https://learn.microsoft.com/en-us/azure/developer/github/connect-from-azure-openid-connect).\n2. Configurar o acesso à organização e aos projetos do Azure DevOps para a identidade do aplicativo. Confira [Adicionar usuários da organização e gerenciar o acesso](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/add-organization-users).\n3. Adicione um arquivo de fluxo de trabalho `.github/workflows/copilot-setup-steps.yml` Actions em seu repositório se ainda não tiver um.\n4. Adicione uma etapa de login do Azure no fluxo de trabalho `copilot-setup-steps`.\n\n ```yaml copy\n # Esse fluxo de trabalho usa ações que não são certificadas pelo GitHub.\n # São fornecidas por terceiros e regidas por\n # termos de serviço, política de privacidade e suporte separados\n # online.\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 Essa configuração garante que a ação `azure/login` seja executada quando o Copilot cloud agent for executado.\n5. Configure segredos para seus `AZURE_CLIENT_ID` e `AZURE_TENANT_ID` como segredos de Agentes em nível de organização ou de repositório. Para obter mais informações, consulte [Configurar segredos e variáveis para Copilot agente de nuvem](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).\n6. Configure o servidor MCP Azure DevOps adicionando um objeto `ado` à configuração do MCP com as ferramentas que você deseja usar 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### Exemplo: Atlassian\n\nO [servidor MCP atlassiano](https://github.com/atlassian/atlassian-mcp-server) fornece Copilot acesso autenticado aos seus aplicativos Atlassian, incluindo Jira, Compass e Confluence.\n\nPara obter mais informações sobre como autenticar no servidor MCP do Atlassian usando uma chave de API, consulte [Configurar a autenticação por meio do token de API](https://support.atlassian.com/atlassian-rovo-mcp-server/docs/configuring-authentication-via-api-token/) na documentação do 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## Reutilizando a configuração do MCP de Visual Studio Code\n\nSe você já configurou servidores MCP em VS Code, pode usar uma configuração semelhante para as configurações de MCP do seu repositório em GitHub.\n\nDependendo de como VS Code está configurado, você poderá encontrar as configurações do MCP no arquivo do `.vscode/mcp.json` repositório ou no arquivo privado `settings.json` do computador.\n\nPara adaptar a configuração das configurações de MCP do repositório em GitHub, você precisará:\n\n1. Adicione uma `tools` chave para cada servidor MCP, especificando quais ferramentas estarão disponíveis para Copilot.\n2. Se você tiver configurou o `inputs`, alterne para usar `env` diretamente.\n3. Se você tiver configurado um `envFile`, alterne para usar `env` diretamente.\n4. Atualize todas as referências a `inputs` em sua configuração do `args` para se referir a variáveis de ambiente de `env` em vez disso.\n\nPara obter mais informações sobre o MCP, VS Codeconsulte os [VS Code documentos](https://code.visualstudio.com/docs/copilot/chat/mcp-servers).\n\n## Como validar a configuração do MCP\n\nDepois de definir a configuração do MCP, teste-a para verificar se está configurada corretamente.\n\n### Validar com Copilot cloud agent\n\n1. Crie um problema no repositório e atribua-o a Copilot.\n2. Aguarde alguns segundos e Copilot deixe uma reação 👀 sobre o problema.\n3. Aguarde mais alguns segundos e Copilot crie uma solicitação de pull, que será exibida na linha do tempo do problema.\n4. Clique no pull request criado na linha do tempo e aguarde até que um evento \"Copilot começou a trabalhar\" seja exibido.\n5. Clique **em Exibir sessão** para abrir os Copilot cloud agent logs.\n6. Clique no botão de três pontos (**...**) no canto superior direito do visualizador de logs e, em seguida, clique em **Copilot** na barra lateral.\n7. Clique na etapa **Start MCP Servers** para expandir os logs.\n8. Se os servidores MCP tiverem sido iniciados com êxito, você verá suas ferramentas listadas na parte inferior dos logs.\n\nSe os servidores MCP exigirem dependências que não estão instaladas no GitHub Actions executor por padrão, como `uv` e `pipx`ou que precisam de etapas especiais de instalação, talvez seja necessário criar um `copilot-setup-steps.yml` arquivo de fluxo de trabalho actions para instalá-los. Para obter mais informações, consulte [Configurar o ambiente de desenvolvimento](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment).\n\n### Validar com Copilot code review\n\n1. Abra uma solicitação pull no repositório.\n2. Solicite uma revisão de Copilot.\n3. Abra a sessão de revisão vinculada na linha do tempo da solicitação de pull clicando **em Exibir sessão**. Nos logs de sessão, examine a seção \"Configurando o ambiente\" para ver quais servidores e ferramentas do MCP foram iniciados e chamados.\n\n## Personalizando o servidor MCP interno GitHub\n\nO GitHub servidor MCP é habilitado por padrão e conecta-se a GitHub com um token de escopo especial que possui apenas acesso de leitura ao repositório atual.\n\nSe você quiser permitir o Copilot acesso a dados fora do repositório atual, poderá fornecer a ele um personal access token acesso mais amplo.\n\n1. Crie um personal access token com as permissões apropriadas. É recomendável usar um fine-grained personal access token, em que você pode limitar o acesso do token a permissões somente leitura em repositórios específicos. Para obter mais informações sobre personal access tokens, consulte [Gerenciar seus tokens de acesso pessoal](/pt/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).\n\n2. Em GitHub, acesse a página principal do repositório.\n\n3. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n\n4. Na barra lateral, em \"Código, planejamento e automação\", clique em **Copilot** e depois em **servidores MCP**.\n\n5. Adicione sua configuração na seção \"Configuração do MCP\". Por exemplo, você pode adicionar o seguinte:\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 Para obter mais informações sobre conjuntos de ferramentas, consulte o [LEIAME](https://github.com/github/github-mcp-server?tab=readme-ov-file#available-toolsets) na documentação do GitHub Servidor MCP Remoto.\n\n6. Clique em **Salvar configuração do MCP**.\n\n7. Adicione um segredo de agentes chamado `COPILOT_MCP_GITHUB_PERSONAL_ACCESS_TOKEN` com personal access token como o valor. Você pode configurar isso no nível da organização ou do repositório. Para obter mais informações, consulte [Configurar segredos e variáveis para Copilot agente de nuvem](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/configure-secrets-and-variables).\n\nPara obter informações sobre como usar o GitHub servidor MCP em outros ambientes, consulte [Usando o servidor MCP GitHub em seu IDE](/pt/copilot/how-tos/provide-context/use-mcp-in-your-ide/use-the-github-mcp-server).\n\n## Desabilitando ferramentas MCP para revisão de código\n\nNas configurações do repositório, o uso das ferramentas MCP por Copilot code review é habilitado por padrão.\n\nDesative esta configuração se quiser que os servidores MCP configurados estejam disponíveis apenas para Copilot cloud agent e não para Copilot code review.\n\nSe você desativar esta configuração, Copilot code review não chamará ferramentas MCP para revisões de pull request nesse repositório, incluindo as ferramentas dos servidores MCP padrão GitHub e Playwright.\n\n1. Em GitHub, acesse a página principal do repositório.\n2. No nome do repositório, clique em ** Settings**. Caso não consiga ver a guia \"Configurações\", selecione o menu suspenso **** , clique em **Configurações**.\n\n \n3. Na barra lateral, em \"Código, planejamento e automação\", em seguida, clique **Copilot\\*\\*\\*\\*em Revisão de código**.\n4. Clique no botão **Permitir que o Copilot use ferramentas MCP ao revisar solicitações de pull** para desativar a configuração.\n\n## Próximas Etapas \n\n* [Adicionando servidores MCP para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers)\n* [Usando o GitHub Copilot para revisão de código](/pt/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review)\n* [Criando agentes personalizados para Copilot cloud agent](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)\n* [Configurar o ambiente de desenvolvimento](/pt/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)\n* [Estendendo o GitHub Copilot Chat com servidores MCP (Protocolo de Contexto do Modelo)](/pt/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp)"}