Usar servidores MCP

O Model Context Protocol (MCP) é um padrão aberto que permite que modelos de IA interajam com ferramentas e serviços externos por meio de uma interface unificada. No Visual Studio, o suporte a MCP aprimora o modo de agente do GitHub Copilot, permitindo que você conecte qualquer servidor compatível com MCP ao seu 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 atualização mais recente recomendada para as funcionalidades MCP mais atualizadas)

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

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

• Clientes MCP, como o Visual Studio, se conectam 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 através de uma interface bem definida.
• O protocolo define o formato de mensagem para comunicação entre clientes e servidores, incluindo descoberta de ferramentas, chamada e tratamento de respostas.

Por exemplo, um servidor MCP para um sistema de arquivos pode fornecer ferramentas para ler, gravar ou pesquisar arquivos e diretórios. O servidor MCP oficial do GitHub oferece ferramentas para listar repositórios, criar solicitações pull ou gerenciar problemas. Os servidores MCP podem ser executados localmente em sua máquina ou hospedados remotamente. Visual Studio suporta 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 seu assistente de IA simplesmente adicionando novos servidores MCP ao seu espaço de trabalho. Saiba mais sobre a especificação MCP.

Capacidades MCP suportadas

Visual Studio suporta os seguintes recursos 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 streamable (http).
• Das funcionalidades (ferramentas, prompts, recursos, amostragem), o Visual Studio agora oferece suporte às seguintes:
  • Ferramentas: Execute ações e operações através do modo de agente Copilot
  • Prompts: modelos de prompt reutilizáveis que você pode invocar com parâmetros
  • Recursos: acesse 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
• Visual Studio fornece servidores com as pastas de solução atuais usando roots (especificação).
• Para autorização MCP, o Visual Studio oferece 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 contribuídos pela comunidade que mostram a versatilidade do MCP. Você pode explorar servidores para várias funcionalidades, como operações de 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.
• vários formatos de arquivo (PDF, Word, Excel, imagens, áudio) para Markdown.
• – Consulte e analise 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 de documentos.
• – Acesse modelos, conjuntos de dados e espaços no Hugging Face Hub.

Opções para adicionar um servidor MCP

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

Instalar a partir da Web

A partir da última versão de manutenção da versão 17.14, o Visual Studio suporta a instalação direta de servidores MCP. Selecione o botão Instalar num servidor MCP para adicionar automaticamente à sua instância do Visual Studio.

Adicione um servidor MCP a partir do chat

Para adicionar um servidor MCP a partir da vista de chat:

1. Selecione o botão verde mais (+) no seletor de ferramentas na 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 argumentos para servidores stdio.

   

Adicionar um servidor MCP a partir do registo do servidor MCP do GitHub

Pode instalar um servidor MCP diretamente a partir do registo de servidores MCP do GitHub através das Extensões no Visual Studio.

1. No menu Visual Studio, selecione Extensões > MCP Registos... para abrir o MCP Server Manager.

   

2. Seleciona o servidor desejado e depois seleciona instalar para a tua instância Visual Studio.

   

Adicionar um servidor MCP ao .mcp.json ficheiro

Os passos seguintes guiam-no por um exemplo de configuração com o servidor MCP do GitHub:

1. Crie 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 ficheiro, selecione Autenticação Necessária a partir do CodeLens que parece autenticar no servidor através de uma conta GitHub. Selecione Autenticar na janela pop-up para autenticar com a sua conta GitHub.

   

   Se não vires o CodeLens, certifica-te de que está ativado nas Ferramentas>>Opções do Editor>de Texto CodeLens.

5. No fundo do painel de chat, selecione Agente no menu suspenso do modo.

   

6. Selecione as ferramentas que quer usar, por exemplo, Listar problemas.

   

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

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

   

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

Se ainda não tiver um arquivo mcp.json, crie um em qualquer um dos locais suportados, com base nos requisitos do repositório, utilizador ou editor.

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

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

