Estendendo o GitHub Copilot Chat com servidores MCP (Protocolo de Contexto do Modelo)

Pré-requisitos

• Acesso a Copilot. Confira O que é GitHub Copilot?.

          Visual Studio Code versão 1.99 ou posterior**. Para obter informações sobre como instalar Visual Studio Code, consulte a [Visual Studio Code página de download](https://code.visualstudio.com/Download?ref_product=copilot&ref_type=engagement&ref_style=text).

• Se você for membro de uma organização ou empresa com um plano Copilot Business ou Copilot Enterprise, a política "Servidores MCP no Copilot" deverá ser habilitada para usar o MCP com o Copilot.

Configurando servidores MCP em Visual Studio Code

Os servidores MCP podem ser configurados manualmente em um arquivo de configuração ou por meio do GitHub Registro MCP. O GitHub Registro MCP fornece uma lista de servidores MCP que você pode adicionar facilmente à sua Visual Studio Code instância.

Usando o GitHub Registro MCP

Somente servidores MCP listados no GitHub Registro MCP podem ser adicionados por meio do registro. Outros servidores podem ser configurados manualmente. Consulte Configurando servidores MCP manualmente.

1. Em Visual Studio Code, abra o painel de extensões clicando no ícone de extensões na barra lateral ou pressionando Ctrl+Shift+X (Windows/Linux) / Command+Shift+X (Mac).
2. Na barra de pesquisa de extensões, digite @mcp seguido pelo nome do servidor MCP que você deseja adicionar. Isso abre a galeria de servidores MCP e mostra os resultados correspondentes.
3. Selecione o servidor MCP nos resultados da pesquisa. Na página de detalhes do servidor MCP, clique em Instalar.
4. Quando solicitado, confirme se você confia no servidor para iniciá-lo. VS Code descobre as ferramentas do servidor e as disponibiliza no chat.
5. Para verificar se o servidor MCP está configurado corretamente, abra a paleta de comandos pressionando Ctrl+Shift+P (Windows >/Linux) / Command+Shift+P (Mac).
6. Digite e selecione MCP: Listar Servidores. Você deve ver o servidor MCP listado como um servidor configurado.

Configurando servidores MCP manualmente

Para configurar servidores Visual Studio CodeMCP, você precisa configurar um script de configuração que especifique os detalhes dos servidores MCP que você deseja usar. Você pode configurar servidores MCP para:

• Um repositório específico. Isso permite que você compartilhe servidores de MCP com qualquer pessoa que abra o projeto no Visual Studio Code. Para fazer isso, crie um arquivo .vscode/mcp.json na raiz do repositório.

• Sua instância pessoal do Visual Studio Code. Você será a única pessoa que terá acesso a servidores MCP configurados. Para fazer isso, adicione a configuração ao arquivo settings.json no Visual Studio Code. Os servidores de MCP configurados dessa forma ficarão disponíveis em todos os workspaces.

  Observação

  We recommend you use only one location per server. Adding the same server to both locations may cause conflicts and unexpected behavior.

As etapas abaixo mostram como configurar o servidor Fetch MCP no arquivo .vscode/mcp.json. O servidor Fetch MCP é um servidor MCP simples que fornece funcionalidades de busca de conteúdo na Web. Para obter mais informações sobre o servidor FETCH MCP, consulte o diretório Fetch no repositório do SERVIDOR MCP.

Você pode usar as mesmas etapas para configurar servidores MCP em suas configurações pessoais Visual Studio Code . Detalhes sobre como configurar outros servidores MCP estão disponíveis no repositório de servidores MCP.

Para obter informações sobre como configurar o GitHub servidor MCP, consulte Usando o servidor MCP GitHub em seu IDE.

1. Adicione a configuração a seguir ao arquivo .vscode/mcp.json:

   JSON

   {
   "inputs": [
     // The "inputs" section defines the inputs required for the MCP server configuration.
     {
       "type": "promptString"
     }
   ],
   "servers": {
     // The "servers" section defines the MCP servers you want to use.
     "fetch": {
       "command": "uvx",
       "args": ["mcp-server-fetch"]
     }
    }
   }
   

2. Salve o arquivo .vscode/mcp.json.

3. Um botão "Iniciar" será exibido no arquivo .vscode/mcp.json, na parte superior da lista de servidores. Clique no botão "Iniciar" para iniciar os servidores MCP. Isso disparará a caixa de diálogo de entrada e descobrirá as ferramentas do servidor, que são armazenadas para sessões posteriores.

   

4. Abra Bate-papo do Copilot clicando no ícone na barra de título de Visual Studio Code.

5. Na caixa Bate-papo do Copilot, selecione Agente no menu pop-up.

   

6. Para exibir a lista de servidores MCP disponíveis, clique no ícone de ferramentas no canto superior esquerdo da caixa de chat. Isso abrirá a lista de servidores MCP, em que você poderá ver todos os servidores MCP e ferramentas associadas que estão disponíveis atualmente em sua Visual Studio Code instância.

   • Como opção, você pode definir conjuntos de ferramentas, grupos de ferramentas relacionadas que podem ser referenciadas no chat. Os conjuntos de ferramentas facilitam o agrupamento das ferramentas MCP relacionadas e as habilitam ou desabilitam rapidamente. Para obter informações sobre como definir e usar um conjunto de ferramentas, consulte os VS Code documentos.

Para obter mais informações sobre como configurar servidores MCP em Visual Studio Code, consulte Usar servidores MCP na Visual Studio Code na Visual Studio Code documentação.

Usando servidores MCP em Bate-papo do Copilot

Depois de configurar seus servidores MCP, você poderá usá-los Bate-papo do Copilot para acessar uma ampla gama de ferramentas e serviços. No exemplo abaixo, usaremos o servidor Fetch MCP para buscar detalhes sobre uma página da Web.

1. Abra o Bate-papo do Copilot clicando no ícone na barra de título do Visual Studio Code.

2. Na caixa Bate-papo do Copilot, selecione Agente no menu suspenso do agente.

3. No arquivo com a configuração do MCP, verifique se o servidor MCP está em execução. Se não estiver, clique no botão "Iniciar" para iniciar o servidor MCP.

   

4. Peça Bate-papo do Copilot para buscar os detalhes de uma URL. Por exemplo:

   Fetch https://github.com/github/docs.

5. Se Copilot solicitar que você confirme se deseja continuar, clique em Continuar.

6.        Copilot buscará os detalhes da URL e os exibirá na caixa de chat.
   

Opcionalmente, você pode usar prompts e recursos do MCP em VS Code.

• Os servidores MCP podem definir prompts pré-configurados para interagir com suas ferramentas. Você pode acessar esses prompts no chat com comandos de barra, usando o formato /mcp.servername.promptname.
• Os servidores MCP fornecem recursos, que são qualquer tipo de dados que o servidor deseja disponibilizar. Por exemplo, o GitHub servidor MCP fornece o conteúdo do repositório como um recurso. Para adicionar recursos de um servidor de MCP ao contexto do chat, clique em Adicionar Contexto... na caixa de chat e clique em Recursos do MCP.

Para obter mais informações sobre como usar servidores MCP em Visual Studio Code, consulte Usar servidores MCP em Visual Studio Code na Visual Studio Code documentação.

Como usar configurações de MCP existentes

Se você já tiver uma configuração de MCP no Claude Desktop, poderá usar essa configuração Visual Studio Code para acessar os mesmos servidores MCP. Para fazer isso, adicione a seguinte configuração ao arquivo settings.json em Visual Studio Code:

"chat.mcp.discovery.enabled": true

"chat.mcp.discovery.enabled": true

          Visual Studio Code localizará automaticamente sua configuração existente e a usará em sua Visual Studio Code instância.