Como Usar o Servidor MCP do VSCode

Introdução ao Servidor MCP do VSCode

O MCP (Modelo de Protocolo de Contexto) é um padrão aberto inovador que transforma a forma como modelos de IA interagem com ferramentas e serviços externos através de uma interface unificada. No VSCode, o suporte ao MCP aprimora o modo agente do GitHub Copilot ao permitir que você conecte qualquer servidor compatível com MCP aos seus fluxos de trabalho de codificação alimentados por IA. Este tutorial irá guiá-lo por tudo que você precisa saber sobre o uso de servidores MCP com o VSCode, desde a configuração inicial até configurações avançadas e soluções de problemas.

O que é o Servidor MCP do VSCode

O Protocolo de Contexto do Modelo permite que modelos de IA descubram e interajam com ferramentas externas, aplicativos e fontes de dados através de uma interface padronizada. Ao usar o VSCode com o modo agente do Copilot, a IA pode aproveitar várias ferramentas para realizar tarefas, como operações de arquivos, acesso a bancos de dados ou chamadas de APIs com base nas suas solicitações.

O MCP segue uma arquitetura cliente-servidor:

• Clientes MCP (como o VSCode) conectam-se a servidores MCP e solicitam ações em nome do modelo de IA.
• Servidores MCP fornecem ferramentas que expõem funcionalidades específicas através de interfaces bem definidas.
• O protocolo define formatos de mensagem para comunicação entre clientes e servidores, cobrindo descoberta de ferramentas, invocações e tratamento de respostas.

Por exemplo, um servidor de arquivos MCP pode fornecer ferramentas para leitura, escrita ou busca de arquivos e diretórios. O servidor MCP do GitHub oferece ferramentas para listar repositórios, criar pull requests ou gerenciar problemas. Esses servidores podem ser executados localmente em sua máquina ou hospedados remotamente.

Configurando seu Primeiro Servidor MCP do VSCode

Passo 1: Adicionando um Servidor MCP ao seu Espaço de Trabalho

Existem várias maneiras de adicionar um servidor MCP ao VSCode:

Usando o arquivo de configuração do espaço de trabalho:

• Crie um arquivo .vscode/mcp.json em seu espaço de trabalho
• Selecione o botão "Adicionar Servidor" para adicionar um modelo para um novo servidor
• O VSCode fornece IntelliSense para a configuração do servidor MCP

Usando a Paleta de Comandos:

• Execute o comando MCP: Adicionar Servidor
• Escolha "Configurações do Espaço de Trabalho" para criar o arquivo .vscode/mcp.json em seu espaço de trabalho

Usando Configurações do Usuário para acesso global:

• Abra a Paleta de Comandos e execute MCP: Adicionar Servidor
• Selecione "Configurações do Usuário" para adicionar a configuração do servidor MCP globalmente

Passo 2: Compreendendo o Formato de Configuração do Servidor MCP do VSCode

A configuração do servidor MCP segue um formato JSON específico:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "api-key",
      "description": "Chave da API",
      "password": true
    }
  ],
  "servers": {
    "MeuServidor": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-example"],
      "env": {
        "API_KEY": "${input:api-key}"
      }
    }
  }
}

Os elementos principais são:

• inputs: Definem espaços reservados personalizados para valores de configuração
• servers: Contém a lista de servidores MCP
• type: Tipo de conexão ("stdio" ou "sse")
• command: Comando para iniciar o executável do servidor
• args: Array de argumentos passados para o comando
• env: Variáveis de ambiente para o servidor

Tipos de Conexão e Opções de Configuração do Servidor MCP do VSCode

Conexão STDIO para Servidor MCP do VSCode

Para conexões de entrada/saída padrão:

"MeuServidor": {
  "type": "stdio",
  "command": "npx",
  "args": ["server.js", "--port", "3000"],
  "env": {"API_KEY": "${input:api-key}"}
}

Conexão SSE para Servidor MCP do VSCode

Para conexões de eventos enviados pelo servidor:

"MeuServidorRemoto": {
  "type": "sse",
  "url": "http://api.exemplo.com/sse",
  "headers": {"VERSION": "1.2"}
}

Usando Variáveis na Configuração do Servidor MCP do VSCode

Você pode usar variáveis predefinidas em sua configuração:

"MeuServidor": {
  "type": "stdio",
  "command": "node",
  "args": ["${workspaceFolder}/server.js"]
}

Exemplos Avançados de Configuração do Servidor MCP do VSCode

Aqui está um exemplo mais abrangente mostrando múltiplos servidores e variáveis de entrada:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "perplexity-key",
      "description": "Chave da API Perplexity",
      "password": true
    }
  ],
  "servers": {
    "Perplexidade": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PERPLEXITY_API_KEY", "mcp/perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "${input:perplexity-key}"
      }
    },
    "Buscar": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "ServidorRemoto": {
      "type": "sse",
      "url": "http://api.contoso.com/sse",
      "headers": {"VERSION": "1.2"}
    }
  }
}

Usando Ferramentas MCP do VSCode no Modo Agente

Uma vez que você configurou seus servidores MCP, você pode usar suas ferramentas no modo agente do Copilot:

1. Abra a visualização de Chat (Windows, Linux: Ctrl+Alt+I, Mac: ⌃⌘I)
2. Selecione o modo "Agente" no menu suspenso
3. Clique no botão "Ferramentas" para visualizar as ferramentas disponíveis
4. Selecione ou desmarque ferramentas conforme necessário
5. Digite seu prompt na entrada de chat

Quando uma ferramenta é invocada, você precisará confirmar a ação antes que ela seja executada. Você pode configurar o VSCode para confirmar automaticamente ferramentas específicas para a sessão atual, espaço de trabalho ou todas as futuras invocações usando o menu suspenso do botão "Continuar".

Gerenciando Servidores e Ferramentas MCP do VSCode

Visualizando e Gerenciando Servidores

Execute o comando MCP: Listar Servidores a partir da Paleta de Comandos para visualizar seus servidores MCP configurados. A partir desta visualização, você pode:

• Iniciar, parar ou reiniciar servidores
• Visualizar as configurações do servidor
• Acessar os logs do servidor para solucionar problemas

Referências Diretas de Ferramentas no Servidor MCP do VSCode

Você pode referenciar diretamente uma ferramenta em seu prompt digitando # seguido pelo nome da ferramenta. Isso funciona em todos os modos de chat (perguntar, editar e modo agente).

Configuração de Linha de Comando para Servidor MCP do VSCode

Você pode adicionar servidores MCP usando a linha de comando do VSCode:

code --add-mcp "{\"name\":\"meu-servidor\",\"command\":\"uvx\",\"args\":[\"mcp-server-fetch\"]}"

Resolução de Problemas com Servidores MCP do VSCode

Quando o VSCode encontra problemas com o servidor MCP, ele exibe um indicador de erro na visualização de Chat. Para diagnosticar problemas:

1. Clique na notificação de erro na visualização de Chat
2. Selecione "Mostrar Saída" para visualizar os logs do servidor
3. Alternativamente, execute MCP: Listar Servidores a partir da Paleta de Comandos, selecione o servidor e escolha "Mostrar Saída"

Problemas comuns incluem:

• Configuração incorreta do servidor
• Dependências ausentes
• Problemas de conectividade de rede para servidores remotos
• Problemas de permissão para executáveis locais

Criando Seu Próprio Servidor MCP do VSCode

Se você deseja desenvolver seu próprio servidor MCP, pode usar qualquer linguagem de programação capaz de lidar com stdout. Vários SDKs oficiais estão disponíveis:

• SDK TypeScript
• SDK Python
• SDK Java
• SDK Kotlin
• SDK C#

Seu servidor deve implementar o padrão MCP, que define como as ferramentas são descobertas, invocadas e como as respostas são formatadas.

Descoberta Automática e Integração do Servidor MCP do VSCode

O VSCode pode detectar e reutilizar automaticamente servidores MCP definidos em outras ferramentas, como o Claude Desktop. Você pode habilitar a descoberta automática com a configuração chat.mcp.discovery.enabled nas configurações do seu VSCode.

FAQ: Perguntas Comuns sobre o Servidor MCP do VSCode

Posso controlar quais ferramentas MCP são usadas?

Sim, você pode ativar/desativar ferramentas específicas na interface do modo Agente, referenciar diretamente ferramentas com o prefixo # em seus prompts, ou usar .github/copilot-instructions.md para um controle mais avançado.

Os servidores MCP são seguros?

O VSCode implementa medidas de segurança, como exigir confirmação antes de executar ferramentas e armazenar de forma segura entradas sensíveis, como chaves de API. No entanto, você deve usar apenas servidores MCP de fontes confiáveis.

Posso usar servidores MCP com outros assistentes de IA?

O MCP é um padrão aberto projetado para funcionar com múltiplos modelos de IA. Embora o VSCode atualmente integre com o GitHub Copilot, o protocolo é compatível com outros sistemas de IA que suportam o padrão.

Conclusão: Maximizando o Potencial do Servidor MCP do VSCode

Servidores MCP ampliam significativamente as capacidades dos assistentes de IA no VSCode, proporcionando acesso padronizado a ferramentas e serviços externos. Seguindo este guia, agora você pode:

• Configurar e configurar servidores MCP em seu ambiente VSCode
• Usar ferramentas MCP com o modo agente do GitHub Copilot
• Gerenciar e solucionar problemas em seus servidores MCP
• Criar seus próprios servidores MCP se necessário

O Protocolo de Contexto do Modelo ainda está evoluindo, com um ecossistema crescente de servidores e ferramentas disponíveis para integração com seus projetos. Ao dominar os servidores MCP do VSCode, você está se posicionando na vanguarda do desenvolvimento assistido por IA, permitindo fluxos de trabalho de codificação mais poderosos e eficientes.

Continue explorando o ecossistema MCP e experimente diferentes servidores para encontrar as ferramentas que melhor aprimoram seu processo de desenvolvimento. Com configuração adequada e entendimento do protocolo, você pode transformar seu assistente de IA em um verdadeiro parceiro poderoso de codificação.