Conectar un cliente MCP

Claude CodeCopiar enlace a esta sección

Deja que init lo escriba Disponible a partir de 0.12.0Copiar enlace a esta sección

Recomendado, desde la raíz del proyecto:

npx @verbatra/cli init --agent

init --agent escribe el archivo de instrucciones para agentes y, con el gasto desactivado, esta entrada en el .mcp.json del repositorio cuando encuentra Claude Code (CLAUDE.md, .claude/ o .mcp.json) o ningún cliente; --client claude la fuerza:

{
  "mcpServers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Reinicia Claude Code y aprueba el servidor verbatra; Claude Code le transmite CLAUDE_PROJECT_DIR y tu entorno. Para gastar en una sesión, exporta la clave y ejecuta:

VERBATRA_MCP_ALLOW_SPEND=1 claude

claude mcp list comprueba la conexión. Consulta la documentación de MCP de Claude Code.

Otras víasCopiar enlace a esta sección

Sin la CLICopiar enlace a esta sección

claude mcp add --transport stdio --scope project verbatra -- npx -y @verbatra/mcp

Esto escribe la misma entrada. Nunca añadas --env KEY=value aquí: escribe el valor en .mcp.json.

El plugin de verbatra Disponible a partir de @verbatra/mcp 0.3.0Copiar enlace a esta sección

En lugar de .mcp.json, el plugin reúne las skills de verbatra, este servidor y un hook que revisa un archivo de locale después de que Claude lo edite.

claude plugin marketplace add verbatra/skills
claude plugin install verbatra@verbatra --scope project

• Servidor: un @verbatra/mcp de versión fija con --cwd en el proyecto abierto.
• Gasto: desactivado hasta que actives la opción allowSpend del plugin (--config allowSpend=true, o /config). Un archivo del repositorio no puede activarla.
• Clave: del entorno con el que arrancaste claude.
• Hook: ejecuta el verbatra check --file <path> del proyecto (CLI 0.12.0 o posterior) e informa de placeholders, markup o ICU rotos, sin llamar a ningún proveedor.

Consulta la referencia de plugins de Claude Code.

CodexCopiar enlace a esta sección

Lo recomendado: npx @verbatra/cli init --agent --client codex (o init --agent a secas cuando existe .codex/) añade esta tabla al final de .codex/config.toml, con el gasto desactivado:

[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp"]
startup_timeout_sec = 60

Codex solo la carga cuando respondes a Trust this folder?, que cubre la raíz del repositorio. Si arrancas desde una subcarpeta, el servidor se sitúa en la configuración que encuentra. Consulta la documentación de MCP de Codex.

Configuración de usuario de CodexCopiar enlace a esta sección

Para gastar, usa ~/.codex/config.toml en su lugar. env_vars transmite variables por su nombre; una tabla env o codex mcp add --env guarda el valor:

[mcp_servers.verbatra]
command = "npx"
args = ["-y", "@verbatra/mcp", "--allow-spend"]
cwd = "/path/to/your/project"
env_vars = ["ANTHROPIC_API_KEY"]

Gemini CLICopiar enlace a esta sección

Lo recomendado: npx @verbatra/cli init --agent --client gemini (o init --agent a secas cuando existe .gemini/ o GEMINI.md) añade esta entrada a .gemini/settings.json, con el gasto desactivado:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Gemini CLI solo la lee de la carpeta en la que arranca: inicia gemini en la raíz del proyecto y dale confianza en el diálogo o con /permissions trust. Deja trust sin definir; /mcp muestra las herramientas. Lee GEMINI.md, no AGENTS.md: añade "context": { "fileName": ["AGENTS.md", "GEMINI.md"] } a los ajustes o @AGENTS.md a GEMINI.md. Consulta la documentación de MCP de Gemini CLI.

Ajustes de usuario de Gemini CLICopiar enlace a esta sección

Para gastar, usa tus ajustes de usuario con un cwd absoluto:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--allow-spend"],
      "cwd": "/path/to/your/project",
      "env": {
        "ANTHROPIC_API_KEY": "$ANTHROPIC_API_KEY"
      }
    }
  }
}

Gemini CLI oculta a los servidores las variables de claves, así que pasa la clave por env.

CursorCopiar enlace a esta sección

init --agent escribe el .cursor/mcp.json de Cursor cuando encuentra .cursor/ o .cursorrules, o con --client cursor:

{
  "mcpServers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "${workspaceFolder}"]
    }
  }
}

Para gastar, añade "--allow-spend" al final de args y agrega "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Consulta la documentación de MCP de Cursor.

