Usa servidores MCP no Visual Studio

Os servidores MCP utilizam o Open Model Context Protocol (MCP) para permitir que o GitHub Copilot utilize ferramentas e serviços fora do IDE. No Visual Studio, pode adicionar servidores MCP para estender as capacidades dos agentes em tarefas como acesso a ficheiros, gestão de repositórios e criação de pull requests.

O suporte ao MCP melhora o modo agente do Copilot do GitHub ao permitir que ligue qualquer servidor compatível com MCP ao seu fluxo de trabalho de codificação agente. 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, com o servidor MCP do GitHub ativado, podes pedir ao Copilot para criar e gerir PRs ou informar-te se há PRs que precisam da tua revisão. Com o servidor Azure DevOps MCP ativado, podes fazer com que o Copilot crie e gere itens de trabalho.

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)

Encontrar 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.

Adicionar um servidor MCP

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

Adicionar um servidor MCP diretamente da web

A partir da última versão de manutenção da versão 17.14, pode adicionar um servidor MCP instalando-o diretamente da web. Selecione o botão Install num servidor MCP para instalar automaticamente e adicioná-lo à sua instância Visual Studio.

Exemplos de servidores MCP

Experimenta alguns 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.

Adicione um servidor MCP a partir do chat

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

1. No painel de chat, muda para o modo Agente a partir do seletor de modos no fundo do painel.

2. Selecione Ferramentas para abrir o seletor de ferramentas.

3. No seletor de ferramentas, selecione o botão mais (+).

   

5. No diálogo Adicionar servidor MCP , introduza o nome do servidor e os detalhes da ligação, como o URL dos servidores HTTP ou o comando e argumentos dos 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 de Extensões no Visual Studio.

1. No menu Visual Studio, selecione Extensões>MCP Registos... para abrir o MCP Gestor de Servidor.

   

2. Seleciona o servidor que queres e depois seleciona Install 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.

   

Gerir a configuração dos servidores MCP

Visual Studio suporta o uso de ficheiros mcp.json para armazenar informação de configuração para servidores MCP. mcp.json ficheiros armazenam o nome de cada servidor, o tipo de transporte (por exemplo, stdio ou SSE), o comando para iniciar, quaisquer argumentos e variáveis de ambiente opcionais necessárias para se ligar a esse servidor.

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 através de gestores de pacotes. Por exemplo, utilize 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.

Editar 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.

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
• Controles de administrador para o GitHub Copilot
• GitHub Copilot Grátis