verbatra mcp

Arranca un servidor Model Context Protocol por stdio: el transporte estándar de proceso local que usan los clientes MCP (Claude Desktop, Claude Code, Cursor y otros) para lanzar un servidor de herramientas y hablar con él. Le da a un agente alojado en terminal o headless las mismas capacidades de estado de traducción, glosario y edición que exponen las herramientas de agente del navegador de Studio, sin navegador, puerto ni una aplicación de una sola página servida.

Sinopsis

verbatra mcp [flags]

@verbatra/mcp también incluye su propio binario, así que un cliente MCP puede lanzarlo directamente sin pasar por la CLI de verbatra:

verbatra-mcp [flags]

Ambas formas aceptan los mismos flags y arrancan el mismo servidor.

Flags

Cuando falta --allow-spend, el servidor lee en su lugar la variable de entorno VERBATRA_MCP_ALLOW_SPEND: 1, true, yes u on (sin distinguir mayúsculas) cuenta como encendido. El flag de la CLI siempre gana sobre la variable de entorno. Sin ninguno de los dos, translation.retranslateEntry y translation.translatePending no se exponen en absoluto: un cliente MCP que liste las herramientas nunca las ve, y llamarlas por nombre falla como herramienta desconocida. Esta es una garantía por proceso, no una comprobación por llamada, así que una herramienta bloqueada por gasto es estructuralmente imposible de llamar, no simplemente rechazada en el momento de la llamada.

Configurar un cliente MCP

Apunta tu cliente MCP al binario verbatra-mcp. Para Claude Desktop, añade esto a tu claude_desktop_config.json:

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

Omite por completo el bloque env y su --allow-spend para un servidor solo de lectura y edición local: project.snapshot, las herramientas de estado y glosario, y translation.editEntry nunca llaman a un proveedor ni necesitan una clave. Añade --allow-spend al array args en cuanto también quieras translation.retranslateEntry y translation.translatePending disponibles, y define la variable de entorno de la clave API que lee tu proveedor configurado (consulta Proveedores).

Si ya invocas todo a través de la CLI de verbatra, ejecútalo como subcomando en su lugar:

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

Herramientas

translation.retranslateEntry y translation.translatePending solo se exponen cuando el servidor se inició con --allow-spend. El input de cada herramienta, y el output de cada herramienta cuya forma de resultado es pequeña y cerrada, es un JSON Schema derivado del mismo esquema zod contra el que el servidor valida la llamada. Llamar a un nombre de herramienta desconocido es un error a nivel de protocolo; llamar a una herramienta conocida con un input que falla la validación devuelve un resultado que nombra el campo problemático, así un agente puede leer el fallo y autocorregirse.

Redacción de secretos

Cada resultado de herramienta y cada línea de log pasa por la misma redacción de secretos que usa Studio: un valor con forma de clave API de proveedor, o el valor exacto actual de una variable de entorno de proveedor configurada, se reemplaza por [REDACTED] antes de llegar siquiera al cliente o a stderr. glossary.get y glossary.write también informan qué términos se redactaron, así puedes distinguir un marcador de posición depurado del texto real y nunca reescribirlo.

stdout es el canal del protocolo

El transporte stdio de MCP usa stdout exclusivamente para mensajes de protocolo. verbatra mcp y verbatra-mcp nunca imprimen un banner, una línea de log ni nada más en stdout; todo log y diagnóstico va a stderr en su lugar. No se imprime nada hasta que un cliente MCP envía el primer mensaje.

Instalación

@verbatra/mcp es su propio paquete, cargado mediante un import dinámico para que el resto de la CLI funcione sin él. Si no está instalado, verbatra mcp sale con 2:

Verbatra's MCP server requires @verbatra/mcp. Install it with: pnpm add -D @verbatra/mcp

Ejecutar verbatra-mcp directamente no necesita la CLI en absoluto: instala @verbatra/mcp por su cuenta, o deja que npx lo obtenga bajo demanda como se muestra arriba.

Ejemplos

# arranca el servidor MCP solo con herramientas locales, sin gasto
verbatra mcp

# expone además las herramientas que llaman al proveedor
verbatra mcp --allow-spend

# resuelve un proyecto fuera del directorio actual
verbatra mcp --cwd /path/to/project --config verbatra.config.ts

Códigos de salida

Relacionado

• verbatra studio y Opera Studio con un agente del navegador cubren la superficie de agente basada en navegador que este servidor complementa.
• Proveedores documenta de qué variable de entorno lee cada proveedor su clave API.
• verbatra check y verbatra diff son los mismos cálculos que exponen status.check y status.diff.