Usar servidores MCP

O PROTOCOLO MCP (Model Context Protocol) é um padrão aberto que permite que os modelos de IA interajam com ferramentas e serviços externos por meio de uma interface unificada. No Visual Studio, o suporte ao MCP aprimora o modo de agente do GitHub Copilot, permitindo que você conecte qualquer servidor compatível com MCP ao fluxo de trabalho de codificação agente.

Este artigo orienta você na configuração de servidores MCP e no uso de ferramentas com o modo de agente no Visual Studio.

Pré-requisitos

Visual Studio 2026 Ou Visual Studio 2022 versão 17.14 (com a versão de manutenção mais recente recomendada para os recursos MCP mais atualizados)

Como o MCP e o Visual Studio estendem o agente do GitHub Copilot

O suporte ao MCP no Visual Studio funciona da seguinte maneira:

• Clientes MCP, como o Visual Studio, conectam-se a servidores MCP e solicitam ações em nome do modelo de IA.
• Os servidores MCP fornecem uma ou mais ferramentas que expõem funcionalidades específicas por meio de uma interface bem definida.
• O protocolo define o formato de mensagem para comunicação entre clientes e servidores, incluindo descoberta de ferramentas, invocação e tratamento de resposta.

Por exemplo, um servidor MCP para um sistema de arquivos pode fornecer ferramentas para ler, gravar ou pesquisar arquivos e diretórios. O servidor oficial do GitHub MCP oferece ferramentas para listar repositórios, criar solicitações de pull ou gerenciar problemas. Os servidores MCP podem ser executados localmente no computador ou hospedados remotamente. O Visual Studio dá suporte a ambas as configurações.

Ao padronizar essa interação, o MCP elimina a necessidade de integrações personalizadas entre cada modelo de IA e cada ferramenta. Em seguida, você pode estender os recursos do assistente de IA simplesmente adicionando novos servidores MCP ao seu workspace. Saiba mais sobre a especificação do MCP.

Funcionalidades de MCP com suporte

O Visual Studio dá suporte aos seguintes recursos do MCP:

• As opções para o transporte do servidor MCP são entrada/saída padrão local (stdio), eventos enviados pelo servidor (sse) e HTTP transmitivel (http).
• Das características (ferramentas, prompts, recursos, amostragem), o Visual Studio agora suporta:
  • Ferramentas: executar ações e operações por meio do modo de agente copilot
  • Prompts: modelos de prompt reutilizáveis que você pode invocar com parâmetros
  • Recursos: acessar dados externos e contexto por meio de recursos baseados em URI
  • Amostragem: interações aprimoradas do modelo de IA com suas ferramentas e serviços
• O Visual Studio fornece aos servidores as pastas de solução atuais usando roots (especificação).
• Para autorização do MCP, o Visual Studio dá suporte à autenticação para servidores remotos com qualquer provedor OAuth.

Localizando servidores MCP

O repositório oficial do servidor MCP é um ótimo ponto de partida para servidores de referência, oficiais e de comunidade que mostram a versatilidade do MCP. Você pode explorar servidores para várias funcionalidades, como operações do sistema de arquivos, interações de banco de dados e serviços Web.

O MCP é um padrão relativamente novo e o ecossistema está evoluindo rapidamente. À medida que mais desenvolvedores adotam o MCP, você pode esperar ver um número crescente de servidores e ferramentas disponíveis para integração com seus projetos.

Exemplo de servidores MCP

Experimente alguns outros servidores MCP populares no Visual Studio com um clique:

• – Descubra e instale prompts personalizados e instruções para o GitHub Copilot.
• – Converta vários formatos de arquivo (PDF, Word, Excel, imagens, áudio) em Markdown.
• – Consultar e analisar dados em bancos de dados DuckDB localmente e na nuvem.
• – operações e gerenciamento de banco de dados. Execute consultas, gerencie coleções, pipelines de agregação e operações com documentos.
• – Modelos de acesso, conjuntos de dados e espaços no Hub de Detecção Facial.

Opções para adicionar um servidor MCP

Você tem várias opções para adicionar um servidor MCP no Visual Studio.

Instalar por meio da Web

Começando com a versão de manutenção mais recente da versão 17.14, o Visual Studio dá suporte à instalação direta de servidores MCP. Selecione o botão Instalar em um servidor MCP para adicioná-lo automaticamente à instância do Visual Studio.

Adicionar um servidor MCP por meio do chat

Para adicionar um servidor MCP na visualização do chat:

1. Selecione o botão de mais verde (+) no seletor de ferramentas dentro da janela de chat.

   

2. Especifique o nome do servidor e os detalhes da conexão, como a URL para servidores HTTP ou o comando e os argumentos para servidores stdio.

   