VS CodeCopiar enlace a esta sección

VS Code (el modo agente de GitHub Copilot) lee .vscode/mcp.json, con la clave servers, que escribe init --agent --client vscode. Sin --client, init --agent solo lo conecta cuando ese archivo ya existe e imprime el comando para una carpeta .vscode/ sin él. No hace falta --cwd:

{
  "servers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Para gastar, declara la clave como input, que VS Code guarda fuera del archivo:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "anthropic-key",
      "description": "Anthropic API key",
      "password": true
    }
  ],
  "servers": {
    "verbatra": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--allow-spend"],
      "env": {
        "ANTHROPIC_API_KEY": "${input:anthropic-key}"
      }
    }
  }
}

Añadir a VS Code

En lugar del archivo, el botón o este comando añade la entrada sin gasto a tu perfil de usuario; usa una de las tres vías, nunca dos:

code --add-mcp '{"name":"verbatra","command":"npx","args":["-y","@verbatra/mcp"]}'

Consulta la referencia de configuración de MCP de VS Code.

GitHub CopilotCopiar enlace a esta sección

Copilot cloud agentCopiar enlace a esta sección

Una persona administradora del repositorio añade el servidor en Settings, Copilot, MCP servers. El cloud agent llama a las herramientas sin preguntar, así que lista solo las que ni escriben ni llaman a un proveedor:

{
  "mcpServers": {
    "verbatra": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"],
      "tools": [
        "project.snapshot",
        "project.doctor",
        "status.check",
        "status.diff",
        "glossary.get",
        "lock.state",
        "history.list",
        "key.integrity",
        "locale.integrity",
        "key.value",
        "key.context",
        "locale.values",
        "translation.estimate",
        "review.queue",
        "report.provenance",
        "usage.summary"
      ]
    }
  }
}

Añade translation.editEntry y glossary.write solo si el agente debe escribir en su pull request, y deja fuera review.approve y review.reject: una decisión de revisión necesita a una persona. Para comprobarlo, abre View session y despliega Start MCP Servers. Consulta Extending the cloud agent with MCP.

Copilot CLICopiar enlace a esta sección

copilot mcp add verbatra -- npx -y @verbatra/mcp --cwd /path/to/your/project

Esto escribe ~/.copilot/mcp-config.json. Copilot CLI solo le pasa PATH a un servidor, así que una clave va en el env de esa entrada, nunca en un archivo del proyecto. Consulta Adding MCP servers to Copilot CLI.

WindsurfCopiar enlace a esta sección

Windsurf lee un único mcp_config.json para todos los proyectos, así que --cwd es absoluto:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
    }
  }
}

Para gastar, añade "--allow-spend" al final y agrega "env": { "ANTHROPIC_API_KEY": "${env:ANTHROPIC_API_KEY}" }. Consulta la documentación de MCP de Cascade.

ZedCopiar enlace a esta sección

Zed lee context_servers de sus ajustes; Settings, AI, MCP Servers, Add Server escribe la entrada:

{
  "context_servers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"],
      "env": {}
    }
  }
}

Una clave en env es un valor literal, así que añádela junto con --allow-spend solo en tus ajustes de usuario, nunca en .zed/settings.json. Consulta la documentación de MCP de Zed.

JetBrains AI AssistantCopiar enlace a esta sección

Abre Settings, Tools, AI Assistant, Model Context Protocol (MCP), añade un servidor y pega:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp"]
    }
  }
}

Pon Working directory en la raíz del proyecto y deja esta entrada sin gasto. Consulta la documentación de MCP de AI Assistant.

Claude DesktopCopiar enlace a esta sección

Settings, Developer, Edit Config abre claude_desktop_config.json. No hay proyecto, así que --cwd es absoluto:

{
  "mcpServers": {
    "verbatra": {
      "command": "npx",
      "args": ["-y", "@verbatra/mcp", "--cwd", "/path/to/your/project"]
    }
  }
}

Para gastar, añade "--allow-spend" al final y agrega "env": { "ANTHROPIC_API_KEY": "..." } y después reinicia Claude Desktop. Consulta Connect to local MCP servers.

Cualquier otro cliente stdioCopiar enlace a esta sección

Dale al cliente el comando npx -y @verbatra/mcp, más --cwd /path/to/your/project salvo que arranque los servidores dentro del proyecto, y --config <path> si la configuración está en otro sitio. Añade --allow-spend y la clave solo mediante el mecanismo de secretos del propio cliente.