Como adicionar um novo servidor MCP ao VS Code

As integrações MCP ampliam os recursos de IA ao oferecer ferramentas com as quais ela pode interagir, e essa nova abordagem também chegou aos desenvolvedores de VS Code.

O MCP surgiu com o anúncio da Anthropic e, em seguida, ganhou ampla adoção pela comunidade de desenvolvimento, por startups que disponibilizaram servidores MCP para interação e pela nova geração de IDEs para desenvolvedores que adotou o MCP para aprimorar os fluxos de trabalho.

O VS Code também não ficou de fora. Embora existam várias extensões de codificação com IA para VS Code, como Qodo Gen, Cline e outras, a equipe do GitHub Copilot adotou desde cedo o suporte em prévia ao MCP no modo de agente do VS Code.

O VS Code oferece suporte a servidores MCP locais baseados em processos, que usam STDIO, e a servidores MCP que se comunicam por uma rede HTTP / SSE (remota).

Como adicionar um novo servidor MCP

Você pode acessar facilmente a lista de servidores MCP ou adicionar novos pela paleta de comandos: abra-a com CMD + SHIFT + P e digite “MCP”. Você verá uma lista semelhante de ações disponíveis para escolher:

A definição de novos servidores MCP segue o mesmo princípio de adicionar servidores MCP ao Cursor e a outras ferramentas de IA agentiva: definir a configuração JSON em um arquivo de configuração MCP dedicado.

No VS Code, o arquivo de configuração MCP fica em .vscode/mcp.json. Vamos adicionar o servidor MCP do GitHub usando o método Docker para iniciar o processo. Para isso, você precisará de:

1. Docker instalado e em execução

2. Um token de acesso pessoal (PAT) criado na página da sua conta do GitHub

Agora que você já tem esses itens, vamos definir uma nova entrada de servidor MCP em `.vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "github_token",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ],
  "servers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
      }
    }
  }
}

Agente de IA do GitHub Copilot interage com servidores MCP

Depois de configurar o servidor MCP do GitHub para ser executado com o arquivo .vscode/mcp.json, podemos mudar para o modo Agent no GitHub Copilot e conferir todas as ferramentas disponíveis no chat.

Na caixa de texto do chat, há um ícone com o número “36”. Ao clicar nele, você verá a janela de comandos a seguir, que mostra todas as ferramentas disponíveis pelas integrações com servidores MCP:

Como configurar o token de acesso pessoal do GitHub para o servidor MCP

Antes de interagir com o servidor MCP do GitHub, precisamos fornecer nosso token de acesso pessoal. 

Você deve ter notado que o arquivo de configuração MCP mcp.json tem um campo dedicado a inputs, que mapeia o identificador github_token dessa chave JSON para a variável de ambiente GITHUB_PERSONAL_ACCESS_TOKEN, definida na propriedade servers da entrada github.

Para evitar expor credenciais e tokens de API como texto simples em arquivos de configuração, como o arquivo mcp.json, a integração do MCP com o VS Code permite solicitar interativamente o PAT do GitHub quando o servidor é iniciado.

Se o servidor MCP já estiver em execução, clique no link Stop na sugestão de código embutida do arquivo mcp.json e, em seguida, clique em Start novamente. A caixa de entrada para o PAT do GitHub será exibida:

Como listar problemas de repositórios do GitHub pela integração do servidor MCP do GitHub Copilot

Agora, podemos retomar o fluxo de desenvolvimento e pedir no chat uma lista dos problemas ou das solicitações de pull em aberto no repositório do GitHub deste projeto. O LLM executará ferramentas para entender exatamente o que significa “este projeto” e, em seguida, chamará as ferramentas relevantes disponíveis no servidor MCP do GitHub que configuramos para responder à solicitação:

Quer saber mais sobre segurança de IA?

• Leia sobre Como a IA está sendo usada na cibersegurança?

• Preocupado com o uso do ChatGPT na sua empresa? Segurança de codificação com ChatGPT para empresas

• Você já ouviu falar de IA sombra?