🔵 VS Code — modo Agent de GitHub Copilot

VS Code
Guía de configuración de MCP Server

VS Code usa MCP a través de GitHub Copilot en modo Agent. Diferencia crítica de todos los otros clientes: la clave de config es "servers" — no "mcpServers".

HTTP · sin instalación .vscode/mcp.json clave: "servers" ⚠

Transporte

HTTP

Clave de config

servers ⚠

Archivo de config

.vscode/mcp.json

Requiere

Copilot + modo Agent

⚠ Diferencia crítica de VS Code: VS Code usa "servers" como clave de nivel superior en .vscode/mcp.json. Todos los otros clientes MCP (Cursor, Claude Desktop, Continue, Cline) usan "mcpServers". Usar la clave incorrecta fallará silenciosamente — VS Code no mostrará un error.

Requisitos previos

VS Code 1.99+ — soporte MCP agregado en actualización de abril de 2025
extensión GitHub Copilot — debe estar instalada e iniciada sesión
GitHub Copilot Chat en modo Agent — cambia a Agent en el panel de chat de Copilot (no modo Ask/Edit)
clave de API de anonym.legal — plan Pro o Business (requerido para acceso MCP) en anonym.legal
Sin Node.js, sin npm, sin instalación local — el servidor MCP de anonym.legal se ejecuta completamente sobre HTTP.

Instalación

Crea .vscode/mcp.json

Crea el archivo en tu raíz del espacio de trabajo. Nota el "servers" clave (no "mcpServers"):

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

Aviso: La entrada HTTP también requiere "type": "http" en VS Code — este es otro campo específico de VS Code no necesario en otros clientes. Sin Node.js, sin subproceso local — la conexión va directamente al punto final MCP de anonym.legal.

Habilita el modo Agent en Copilot Chat

Abre GitHub Copilot Chat (Ctrl+Alt+I / Cmd+Ctrl+I). En la entrada de chat, cambia el desplegable del modo de Ask u Edit a Agent. Las herramientas MCP solo aparecen en modo Agent.

Verifica herramientas disponibles

En modo Agent, haz clic en el icono de herramientas (llave inglesa 🔧) en el panel de chat para ver las herramientas MCP disponibles. Deberías ver los 7 anonym_legal_ tools listados bajo el anonym-legal servidor.

Config de nivel de usuario (todos los espacios de trabajo)

Para aplicar globalmente, abre VS Code User Settings JSON (Ctrl+Shift+P → Preferences: Abre User Settings JSON) y agrega:

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

La diferencia "servers" vs "mcpServers" explicada

Esta es la fuente más común de confusión al cambiar entre clientes:

Solo VS Code

{
  "servers": { ... }
}

Todos los otros clientes

{
  "mcpServers": { ... }
}

Esta es una opción de implementación específica de VS Code. La especificación MCP no ordena un formato de archivo de config — VS Code eligió una clave diferente. Ver el página de comparación para un desglose completo de diferencias.

Herramientas disponibles (7)

anonym_legal_analyze_text
gratuito

Escanea el texto y devuelve todas las entidades PII detectadas con tipo, posición y puntuación de confianza — sin modificar nada.

anonym_legal_anonymize_text
tokens

Reemplaza PII con tokens reversibles usando operadores configurables por tipo de entidad. Devuelve texto anonimizado + mapa de token de sesión.

anonym_legal_detokenize_text
gratuito

Restaura valores de PII original desde tokens de sesión. Se usa para des-anonimizar respuestas de IA.

anonym_legal_get_balance
gratuito

Devuelve tu saldo de token actual, nivel del plan y fecha de reinicio siguiente.

anonym_legal_estimate_cost
gratuito

Vista previa del costo de token para un texto antes de anonimizar. Sin tokens consumidos.

anonym_legal_list_sessions
gratuito

Lista todas las sesiones de tokenización activas con hora de creación, conteo de entidades y vencimiento.

anonym_legal_delete_session
gratuito

Elimina una sesión y todos los tokens almacenados — para cumplimiento del derecho de GDPR a la eliminación.

Operadores (6)

replace

Reemplaza con texto personalizado o etiqueta de tipo de entidad.
John Smith → [CLIENT] o [PERSON]

redact

Elimina completamente — sin rastro en el texto.
john@acme.com → (eliminado)

hash

SHA-256 o SHA-512 — determinístico, unidireccional. Habilita deduplicación en documentos.
John Smith → a3f9b1...

encrypt

AES-256 con tu clave personal — reversible solo por el titular de la clave.
4111-xxxx → enc:U2FsdGVkX1...

mask

Reemplazo parcial — caracteres configurables desde el inicio o el final.
john@acme.com → jo**@****.com

keep

Detecta pero pasa sin cambios. Útil para auditar sin modificar.
John Smith → John Smith (rastreado)

Usar con 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"

Solución de problemas

Herramientas no aparecen en Copilot chat

Confirma que estés en modo Agent (no Ask o Edit). El modo Agent es requerido para acceso a herramientas MCP. Busca el desplegable del modo en el encabezado del panel de Copilot Chat.

Servidor muestra "desconectado" en panel MCP

Verifica el .vscode/mcp.json está usando "servers" (no "mcpServers"). También verifica "type": "http" está presente y el Authorization encabezado contiene una clave de API válida y no revocada en un plan Pro o Business.

VS Code dice "MCP no es compatible"

Actualiza VS Code a 1.99 o posterior. El soporte MCP se agregó en la versión de abril de 2025. Ejecuta Help → Check for Updates.

Copilot no invoca herramientas automáticamente

En modo Agent, Copilot puede solicitar confirmación antes de ejecutar herramientas MCP. Verifica la configuración de VS Code para github.copilot.chat.mcp.autoApprove si deseas permitir invocación automática.

🇩🇪

Versión en alemán

Guía de configuración MCP de VS Code en alemán →

VS CodeGuía de configuración de MCP Server