🔵 VS Code — Modo Agente GitHub Copilot

VS Code
Guia de Configuração do Servidor MCP

VS Code usa MCP via GitHub Copilot em modo Agent. Diferença crítica de todos os outros clientes: a chave de configuração é "servers" — não "mcpServers".

HTTP · sem instalação .vscode/mcp.json chave: "servers" ⚠

Transporte

HTTP

Chave de configuração

servers ⚠

Ficheiro de configuração

.vscode/mcp.json

Requer

Copilot + modo Agent

⚠ Diferença Crítica VS Code: VS Code usa "servers" como chave de nível superior em .vscode/mcp.json. Todos os outros clientes MCP (Cursor, Claude Desktop, Continue, Cline) usam "mcpServers". Usar a chave errada falhará silenciosamente — VS Code não mostrará um erro.

Pré-requisitos

VS Code 1.99+ — suporte MCP adicionado em atualização de abril 2025
Extensão GitHub Copilot — deve estar instalado e autenticado
GitHub Copilot Chat em modo Agent — mude para Agent no painel chat Copilot (não modo Ask/Edit)
Chave de API anonym.legal — plano Pro ou Business (necessário para acesso MCP) em anonym.legal
Sem Node.js, sem npm, sem instalação local — o servidor MCP anonym.legal funciona inteiramente sobre HTTP.

Instalação

Crie .vscode/mcp.json

Crie o ficheiro na raiz do seu espaço de trabalho. Note a "servers" chave (não "mcpServers"):

{
  "servers": {
    "anonym-legal": {
      "type": "http",
      "url": "https://anonym.legal/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Observe: A entrada HTTP também requer "type": "http" em VS Code — este é outro campo específico de VS Code não necessário em outros clientes. Sem Node.js, sem subprocesso local — a conexão vai direto para o ponto final MCP anonym.legal.

Ativa Modo Agent em Copilot Chat

Abra GitHub Copilot Chat (Ctrl+Alt+I / Cmd+Ctrl+I). Na entrada de chat, mude o dropdown de modo de Ask ou Edit para Agent. Ferramentas MCP aparecem apenas em modo Agent.

Verifique Ferramentas Disponíveis

Em modo Agent, clique no ícone de ferramentas (chave inglesa 🔧) no painel de chat para ver ferramentas MCP disponíveis. Deve ver as 7 anonym_legal_ ferramentas listadas sob o anonym-legal servidor.

Configuração ao Nível do Utilizador (Todos os Espaços de Trabalho)

Para aplicar globalmente, abra JSON de Definições de Utilizador VS Code (Ctrl+Shift+P → Preferências: Abra JSON de Definições de Utilizador) e adicione:

{
  "github.copilot.chat.mcp.servers": {
    "anonym-legal": {
      "type": "http",
      "url": "https://anonym.legal/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

A Diferença "servers" vs "mcpServers" Explicada

Esta é a fonte mais comum de confusão ao mudar entre clientes:

Apenas VS Code

{
  "servers": { ... }
}

Todos os outros clientes

{
  "mcpServers": { ... }
}

Esta é uma escolha de implementação específica de VS Code. A especificação MCP não impõe um formato de ficheiro de configuração — VS Code escolheu uma chave diferente. Veja o página de comparação para uma análise completa de diferenças.

Ferramentas Disponíveis (7)

anonym_legal_analyze_text
gratuito

Analise o texto e devolva todas as entidades PII detectadas com tipo, posição e pontuação de confiança — sem modificar nada.

anonym_legal_anonymize_text
tokens

Substitua PII por tokens reversíveis usando operadores configuráveis por tipo de entidade. Devolve texto anonimizado + mapa de tokens de sessão.

anonym_legal_detokenize_text
gratuito

Restaure valores de PII originais a partir de tokens de sessão. Usado para desanonimizar respostas de IA.

anonym_legal_get_balance
gratuito

Devolve o seu saldo de tokens atual, nível de plano e data de próxima reposição.

anonym_legal_estimate_cost
gratuito

Pré-visualize o custo de tokens para um texto antes de anonimizá-lo. Sem tokens consumidos.

anonym_legal_list_sessions
gratuito

Liste todas as sessões de tokenização ativas com hora de criação, contagem de entidades e expiração.

anonym_legal_delete_session
gratuito

Elimine uma sessão e todos os tokens armazenados — para conformidade com direito ao esquecimento do GDPR.

Operadores (6)

replace

Substitua por texto personalizado ou rótulo de tipo de entidade.
John Smith → [CLIENTE] ou [PESSOA]

redact

Remova completamente — sem rastos deixados no texto.
john@acme.com → (removido)

hash

SHA-256 ou SHA-512 — determinístico, unidirecional. Permite deduplicação em documentos.
John Smith → a3f9b1...

encrypt

AES-256 com a sua chave pessoal — reversível apenas pelo detentor da chave.
4111-xxxx → enc:U2FsdGVkX1...

mask

Substituição parcial — caracteres configuráveis do início ou fim.
john@acme.com → jo**@****.com

keep

Detecte mas passe inalterado. Útil para auditar sem modificar.
John Smith → John Smith (rastreado)

Usar com GitHub Copilot Agent

Before processing this code review request, use anonym_legal_anonymize_text
to replace all developer names with [DEV] and all email addresses with [EMAIL].

"Review the code by alice.smith@company.com — she pushed a fix for
Bob Johnson's reported bug in auth.ts"

Resolução de Problemas

Ferramentas não aparecem em chat Copilot

Confirme que está em modo Agent (não Ask ou Edit). Modo Agent é necessário para acesso de ferramentas MCP. Procure o dropdown de modo no cabeçalho do painel Copilot Chat.

Servidor mostra "desconectado" em painel MCP

Verifique o .vscode/mcp.json está usando "servers" (não "mcpServers"). Também verifique "type": "http" está presente e o Authorization cabeçalho contém uma chave de API válida e não revogada num plano Pro ou Business.

VS Code diz "MCP não é suportado"

Atualize VS Code para 1.99 ou posterior. Suporte MCP foi adicionado no lançamento de abril 2025. Execute Help → Check for Updates.

Copilot não invoca ferramentas automaticamente

Em modo Agent, Copilot pode pedir confirmação antes de executar ferramentas MCP. Verifique definições VS Code para github.copilot.chat.mcp.autoApprove se deseja permitir invocação automática.

🇩🇪

Versão em Alemão

Guia de Configuração VS Code MCP em Alemão →

VS CodeGuia de Configuração do Servidor MCP