Adicionar um servidor MCP por meio do repositório de servidores do GitHub MCP

Você pode instalar um servidor MCP diretamente do registro do servidor MCP do GitHub por meio de extensões no Visual Studio.

1. No menu do Visual Studio, selecione Extensões > MCP Regsitries... para abrir o Gerenciador de Servidores MCP.

   

2. Selecione o servidor desejado e, em seguida, selecione a instalação para sua instância do Visual Studio.

   

Adicionar um servidor MCP ao .mcp.json arquivo

As etapas a seguir explicam um exemplo de configuração com o servidor MCP do GitHub:

1. Criar um novo arquivo: <SOLUTIONDIR>\.mcp.json ou %USERPROFILE%\.mcp.json. Use o Visual Studio para editar esse arquivo para que seu esquema JSON seja aplicado automaticamente.

2. Cole o seguinte conteúdo no .mcp.json arquivo:

   {
     "servers": {
       "github": {
         "url": "https://api.githubcopilot.com/mcp/"
       }
     }
   }
   

3. Salve o arquivo.

4. No arquivo, selecione Autenticação Obrigatória no CodeLens que aparece, para autenticar-se no servidor por meio de uma conta do GitHub. Selecione Autenticar na caixa de diálogo pop-up para autenticar com sua conta do GitHub.

   

   Se você não vir o CodeLens, verifique se ele está habilitado em Ferramentas>Opções>Editor de Texto>CodeLens.

5. Na parte inferior do painel de chat, selecione Agent na lista suspensa de modo.

   

6. Selecione as ferramentas que você deseja usar, por exemplo, listar problemas.

   

   Experimente um prompt de exemplo: listar problemas atribuídos a mim no GitHub.

7. Copilot pede permissão para usar uma ferramenta que o servidor MCP disponibilizou para ele. Selecione Permitir com o escopo com o qual você deseja continuar.

   

Criar um arquivo para gerenciar a configuração de servidores MCP

Se você ainda não tiver um mcp.json arquivo, crie um em qualquer um dos locais com suporte com base em seus requisitos de repositório, usuário ou editor.

Para adicionar um servidor MCP, localize a configuração JSON do servidor online. Por exemplo, localize-o no repositório GitHub para servidores MCP. Em seguida, cole-o no mcp.json arquivo.

Locais de arquivo para descoberta automática da configuração do MCP

O Visual Studio também verifica se há configurações de MCP configuradas por outros ambientes de desenvolvimento. Ele lê as configurações do servidor MCP dos seguintes diretórios, na seguinte ordem:

1. %USERPROFILE%\.mcp.json
   Serve como uma configuração de servidor MCP global para um usuário específico. Adicionar um servidor MCP aqui faz com que ele seja carregado para todas as soluções do Visual Studio.
2. <SOLUTIONDIR>\.vs\mcp.json
   Específico do Visual Studio e carrega os servidores MCP especificados apenas para um usuário específico, para a solução especificada.
3. <SOLUTIONDIR>\.mcp.json
   Funcionará bem se você estiver procurando uma configuração de MCP que possa acompanhar no controle do código-fonte para um repositório.
4. <SOLUTIONDIR>\.vscode\mcp.json
   Com escopo para o repositório/solução e normalmente não controlado pela origem.
5. <SOLUTIONDIR>\.cursor\mcp.json
   Com escopo para o repositório/solução e normalmente não controlado pela origem.

Alguns desses locais exigem .mcp.json, enquanto outros exigem mcp.json.

Formato de configuração do MCP

Você pode definir servidores remotos (URL e credenciais) e locais (invocação de linha de comando).

É comum invocar ferramentas por meio de gerenciadores de pacotes; por exemplo, npx -y @azure/mcp@latest ou docker run ... mcp/github. O Visual Studio respeita qualquer comando especificado, para que você possa fixar versões ou passar sinalizadores conforme necessário.

O formato deve seguir a especificação do MCP. Por exemplo, ele deve incluir uma matriz de objetos de servidor, cada um com name, command ou url, e transport.

Editando a configuração do MCP

Se você tiver um arquivo existente mcp.json e verificar o arquivo em seu sistema de controle de versão, adicione o local do arquivo aos Itens de Solução no Gerenciador de Soluções.

Quando você salva o arquivo com sintaxe válida, o agente do GitHub Copilot reinicia e recarrega os servidores configurados.

Ciclo de vida da ferramenta

Assim que o Visual Studio descobrir ou adicionar um servidor:

