Protocolo MCP (Model Context Protocol)

Conecte-se Copilot a ferramentas externas e dados por meio de servidores MCP (Model Context Protocol).

Neste artigo

Visão geral do MCP (Protocolo de Contexto de Modelo)

O MCP (Protocolo de Contexto de Modelo) é um padrão aberto que define como os aplicativos compartilham contexto com os LLMs (modelos de linguagem grande). O MCP fornece um modo padronizado de conectar modelos de IA a diferentes fontes de dados e ferramentas, permitindo que eles trabalhem juntos com mais eficiência.

Você pode usar o MCP para estender os recursos GitHub Copilot integrando-o a uma ampla gama de ferramentas e serviços existentes. MCP funciona em todos os principais ambientesCopilot — seja trabalhando em um IDE, usando GitHub Copilot CLI, trabalhando no GitHub Copilot app ou delegando tarefas a um agente no GitHub.com. Você também pode usar o MCP para criar novas ferramentas e serviços que funcionem com Copilot, permitindo que você personalize e aprimore sua experiência.

Por exemplo, você pode conectar um rastreador de problemas para que Copilot possa procurar um bug enquanto trabalha em uma correção, sem solicitar que você copie a issue para o chat.

Para obter mais informações sobre o MCP, confira a documentação oficial do MCP. Para obter uma lista selecionada de servidores MCP de parceiros e da comunidade, consulte o GitHub Registro MCP.

Empresas e organizações podem optar por habilitar ou desabilitar o uso do MCP para membros de sua organização ou empresa com os servidores MCP na Copilot política. A política está desabilitada por padrão. Confira Gerenciando políticas e recursos para GitHub Copilot em sua empresa e Gerenciando políticas e recursos para GitHub Copilot em sua organização. A política MCP só se aplica a usuários que têm uma Copilot Business ou Copilot Enterprise assinatura de uma organização ou empresa que configura a política. Copilot Free, Copilot Pro, Copilot Pro+ ou Copilot Maxnão têm seu acesso ao MCP regulado por esta política.

O MCP complementa o contexto que você fornece por meio de prompts, arquivos e instruções. Ele adiciona conexões a ferramentas e dados, em vez de substituir diretrizes sobre como o agente deve funcionar. Para obter diretrizes sobre como solicitar e gerenciar o contexto, consulte Prompts e contexto para o GitHub Copilot.

Conecte um serviço uma vez por meio de servidores MCP verificados pelo GitHub (conectores) e use a conexão nas interfaces Copilot compatíveis sem repetir a configuração nem entrar separadamente em cada uma delas. Essas conexões também funcionam em sessões Copilot executadas em uma área restrita na nuvem, mas não em sessões executadas em GitHub Actions. Consulte Conectores do Copilot.

Onde você pode usar o MCP

A configuração do MCP depende de onde você usa Copilot:

  • O servidor GitHub Copilot app: Você pode usar servidores MCP configurados para seu repositório ou em sua configuração local Copilot. Você também pode descobrir e instalar servidores MCP adicionais na guia Customizar.
  • Copilot CLI: GitHub Copilot CLI dá suporte a servidores MCP locais e remotos. O GitHub servidor MCP é interno e está disponível sem configuração adicional.
  • Copilot cloud agent (incluindo automations) e Copilot code review: GitHub.com dá suporte a servidores MCP configurados no nível do repositório. A configuração se aplica a Copilot cloud agent, automations e Copilot code review. O GitHub servidor MCP e o servidor MCP do Dramaturgo são configurados por padrão.
  • IDEs: os servidores MCP são compatíveis com Visual Studio Code, Visual Studio, IDEs JetBrains, Xcode e Eclipse. As opções de conexão e autenticação dependem do IDE. Consulte Estendendo o chat do GitHub Copilot com servidores MCP (Model Context Protocol).

O Chat on GitHub.com tem ferramentas pré-configuradas, como ferramentas para criar branches e pesquisar código. Isso é separado das configurações do MCP do repositório para Copilot cloud agent e Copilot code review. Consulte GitHub Copilot no GitHub.com e no GitHub Mobile.

