Tutorial: Configuração do MCP no VS Code

Um servidor MCP (Model Context Protocol) é um sistema backend que atua como intermediário entre um agente de IA (como o GitHub Copilot) e várias ferramentas, APIs ou fontes de dados. Ele fornece uma maneira estruturada para a IA acessar e interagir com sistemas externos, ampliando suas capacidades além da geração básica de código ou texto.

O que é um Servidor MCP?

Um servidor MCP:

• Hospeda uma coleção de ferramentas ou plugins (por exemplo, API do GitHub, acesso ao sistema de arquivos…).

• Recebe consultas da IA com base em prompts do usuário.

• Associa consultas às ferramentas apropriadas, executa ações e retorna resultados.

• Garante interações seguras e controladas com recursos externos.

Ele permite que a IA realize tarefas complexas, como buscar dados do GitHub ou modificar arquivos, servindo como uma ponte entre o raciocínio da IA e a execução prática de comandos.

Aqui está uma lista de servidores MCP:

https://github.com/modelcontextprotocol/servers

https://github.com/punkpeye/awesome-mcp-servers

Pré-requisitos

Antes de começar, certifique-se de que você tem:

• VS Code versão 1.99 ou superior instalado.

• Uma assinatura ativa do GitHub Copilot (plano gratuito ou pago) com a extensão Copilot habilitada no VS Code.

• Conhecimento de que o suporte ao MCP no modo agente está em fase de visualização (preview), então os recursos podem mudar.

Configurando o Servidor MCP no VS Code

Passo 1: Criar o Arquivo .vscode/mcp.json

1. Abra seu projeto no VS Code.

2. Se seu espaço de trabalho não tiver uma pasta .vscode:

   • Clique com o botão direito na visão do Explorer, selecione Nova Pasta e nomeie como .vscode.

3. Dentro da pasta .vscode, crie o arquivo mcp.json:

   • Clique com o botão direito, selecione Novo Arquivo e nomeie como mcp.json.

Passo 2: Definir a Configuração do MCP

O arquivo .vscode/mcp.json usa o formato JSON para definir servidores MCP. Geralmente, ele inclui duas seções principais:

• inputs: Define entradas do usuário (por exemplo, chaves de API) necessárias pelo servidor, solicitadas na primeira inicialização e armazenadas com segurança pelo VS Code.

• servers: Especifica os servidores MCP, incluindo seus nomes, tipos, comandos e argumentos.

Exemplo: Configurando um Servidor MCP para o GitHub

Passo 1: Configurar e Iniciar o Servidor

1. Adicione a configuração acima ao seu arquivo mcp.json, seguindo a documentação oficial do MCP.

2. Salve o arquivo e reinicie o VS Code.

3. Na inicialização, o VS Code solicitará seu token do GitHub. Insira-o com segurança.

4. O servidor será iniciado (por exemplo, via Docker, conforme especificado na configuração).

Pronto, não poderia ser mais fácil. Vamos conferir!

Passo 2: Interagir com o Copilot

Com o servidor MCP em execução, o Copilot agora pode:

• Acessar os detalhes da sua conta do GitHub.

• Consultar repositórios públicos e privados, incluindo aqueles da sua organização.

• Executar tarefas como buscar commits ou atualizar perfis.

Por exemplo, pergunte ao Copilot: “Mostre meu último commit no GitHub.” Ele consultará o servidor MCP, recuperará os dados e os exibirá na visão de chat.

Até mesmo para repositórios privados da minha organização

Resumo

Configurar um servidor MCP no VS Code desbloqueia recursos poderosos para o GitHub Copilot, permitindo que ele interaja com sua conta do GitHub e muito mais. Ao configurar o mcp.json e fornecer entradas seguras, você pode automatizar tarefas, acessar dados privados e otimizar seu fluxo de trabalho — tudo isso mantendo o controle do processo. Experimente e explore as possibilidades!