• Ele inicializa o servidor executando um handshake e consultando a lista de ferramentas.
• Ele se inscreve no evento notifications/tools/list_changedMCP.
• Quando esse evento é acionado, o Visual Studio redefine quaisquer aceitações ou permissões anteriores em ferramentas (para evitar ataques de puxada de tapete), atualiza novamente a lista de ferramentas e atualiza ativamente a contagem e a interface do usuário.
• Quando o Visual Studio habilita o servidor com êxito, o agente disponibiliza as ferramentas. As ferramentas são desabilitadas por padrão e você deve habilitá-las manualmente.
• Se você remover um servidor, o Visual Studio interromperá imediatamente seu processo e retirará todas as ferramentas da interface do usuário.
• Se você editar uma definição de servidor, o Visual Studio terminará e a reiniciará e, em seguida, consultará novamente.

Gerenciamento de aprovações de ferramentas

Quando você invoca uma ferramenta, o Copilot solicita confirmação para executar a ferramenta. O motivo é que as ferramentas podem ser executadas localmente em seu computador e executar ações que modifiquem arquivos ou dados.

Após uma invocação de ferramenta, no painel de chat, use o menu Permitir para opções suspensas. Você pode confirmar automaticamente a ferramenta específica para a sessão atual, a solução atual ou todas as invocações futuras.

Gerenciar autorização

O Visual Studio agora dá suporte à autenticação para servidores remotos usando qualquer provedor OAuth, de acordo com a especificação de autorização do MCP. Esse suporte é além da integração com o conjunto de chaves do Visual Studio.

Para gerenciar a autenticação de um servidor MCP:

1. .mcp.json No arquivo, selecione Gerenciar Autenticação para esse servidor no CodeLens.

2. Forneça credenciais para o provedor OAuth necessário para esse servidor na caixa de diálogo pop-up do navegador.

Prompts do MCP e modelos de prompt

Os servidores MCP podem fornecer modelos de prompt reutilizáveis que ajudam você a interagir com mais eficiência com modelos de linguagem. Esses prompts são adaptados a tarefas específicas e podem incluir argumentos personalizáveis.

Usar comandos do MCP

Para fazer referência a prompts de um servidor MCP:

1. Selecione + Adicionar Referência no chat.
2. Selecione prompts>prompts do MCP.
3. Escolha um prompt e selecione Inserir Prompt.

Alguns prompts incluem argumentos que você pode personalizar antes de inseri-los no chat. Esses prompts são chamados de modelos de prompt.

Exemplo: O servidor MCP do GitHub fornece prompts para analisar solicitações de pull, gerar mensagens de confirmação e revisar alterações de código.

Instalar o GitHub MCP no Visual Studio

Recursos do MCP e modelos de recurso

Os recursos do MCP fornecem contexto para modelos de linguagem, como arquivos, esquemas de banco de dados ou dados específicos do aplicativo. Cada recurso tem um URI exclusivo que você pode referenciar no chat.

Usar recursos do MCP

Referencie os recursos do MCP no chat do Copilot usando uma hashtag (#) seguida pelo URI do recurso.

Para recursos com argumentos (modelos de recurso):

1. Selecione + Adicionar Referência no chat.
2. Selecione recursos do MCP.
3. Escolha seu recurso, preencha todos os argumentos necessários e selecione Adicionar Recurso.

Exemplo: O servidor MCP do Azure DevOps expõe recursos de itens de trabalho, informações de sprint e dados de capacidade da equipe para tarefas de planejamento de projetos.

Exemplo: O servidor FIGMA MCP fornece acesso a recursos de componente de design, guias de estilo e especificações de design.

Amostragem de MCP

Ao usar amostragem, os servidores MCP podem realizar chamadas LLM para você, possibilitando operações de múltiplas etapas mais complexas. O Visual Studio dá suporte automaticamente à amostragem se o servidor MCP o fornecer.

Quando o Copilot precisar realizar uma chamada de amostragem, você verá uma caixa de diálogo de confirmação. Examine os detalhes e aprove antes que a ação prossiga, garantindo que você mantenha o controle sobre operações automatizadas.

Exemplo: O servidor MCP do Dramaturgo usa a amostragem para gerar cenários de teste com base na estrutura do DOM do aplicativo e nos fluxos de usuário.

Perguntas frequentes

Como administrador, como controlar o uso de servidores MCP no modo de agente para usuários do Visual Studio?

As configurações de política do GitHub no painel do GitHub Copilot para administradores governam o modo de agente e o uso de MCP no Visual Studio. Se o administrador desativar essa configuração, os usuários nessa assinatura não poderão usar o modo de agente ou se conectar a servidores MCP no Visual Studio.

Para obter mais informações, consulte Gerenciando políticas e recursos para o GitHub Copilot em sua empresa.

Conteúdo relacionado

• Modo assistente do GitHub Copilot
• Experiência de bate-papo do GitHub Copilot para Visual Studio
• GitHub Copilot Gratuito