MCP para Copilot cloud agent

As seções a seguir descrevem os padrões e a configuração do MCP para Copilot cloud agent, incluindo automations. As configurações de MCP no nível do repositório também se aplicam a Copilot code review, conforme observado abaixo. Para outras superfícies, use os guias de configuração em Próximas etapas.

Servidores MCP padrão

Copilot cloud agent começa com dois servidores MCP configurados:

  • GitHub fornece acesso aos dados do repositório, como issues e pull requests. Por padrão, ele usa um token com escopo especial com acesso somente leitura ao repositório atual. O acesso fora desse repositório requer a configuração explícita de credenciais com acesso mais amplo.
  • Playwright fornece ferramentas para ler, interagir e tirar capturas de tela de páginas da Web. Por padrão, ele só pode acessar recursos da Web no próprio ambiente do agente por meio localhost ou 127.0.0.1.

Esses valores padrão são específicos para o ambiente de nuvem. Por exemplo, Copilot CLI inclui o GitHub servidor MCP sem configuração adicional, mas você configura outros servidores separadamente.

Servidores MCP pessoais

Servidores MCP pessoais se conectam Copilot a ferramentas e dados para seu próprio fluxo de trabalho. Configure um servidor uma vez para disponibilizá-lo em cada sessão na nuvem que você iniciar. Esses servidores estão disponíveis apenas para você e não afetam outros usuários que trabalham no mesmo repositório.

Antes de configurar um servidor MCP pessoal, verifique se o serviço necessário é coberto por GitHubservidores MCP verificados (conectores). GitHubOs servidores MCP verificados estão disponíveis em sessões locais e na nuvem, e GitHub manipula a configuração e a autenticação do servidor MCP para você. Por outro lado, os servidores MCP pessoais só dão suporte à autenticação baseada em chave e só estão disponíveis em sandboxes na nuvem. Consulte Conectores do Copilot.

Use servidores MCP pessoais para conexões desejadas entre repositórios ou que exijam suas próprias credenciais. Para fornecer uma configuração compartilhada para colaboradores que trabalham em um repositório específico, use a configuração no nível do repositório .

  1. Navegue até sua Copilot home page em github.com/copilot.
  2. No menu à esquerda, clique no menu Personalizar .
  3. Verifique se o serviço necessário é coberto por um servidor MCP verificado por GitHub.
  4. Se um GitHubservidor MCP verificado não cobrir suas necessidades e você quiser configurar seu próprio servidor MCP, selecione o menu suspenso Adicionar e clique em MCP server.
  5. Insira o nome do servidor, o tipo de transporte, a URL ou o comando de inicialização e outra configuração necessária.
  6. Se a autenticação for necessária, crie segredos em segredos pessoais do servidor MCP com nomes prefixados com COPILOT_MCP_, como COPILOT_MCP_API_KEY, e referencie-os na configuração do servidor.
  7. Clique em Adicionar servidor.

Por padrão, os segredos pessoais do servidor MCP estão disponíveis em sessões com escopo para sua conta pessoal. Você também pode permitir o uso deles em organizações selecionadas para usar seus servidores autenticados lá.

Limitations

  • Servidores MCP pessoais estão disponíveis em todas as sessões de nuvem. No momento, não é possível escolher quais servidores habilitar para uma sessão individual.
  • Os servidores HTTP e SSE MCP personalizados não dão suporte a parâmetros de consulta em suas URLs. Em vez disso, passe esses valores como cabeçalhos de solicitação.
  • Se um servidor não estiver disponível, verifique sua configuração e confirme se existem segredos necessários e estão disponíveis para a conta ou organização em que a sessão é executada.
  • Você pode usar até 50 servidores MCP no total em configurações pessoais e de nível de repositório.

Configuração no nível do repositório