O Visual Studio também verifica se há configurações MCP configuradas por outros ambientes de desenvolvimento. Lê configurações de servidores MCP dos seguintes diretórios, pela 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 carregue para todas as soluções do Visual Studio.
2. <SOLUTIONDIR>\.vs\mcp.json
   Específico para Visual Studio e carrega os servidores MCP especificados somente para um usuário específico, para a solução especificada.
3. <SOLUTIONDIR>\.mcp.json
   Funciona bem se você estiver procurando por uma configuração MCP que possa ser rastreada 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 pelo código-fonte.
5. <SOLUTIONDIR>\.cursor\mcp.json
   Com escopo para o repositório/solução e normalmente não controlado pelo código-fonte.

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

Formato de configuração MCP

Você pode definir servidores remotos (URL e credenciais) e locais (chamada 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 que você especificar, para que você possa fixar versões ou passar sinalizadores conforme necessário.

O formato deve seguir a especificação 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 tiver um ficheiro existente mcp.json e o registar no seu sistema de controlo de versões, adicione a localização do ficheiro aos Itens de Solução no Explorador de Soluções.

Quando guarda o ficheiro com sintaxe válida, o agente GitHub Copilot reinicia e recarrega os servidores configurados.

Ciclo de vida da ferramenta

Assim que o Visual Studio identificar ou adicionar um servidor:

• Inicializa o servidor através de um handshake e consulta à lista de ferramentas.
• Subscreve o evento MCP notifications/tools/list_changed.
• Quando esse evento dispara, o Visual Studio reinicia quaisquer aceitações ou permissões previamente concedidas às ferramentas (para evitar ataques de retirada abrupta), recupera a lista de ferramentas e atualiza a contagem e a interface do utilizador ao vivo.
• Quando o Visual Studio ativa com sucesso o servidor, o agente disponibiliza as ferramentas. As ferramentas estão desativadas por defeito e tens de as ativar manualmente.
• Se removeres um servidor, o Visual Studio para imediatamente o processo e retira todas as ferramentas da interface.
• Se você editar uma definição de servidor, o Visual Studio a encerrará e reiniciará e, em seguida, consultará novamente.

Gestão de aprovações de ferramentas

Quando invocas uma ferramenta, o Copilot pede confirmação para a executar. O motivo é que as ferramentas podem ser executadas localmente em sua máquina e executar ações que modificam arquivos ou dados.

Após a invocação da ferramenta, no painel de chat, use o menu suspenso Permitir. 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 suporta agora autenticação para servidores remotos utilizando qualquer fornecedor OAuth, de acordo com a especificação de autorização MCP. Esse suporte é adicional à integração com as 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 e modelos de prompt MCP

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

Usar comandos MCP

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

1. Selecione + Adicionar referência no chat.
2. Selecione Prompts>.
3. Escolha um prompt e selecione Inserir prompt.

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

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

Recursos MCP e modelos de recursos

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

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

Para recursos com argumentos (modelos de recursos):

1. Selecione + Adicionar referência no chat.
2. Selecione Recursos 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 projeto.

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

Instalar o Figma MCP no Visual Studio

Amostragem de Monte Carlo (MCP)

Ao utilizar amostragem, os servidores MCP podem fazer chamadas LLM por si, permitindo operações mais complexas e em vários passos. O Visual Studio suporta automaticamente a amostragem se for fornecida pelo servidor MCP.

Quando o Copilot precisa de fazer uma chamada de amostragem, é apresentado um diálogo de confirmação. Revise os detalhes e aprove antes que a ação prossiga, garantindo que você mantenha o controle sobre as operações automatizadas.

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

Instalar o Playwright MCP no Visual Studio

Perguntas frequentes

Como administrador, como faço para 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 controlam o modo de agente e o uso do MCP no Visual Studio. Se o administrador desativar essa configuração, os usuários dessa 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 de agente do Copilot do GitHub
• Experiência de bate-papo do copiloto do GitHub para Visual Studio
• GitHub Copilot Grátis