Os servidores MCP no nível do repositório conectam Copilot a ferramentas e dados para o trabalho em um repositório específico. Os administradores do repositório configuram esses servidores nas configurações do repositório no GitHub.comGitHub, e a configuração está disponível para qualquer pessoa com acesso de gravação ao repositório. Essas configurações se aplicam a ambos Copilot in the cloud (incluindo automations) e Copilot code review. Você pode desabilitar o uso da ferramenta MCP para revisão de código separadamente.

Use a configuração no nível do repositório quando os colaboradores precisarem das mesmas ferramentas, como um rastreador de problemas compartilhado ou um serviço de documentação. Para servidores que exigem autenticação, use uma conta de serviço para Copilot em vez de credenciais pessoais. Os servidores no nível do repositório não podem referenciar segredos pessoais do servidor MCP.

Você pode usar servidores pessoais e de nível de repositório juntos. Se ambas as configurações definirem um servidor com o mesmo nome, a configuração no nível do repositório terá precedência.

Essa configuração de repositório é distinta dos arquivos de configuração mcp do projeto usados por Copilot CLI. Use o guia de instalação do seu Surface em vez de presumir que o mesmo local de configuração se aplique em todos os lugares.

Automations pode usar ferramentas desses servidores MCP, mas somente as ferramentas que você selecionar para cada automation. Consulte Automações do Copilot.

Aviso

Quando você delega o trabalho a Copilot marcando @mentioning em ele ou atribui a ele um problema ou solicitação de pull, Copilot usa ferramentas MCP configuradas de forma autônoma e não solicita aprovação antes de chamá-las. Para esses fluxos de trabalho, examine cada servidor e permita apenas as ferramentas e o acesso necessários para suas tarefas.

Ao configurar servidores MCP para uso por Copilot cloud agent e Copilot code review, tenha em mente:

  • 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.
  • Para servidores MCP configurados em configurações de repositório ou perfis de agente personalizados, Copilot cloud agent e Copilot code review atualmente não dão suporte a servidores remotos que usam o OAuth para autenticação e autorização.

Copilot code review adicionalmente requer ferramentas para declarar annotations.readOnlyHint: true. As ferramentas com essa anotação ausente ou definida como false estão excluídas.

Para procedimentos de configuração, autenticação e validação, consulte Configurar servidores MCP para seu repositório.

Servidores MCP para agentes personalizados

Para Copilot cloud agent, um perfil de agente pode definir servidores MCP para esse agente personalizado, em vez de disponibilizá-los para todos os agentes que trabalham no repositório. A propriedade mcp-servers de perfil não é usada por agentes personalizados executados diretamente em IDEs.

Para Copilot cloud agent, as configurações de servidor padrão são processadas primeiro, depois as configurações de agente personalizado e, em seguida, as configurações do repositório. Configurações posteriores podem substituir as configurações anteriores. Este comando não descreve a precedência de arquivo de projeto em Copilot CLI.

Para o formato de perfil, as propriedades com suporte e as regras de processamento, consulte Configuração de agentes personalizados.

Práticas Recomendadas

  • Examine os servidores de terceiros antes de habilitá-los. Verifique as ferramentas deles, os requisitos de autenticação e o acesso a dados em relação aos requisitos da sua organização.
  • Habilite apenas as ferramentas de que uma tarefa precisa. Nas configurações do repositório, use o campo tools para adicionar ferramentas específicas à lista de permissões, de preferência ferramentas somente leitura, em vez de habilitar todas as ferramentas. Em automations, escolha as ferramentas específicas de que você precisa.
  • Mantenha as credenciais restritas aos recursos necessários. Não amplie o escopo de acesso do token padrão para Copilot cloud agent a menos que a tarefa precise disso.
  • Valide a configuração antes de confiar nela. Confirme quais servidores e ferramentas estão disponíveis na sessão do agente. Para obter instruções de configuração para seu ambiente, consulte As próximas etapas.

Sobre o GitHub servidor MCP

O GitHub servidor MCP é um servidor MCP (Model Context Protocol) fornecido e mantido por GitHub.

GitHub O servidor MCP pode ser usado para:

  • Automatizar e simplificar tarefas relacionadas ao código.
  • Conecte ferramentas de terceiros (como Cursor, Windsurf ou integrações futuras) para aproveitar o contexto e as capacidades de IA do GitHub.
  • Habilitar fluxos de trabalho baseados em nuvem que funcionam em qualquer dispositivo, sem configuração local.
  • Invoque ferramentas GitHub, como Copilot cloud agent (requer assinatura GitHub Copilot) e code scanning (requer assinatura GitHub Advanced Security), para ajudar na geração de código e na análise de segurança.

Para saber como usar o GitHub servidor MCP, consulte Usando o servidor MCP GitHub em seu IDE.

Para descobrir se o editor dá suporte ao GitHub servidor MCP e quais métodos de conexão e autenticação estão disponíveis, consulte Suporte por aplicativo host no github/github-mcp-server repositório.

Acesso remoto

Você pode acessar o GitHub servidor MCP remotamente através do Copilot Chat em Visual Studio Code sem nenhuma configuração local. O servidor remoto tem acesso a conjuntos de ferramentas adicionais disponíveis apenas no servidor MCP remoto GitHub . Para obter uma lista dessas ferramentas, consulte Conjuntos de ferramentas adicionais no github/github-mcp-server repositório.

O GitHub servidor MCP também pode ser executado localmente em qualquer editor compatível com MCP, se necessário.

Personalização do conjunto de ferramentas

Importante

Sempre examine o GitHub repositório do servidor MCP no github/github-mcp-server para obter os conjuntos de ferramentas mais recentes e as diretrizes de configuração autoritativa.

O GitHub servidor MCP dá suporte à habilitação ou desabilitação de grupos específicos de funcionalidades por meio de conjuntos de ferramentas. Os conjuntos de ferramentas permitem controlar quais GitHub recursos de API estão disponíveis para suas ferramentas de IA.

Habilitar apenas os conjuntos de ferramentas necessários melhora o desempenho e a segurança do assistente de IA. Menos ferramentas significa melhor precisão de seleção de ferramentas e menos erros. Desabilitar conjuntos de ferramentas não utilizados também libera tokens na janela de contexto da IA.

Os conjuntos de ferramentas não incluem apenas ferramentas, mas também os recursos e prompts relevantes do MCP quando aplicável.

Para saber como configurar conjuntos de ferramentas para o GitHub servidor MCP, consulte Configurando conjuntos de ferramentas para o Servidor MCP do GitHub.

Segurança

Para todos os repositórios públicos e repositórios privados cobertos por GitHub Advanced Security, interações com o GitHub servidor MCP são protegidas por segurança via push, o que bloqueia segredos de segurança em respostas geradas por IA e impede que eles sejam incluídos em ações executadas em seu nome. Você também pode verificar seu código de forma proativa em busca de segredos revelados a partir do seu agente de codificação de IA. Para obter mais informações, consulte Verificação de segredos com o servidor MCP GitHub.

Sobre o GitHub Registro MCP

O GitHub Registro MCP é uma lista selecionada de servidores MCP de parceiros e da comunidade. Você pode usar o registro para descobrir novos servidores MCP e encontrar aqueles que atendam às suas necessidades específicas.

Observação

O registro MCP GitHub está atualmente em prévia pública e sujeito a alterações.

Localizador de agente

O localizador de agente é um serviço de descoberta que ajuda a GitHub Copilot encontrar os recursos certos, como servidores MCP, ferramentas, agentes e habilidades, para uma tarefa em tempo de execução, em vez de exigir que todos os recursos sejam configurados com antecedência. Como um registro MCP, ele pesquisa um catálogo de recursos e retorna correspondências classificadas que GitHub Copilot podem ser usadas sob demanda. O localizador de agentes implementa a especificação aberta ARD (Descoberta de Recursos Agênticos).

Para a configuração de Copilot CLI, consulte Usando o localizador do agente. O GitHub Copilot app fornece uma af habilidade integrada. Consulte Habilidades integradas para o aplicativo GitHub Copilot. Para navegar pelo catálogo, consulte GitHub Agent Finder.

Próximas Etapas