Agentes de IA (MCP).

Conecta tu agente de código a Vericto con el Model Context Protocol para que valide cada migración y query contra las reglas de tu workspace mientras la escribe, antes de que exista un commit.

MCP: resumen del producto →

Resumen

Vericto expone un servidor MCP remoto en https://mcp.vericto.com/mcp. Un agente conectado (Claude Code u otro cliente MCP compatible) llama a check_sql mientras genera SQL y recibe el mismo veredicto que el CLI o la API: BLOCKED, FLAGGED, MONITORED o ALLOWED, con la regla que se disparó y una corrección sugerida.

Es el punto más temprano del ciclo: el CLI valida antes de mergear y el proxy TCP bloquea en producción; MCP valida mientras el código todavía se está escribiendo. Los tres usan el mismo motor AST determinístico y las mismas reglas de tu workspace.

No hay nada que instalar. El servidor es remoto (Streamable HTTP) y se autentica con una API key de tu workspace en el header Authorization.

Instalar con un clic

Elige el servidor y tu cliente: los botones abren Cursor o VS Code con la configuración lista, y para Claude basta con copiar un comando o una URL. Iniciar sesión (OAuth) es la opción de un clic: con API key o en local, además necesitas una key o la URL de tu base.

La forma más rápida para una persona: un clic, inicias sesión en el navegador y apruebas, sin key que copiar.

El servidor vericto-account en https://mcp.vericto.com/mcp/account, sin API key. La primera vez, el cliente abre Vericto en el navegador: inicias sesión, eliges el workspace y apruebas los permisos. Para usar check_sql, marca sql:check en la pantalla de aprobación (gasta los checks del mes). Actúa como tú, con tu rol.

Claude Code

claude mcp add --scope user --transport http vericto-account https://mcp.vericto.com/mcp/account

Después, en una sesión, ejecuta /mcp y elige autenticar.

Claude Desktop · claude.ai

En Customize → Connectors → Add custom connector, pega esta URL y, en Authentication, elige Sign in now. En Team y Enterprise, un owner lo agrega en Organization settings → Connectors y cada persona se conecta con su cuenta.

https://mcp.vericto.com/mcp/account

El servidor vericto en https://mcp.vericto.com/mcp, pensado para agentes y CI. Crea una API key con solo el scope ci_dryrun:execute. Cursor abre la ventana Install MCP server? con la configuración completa. El header Authorization dice Bearer ${env:VERICTO_API_KEY}: déjalo así si VERICTO_API_KEY está definida en tu entorno (reinicia Cursor después de definirla), o reemplázalo por Bearer seguido de tu key. En ese caso, Cursor guarda la key en texto plano en ~/.cursor/mcp.json, por eso debe tener solo el scope ci_dryrun:execute. VS Code te pide la key una vez y la guarda cifrada.

Claude Code

claude mcp add --scope user --transport http vericto https://mcp.vericto.com/mcp \
  --header 'Authorization: Bearer ${VERICTO_API_KEY}'

Claude Desktop · claude.ai

En Customize → Connectors → Add custom connector, usa la URL https://mcp.vericto.com/mcp y, en Authentication, No sign-in. En Request headers, agrega Authorization con el valor Bearer seguido de tu key: Claude lo guarda en el conector, no en un archivo. Si no ves Request headers, usa la pestaña de OAuth o el puente mcp-remote de la configuración por cliente.

El servidor vericto-db: vericto-proxy mcp corre en Docker en tu equipo, con las reglas integradas y sin cuenta. Se conecta a tu PostgreSQL y le da al agente execute_sql, describe_schema, check_sql y whoami, nunca la credencial de la base. Los enlaces usan la imagen vericto/vericto-proxy:5.0.0.

Antes, una sola vez: crea un rol de solo lectura (el SQL está en la documentación) y guarda la URL de conexión en ~/.config/vericto/db.url, con permisos 600:

mkdir -p ~/.config/vericto && chmod 700 ~/.config/vericto
printf '%s' 'postgres://vericto_agent_ro:…@db.example.com:5432/shop?sslmode=verify-full' > ~/.config/vericto/db.url
chmod 600 ~/.config/vericto/db.url

macOS y Windows (Docker Desktop)

Linux

En Linux, Docker necesita --user con tu uid:gid para leer el archivo. VS Code te lo pide; el enlace de Cursor usa 1000:1000: si id -u o id -g dan otro valor, cámbialo en ~/.cursor/mcp.json.

Claude Code

En macOS y Linux; el shell completa tu uid:gid:

claude mcp add --scope user vericto-db -- \
  docker run -i --rm --user "$(id -u):$(id -g)" \
    -v ~/.config/vericto/db.url:/run/secrets/db.url:ro \
    vericto/vericto-proxy:5.0.0 /usr/local/bin/vericto-proxy mcp --database-url-file /run/secrets/db.url

Claude Desktop

En Settings → Developer → Edit Config, agrega el servidor a claude_desktop_config.json con la ruta absoluta de tu home en lugar de /Users/me (sin ~) y reinicia Claude Desktop.

{
  "mcpServers": {
    "vericto-db": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
               "-v", "/Users/me/.config/vericto/db.url:/run/secrets/db.url:ro",
               "vericto/vericto-proxy:5.0.0", "/usr/local/bin/vericto-proxy", "mcp",
               "--database-url-file", "/run/secrets/db.url"]
    }
  }
}

Cursor y VS Code muestran la configuración y te piden confirmar antes de agregar el servidor. Para otros clientes, sigue la configuración manual de abajo.

Configuración

1. Crea una API key

En Dashboard → API Keys → New API key, crea una key solo con el scope ci_dryrun:execute (el mismo que usa el CLI) y, si quieres, una fecha de expiración. Cópiala: se muestra una sola vez. Guárdala en una variable de entorno, no en un archivo del repositorio:

# ~/.zshrc or ~/.bashrc
export VERICTO_API_KEY="vtro_..."

2. Conecta tu cliente

claude mcp add --scope user --transport http vericto https://mcp.vericto.com/mcp \
  --header 'Authorization: Bearer ${VERICTO_API_KEY}'

Las comillas simples dejan ${VERICTO_API_KEY} sin expandir: la configuración guarda la referencia y Claude Code la resuelve al arrancar, así que la key nunca queda escrita en ~/.claude.json. Abre una sesión nueva y ejecuta /mcp: vericto debe aparecer conectado con 6 herramientas.

Probado con Claude Code.

No pegues la API key en archivos que se commitean, como un .mcp.json del proyecto. Usa la referencia a variables de entorno que ofrezca tu cliente.

Herramientas

HerramientaQué haceCuota
check_sqlEvalúa SQL contra las reglas del workspace y devuelve un veredicto por statement.1 check por statement evaluado, con sql o con queries
whoamiPlan, checks restantes del mes, versión del ruleset y las bases del workspace con su dialecto.Gratis
list_rulesCatálogo efectivo de reglas (estándar y personalizadas) con la acción resuelta.Gratis
show_ruleDetalle de una regla por código, incluida la condición AST que evalúa.Gratis
list_reportsLos checks hechos con esta misma API key, del más reciente al más antiguo.Gratis
show_reportEl resultado completo de un check anterior de esta API key, query por query.Gratis

Al conectarse, el servidor envía instrucciones de uso, así que el agente sabe cuándo llamar a cada herramienta sin que tengas que explicárselo.

Cómo funciona check_sql

Acepta una de dos entradas:

  • sql: el script completo, por ejemplo un archivo de migración. Vericto lo divide en statements y reporta cada uno con la línea donde empieza. Cuesta un check por statement, igual que ese archivo con el CLI.
  • queries: statements ya separados, cada uno con un line opcional. Cuesta un check por statement.

Pasa siempre el dialect de la base a la que apunta el SQL: postgres (por defecto), mysql, oracle, mssql, snowflake o sqlite. whoami lista las bases del workspace con su dialecto.

La respuesta es compacta: un resumen y, por cada statement que no sea ALLOWED, su línea, estado, regla, severidad y la corrección sugerida. Con verbose: true devuelve el resultado completo del CLI.

Cada respuesta termina con los siguientes pasos, en el texto y como next_action y next_steps en el resultado estructurado (cada hallazgo trae también su next_action): apply_fix_and_recheck, do_not_run (llamar a show_rule o preguntar al usuario), request_access, fix_and_recheck (errores de parseo: corregir la sintaxis o el dialecto), run_approved_query, mention_to_user, run_as_written o stop (kill switch). Solo nombran herramientas que la conexión puede llamar; en /mcp/account, si falta una, nombran el scope que hay que otorgar. El agente debe seguirlos en lugar de reformular un statement bloqueado y volver a revisarlo. whoami, show_rule, list_reports, show_report y explain_block también agregan un next_step breve.

DDL. check_sql aplica la acción completa de tu workspace también al esquema y DDL (VERICTO-010 a 019): un DROP TABLE o un TRUNCATE sale BLOCKED según la severidad de la regla, como en la API de runtime, los SDKs y el proxy TCP, en /mcp y en /mcp/account. Solo la CLI, la API de validación y el dry-run del dashboard, que revisan migraciones en CI, lo limitan a FLAGGED (schema_migration_cap).

Columnas sensibles. Pasa el database_id de la base (lo lista whoami) para que se apliquen sus columnas sensibles; sin él se aplican las de todas las bases del workspace, con la política más estricta por columna. Si un hallazgo trae approved_query, la query lee una columna enmascarada: esa es la única query aprobada y el agente debe ejecutarla en lugar de la original. MCP no puede obligarlo; solo el proxy TCP aplica el enmascaramiento.

BLOCKED: 1 of 3 statements must not ship as written.
- line 4 BLOCKED VERICTO-001 (critical): DELETE FROM users Fix: DELETE FROM users WHERE id = $1
Next:
- line 4 (VERICTO-001): do not run it as written; apply the suggested fix, then call check_sql again with the corrected SQL.
- lines 2, 5: safe to run as written under ruleset v1.0.0-3f2a9c1b7d4e; no need to call check_sql again while ruleset_version stays v1.0.0-3f2a9c1b7d4e.
Ruleset v1.0.0-3f2a9c1b7d4e · 999 checks left this month

Si el script tiene cuerpos procedurales (CREATE PROCEDURE … BEGIN … END, BEGIN ATOMIC o DELIMITER de MySQL), Vericto no lo divide: lo evalúa como una sola unidad, igual que el CLI con un archivo, reporta su hallazgo más grave y cuenta un check.

El ruleset_version de la respuesta cambia solo cuando cambia una regla o una columna sensible del workspace. Mientras coincida con el de whoami (que corresponde a un check sin database_id), un veredicto anterior sigue siendo válido.

Cada llamada queda en el historial de checks del workspace (Dashboard → Validaciones SQL; list_reports muestra solo los de la misma API key), con un extracto de hasta 100 caracteres de cada statement.

Cuota y límites

PlanChecks por mes (CLI, API de validación y MCP)
Free1.000
Builder10.000
TeamIlimitados
EnterpriseIlimitados

La cuota mensual es compartida entre el CLI, la API de validación y MCP, y cada statement evaluado cuenta como un check. Si una llamada necesita más checks de los que quedan, se rechaza entera, sin evaluar nada, y el mensaje indica cuántos quedan: divide el script o espera al mes siguiente. Las herramientas de solo lectura no consumen la cuota.

Además hay un límite de ritmo por API key, en todos los planes: 30 llamadas a check_sql por minuto y 300 por hora, y 60 por minuto a las herramientas de solo lectura. Si se supera, la herramienta responde con cuántos segundos esperar.

Seguridad

  • La API key determina el workspace. El agente no puede elegir ni ver otro.
  • Una key con solo ci_dryrun:execute no puede leer el audit trail ni cambiar reglas: quien la obtenga, a lo sumo, gasta tu cuota de checks.
  • Vericto solo analiza el texto del SQL. No se conecta a tu base de datos ni ejecuta nada.
  • Si revocas la key en Dashboard → API Keys, el agente pierde el acceso de inmediato.

MCP de soporte (vericto-account)

Además del servidor de runtime, hay un servidor para tu cuenta: tu agente de código revisa la configuración del workspace, diagnostica el proxy, explica por qué se bloqueó una query, busca en la documentación y, para ti, también comprueba SQL y lee las reglas y los reportes de CI. Es el mismo servidor en otra ruta, /mcp/account, y usa otra credencial: una conexión MCP tuya, ligada a tu usuario y a tu rol, que apruebas con OAuth o creas como clave en Dashboard → Conexiones MCP.

Conectar con OAuth

Si tu cliente soporta OAuth para servidores MCP remotos, agrega solo la URL https://mcp.vericto.com/mcp/account, sin cabecera Authorization. La primera vez que se conecta, el cliente abre Vericto en el navegador: inicias sesión, eliges el workspace y apruebas lo que puede hacer. No hay ninguna clave que copiar.

  • Claude (claude.ai y Claude Desktop): Customize → Connectors → Add custom connector, con esa URL y Authentication en Sign in now. En Claude Code: claude mcp add --scope user --transport http vericto-account https://mcp.vericto.com/mcp/account y luego /mcp → autenticar.
  • Cursor: en ~/.cursor/mcp.json, la entrada vericto-account con solo "url"; Cursor abre el navegador para aprobarla.
  • ChatGPT: en chatgpt.com/plugins, + → Add custom MCP server, con esa URL y OAuth como autenticación. Otros clientes con OAuth: agrega el servidor por su URL y elige OAuth. Vericto admite Client ID Metadata Documents y el registro dinámico de clientes.
  • Cursor y VS Code, con un clic:
  • La pantalla de aprobación muestra tu usuario, el nombre del cliente marcado como no verificado (Vericto no revisa los clientes: apruébalo solo si acabas de iniciar la conexión), adónde vuelves, el workspace y los permisos. La primera aprobación muestra todas las áreas que se pueden aprobar por OAuth: lectura, ejecución (comprobar SQL, sql:check) y escritura. Solo la lectura viene marcada; la ejecución y la escritura se otorgan solo si las marcas tú, y solo lo que tu rol permite (lo demás aparece desactivado con el motivo). Se otorga exactamente lo que marcas. Los permisos de escritura (tickets:write, config:write) todavía no se pueden aprobar por OAuth en vericto.com: para abrir tickets o cambiar la configuración desde un agente, usa una clave de conexión.
  • Si el agente necesita un permiso que no aprobaste, el servidor responde insufficient_scope; los clientes que admiten pedir más permisos después (step-up) te vuelven a pedir la aprobación con ese permiso. Los que no (Cursor solo renueva el token) siguen sin él: vuelve a conectar el servidor y márcalo en la pantalla de aprobación. La conexión aparece en Dashboard → Conexiones MCP con el nombre del cliente; vence como una clave (30 días, 90 como máximo, renovable) y al revocarla se cortan al instante sus tokens.

Si tu cliente no soporta OAuth, o es una automatización tuya, usa una clave: créala en Dashboard → Conexiones MCP, guárdala en la variable de entorno VERICTO_ACCOUNT_KEY y agrega el servidor junto al de runtime en tu cliente:

claude mcp add --scope user --transport http vericto-account https://mcp.vericto.com/mcp/account \
  --header 'Authorization: Bearer ${VERICTO_ACCOUNT_KEY}'

Igual que con el de runtime, las comillas simples guardan la referencia y no la clave. En /mcp, vericto-account debe aparecer conectado con sus herramientas.

HerramientaPermisoQué hace
setup_statussetup:readQué ya está configurado y qué falta: bases de datos, modos de conexión vistos, salud del proxy, modo observación y próximos pasos.
diagnose_proxyproxy:readEl estado de cada proxy TCP (sano, en silencio, con retraso, perdiendo telemetría), su versión y qué revisar.
explain_blockevents:readPor qué un evento o un check se bloqueó o solo se marcó: la regla, su condición y el modo del workspace.
search_docsdocs:readBusca en esta documentación. Toda conexión tiene este permiso.
get_configconfig:readLa configuración actual: modo de enforcement, reglas, bases de datos con sus columnas sensibles y canales de alerta (tipo y nombre, nunca su URL).
open_support_tickettickets:writeAbre un ticket de soporte en tu nombre. Solo si la conexión tiene el permiso tickets:write.
plan_config_changeconfig:readPaso 1 de 2: planifica uno o más cambios que suman protección y devuelve el diff y un plan_id. No cambia nada, por eso pide solo config:read; aplicar el plan pide config:write.
apply_config_changeconfig:writePaso 2 de 2: aplica ese plan, completo o nada, solo si la configuración no cambió desde que se planificó. Con una clave, no lo aplica: te envía el plan para que lo apruebes en el dashboard.
config_approval_statusconfig:writeLee el resultado de un cambio enviado a aprobación: pendiente, aplicado, rechazado, vencido o no aplicado.
check_sqlsql:checkComprueba SQL contra las reglas del workspace antes de ejecutarlo, como en el servidor de runtime. Gasta las comprobaciones de CI mensuales del workspace y guarda el reporte con tu conexión, así que no viene marcado por defecto.
list_rules, show_ruleruleset:readLas reglas del workspace y el detalle de una, con su condición.
list_reports, show_reportreports:readLos reportes de CI del workspace (de la CLI, los pipelines, la API y los agentes), como los ve tu rol: un viewer recibe el hash de cada sentencia en lugar del SQL.
whoamisetup:readEl plan, las comprobaciones de CI que quedan este mes, la versión del ruleset y las bases de datos con su dialecto.
  • Eliges los permisos uno a uno, agrupados por área, con lectura y escritura por separado; la escritura incluye su lectura (config:write pide config:read) y docs:read va siempre. Por defecto, una conexión nueva solo lee.
  • Un viewer solo puede tener permisos de lectura; tickets:write pide member o superior, y config:write, admin u owner. Se comprueba con tu rol actual en cada llamada, y si falta un permiso la herramienta dice cuál.
  • Cambiar la configuración son dos pasos: tu agente te muestra el diff de plan_config_change y solo después de tu OK explícito llama a apply_config_change. El plan_id vence a los 10 minutos, se usa una sola vez y solo desde la conexión que lo creó. Con una clave, el cambio no se aplica hasta que lo apruebas tú en el dashboard (te llega por email, con el diff; vence a las 24 horas): una clave copiada en un agente autónomo no puede cambiar la configuración sin ti. Planificar pide config:read y aplicar pide config:write. Por OAuth todavía no se puede aprobar el permiso de escritura: un agente conectado por OAuth puede planificar un cambio y mostrarte el diff, pero para aplicarlo usa una clave de conexión o haz el cambio en el dashboard.
  • Solo se pueden hacer cambios que suman protección: agregar una base de datos (dentro de tu plan) o un canal de alertas por email, reactivar un canal de email pausado, activar una regla o subir su severidad, pasar a enforce, bloquear el SQL que no se puede analizar, sanear la telemetría y marcar columnas sensibles.
  • Lo que quita o debilita protección se rechaza con un enlace a la página del dashboard que lo hace: pasar a observación o monitor, desactivar una regla o bajar su severidad, quitar o cambiar columnas sensibles, apagar o borrar canales de alerta, borrar bases de datos y crear, rotar o revocar claves. También los canales con una URL de destino (Slack, Teams, webhook, PagerDuty), para agregarlos o reactivarlos: un agente podría desviar las alertas a un destino que controla. Así, un agente manipulado con prompt injection no puede apagar los guardrails.
  • Devuelve lo que tu rol ve en el dashboard: un viewer recibe los metadatos de un evento, sin el SQL. El SQL que devuelve siempre va saneado, sin literales.
  • Una API key de runtime no ve estas herramientas y no sirve en /mcp/account: los agentes y servicios autónomos usan /mcp con una API key. Tu conexión, en cambio, también ve las herramientas de runtime, con sus permisos propios.
  • Vence a los 30 días (90 como máximo): te avisamos por email 7 y 2 días antes, y el dashboard lo muestra desde 7 días antes. Se revoca en la misma página, deja de funcionar si sales del workspace, y cada llamada queda en el registro de auditoría, a tu nombre y al de la conexión, también cada plan y cada cambio aplicado.
  • Renovar la extiende 30 o 90 días (nunca más de 90 desde hoy) con la misma clave, así que tu cliente sigue funcionando sin cambios. Se puede renovar hasta 30 días después de vencer; pasado ese plazo, creas una conexión nueva. Al renovar se vuelven a comprobar tus permisos con tu rol actual: si ya no puede tener alguno, puedes renovar sin él. Rotar es distinto: genera una clave nueva y tienes que actualizar tu cliente.

Desactivar todas las conexiones de soporte

Un owner o admin puede bloquear de una vez todas las conexiones MCP de soporte del workspace en Dashboard → Ajustes → Conexiones MCP de soporte (Permitir conexiones MCP de soporte, activado por defecto). Mientras está desactivado, cada llamada a /mcp/account se rechaza antes de ejecutar ninguna herramienta, con un mensaje que dice dónde volver a activarlo, y no se pueden crear, renovar, rotar ni ampliar conexiones ni aprobar o renovar las de OAuth. Las conexiones no se revocan: al volver a activarlo funcionan de nuevo, salvo las que vencieron. El cambio queda en el registro de auditoría, y el MCP de runtime (/mcp) no se ve afectado.

Solo OAuth

En el mismo lugar, Solo OAuth en /mcp/account (desactivado por defecto) rechaza las claves de conexión en cada llamada y no deja crearlas, renovarlas ni rotarlas; las conexiones OAuth siguen funcionando. Las claves se conservan y vuelven a funcionar al desactivarlo. Solo se puede activar cuando OAuth está disponible, para que nadie quede fuera.

Servidor local (vericto-db)

vericto-proxy mcp es un servidor MCP que corre en tu equipo, en Docker o como binario nativo, y se conecta a una base PostgreSQL: el agente recibe execute_sql, describe_schema, check_sql y whoami, y nunca la credencial de la base. Usa las reglas integradas del proxy, así que no necesita cuenta. A diferencia de /mcp, este servidor sí ejecuta SQL en tu base: dale un rol de solo lectura.

1. Crea un rol de solo lectura

CREATE ROLE vericto_agent_ro LOGIN PASSWORD '…';
GRANT CONNECT ON DATABASE shop TO vericto_agent_ro;
GRANT USAGE ON SCHEMA public TO vericto_agent_ro;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO vericto_agent_ro;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO vericto_agent_ro;

2. Guarda la URL de conexión en un archivo

mkdir -p ~/.config/vericto && chmod 700 ~/.config/vericto
printf '%s' 'postgres://vericto_agent_ro:…@db.example.com:5432/shop?sslmode=verify-full' > ~/.config/vericto/db.url
chmod 600 ~/.config/vericto/db.url

Los botones y los comandos montan ese archivo, de solo lectura, en /run/secrets/db.url y lo pasan con --database-url-file: la URL no aparece en la configuración del cliente ni en los argumentos de Docker.

3. Agrega el servidor

Usa la pestaña Local, sin cuenta de Instalar con un clic: botones para Cursor y VS Code, el comando de Claude Code y la configuración de Claude Desktop. En macOS y Windows, Docker Desktop lee el archivo sin más. En Linux, Docker necesita --user con tu uid:gid para leer un archivo con permisos 600: el comando de Claude Code lo calcula con $(id -u):$(id -g), VS Code te lo pide y el enlace de Cursor usa 1000:1000 (cámbialo en ~/.cursor/mcp.json si tu uid:gid es otro).

Que el agente no lea el archivo por su cuenta: en Claude Code, niega esas herramientas en ~/.claude/settings.json.

"permissions": { "deny": ["Read(~/.config/vericto/**)", "Bash(psql:*)", "Bash(cat ~/.config/vericto/*)"] }

4. Sin Docker: el binario nativo

Desde la 5.0.1, cada release de vericto-proxy trae binarios nativos, así que no hacen falta Docker ni Rust. El mismo binario corre el proxy TCP y vericto-proxy mcp, y una base en localhost se alcanza directamente.

PlataformaArchivo
Linux x86_64 (glibc 2.35 o posterior)vericto-proxy-x86_64-unknown-linux-gnu.tar.xz
Linux aarch64 (glibc 2.35 o posterior)vericto-proxy-aarch64-unknown-linux-gnu.tar.xz
macOS Apple siliconvericto-proxy-aarch64-apple-darwin.tar.xz
macOS Intelvericto-proxy-x86_64-apple-darwin.tar.xz
Windows x86_64vericto-proxy-x86_64-pc-windows-msvc.zip

En Linux y macOS, el instalador elige el archivo de tu máquina, verifica su SHA-256 y pone vericto-proxy en ~/.cargo/bin ($CARGO_HOME/bin), y agrega ese directorio al PATH en tu perfil del shell si hace falta:

curl --proto '=https' --tlsv1.2 -LsSf \
  https://github.com/vericto/vericto-proxy/releases/download/v5.0.1/vericto-proxy-installer.sh | sh
vericto-proxy mcp --version

O descarga un archivo tú mismo. Cada uno tiene un .sha256 al lado (sha256.sum los lista todos) y una atestación de build (Sigstore) que lo liga al repositorio, al workflow de release y al commit:

v=5.0.1 t=x86_64-unknown-linux-gnu   # or another archive from the table
base=https://github.com/vericto/vericto-proxy/releases/download/v$v
curl -fL -O "$base/vericto-proxy-$t.tar.xz" -O "$base/vericto-proxy-$t.tar.xz.sha256"
shasum -a 256 -c "vericto-proxy-$t.tar.xz.sha256"
gh attestation verify "vericto-proxy-$t.tar.xz" --repo vericto/vericto-proxy
tar -xJf "vericto-proxy-$t.tar.xz"   # vericto-proxy-$t/vericto-proxy

En Windows x86_64 no hay instalador: verifica el .zip contra su .sha256 en PowerShell y descomprímelo. Trae vericto-proxy.exe:

$v = "5.0.1"; $zip = "vericto-proxy-x86_64-pc-windows-msvc.zip"
$base = "https://github.com/vericto/vericto-proxy/releases/download/v$v"
Invoke-WebRequest "$base/$zip" -OutFile $zip
Invoke-WebRequest "$base/$zip.sha256" -OutFile "$zip.sha256"
if ((Get-FileHash $zip -Algorithm SHA256).Hash -ne (Get-Content "$zip.sha256").Split(" ")[0]) { throw "SHA-256 mismatch" }
Expand-Archive $zip -DestinationPath "$env:LOCALAPPDATA\Programs\vericto-proxy"

Después registra el servidor con la ruta del binario; ninguna variable VERICTO_* definida es lo que lo hace local. Claude Code:

claude mcp add vericto-db -- ~/.cargo/bin/vericto-proxy \
  mcp --database-url-file ~/.config/vericto/db.url

Cursor (.cursor/mcp.json) o cualquier cliente que acepte un comando, con rutas absolutas en lugar de /Users/me:

{
  "mcpServers": {
    "vericto-db": {
      "command": "/Users/me/.cargo/bin/vericto-proxy",
      "args": ["mcp", "--database-url-file", "/Users/me/.config/vericto/db.url"]
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.vericto-db]
command = "/Users/me/.cargo/bin/vericto-proxy"
args = ["mcp", "--database-url-file", "/Users/me/.config/vericto/db.url"]

Docker sigue siendo una opción: la pestaña Local, sin cuenta usa la imagen. Desde dentro del contenedor, una base en tu máquina es host.docker.internal, que no es loopback; con el binario nativo, localhost funciona tal cual. En modo stdio, stdout lleva solo mensajes del protocolo y los logs van a stderr. Sin cuenta, el servidor usa las reglas integradas y no reporta nada: ver Modo offline.

Solución de problemas

SíntomaCausaQué hacer
401Falta el header Authorization, o la variable de entorno está vacía.Verifica que VERICTO_API_KEY esté exportada en el shell desde el que abres el cliente, y abre una sesión nueva.
403La key no tiene el scope ci_dryrun:execute.Crea una key con ese scope.
Rate limitedDemasiadas llamadas en poco tiempo.Espera los segundos que indica el mensaje.
Monthly CI-check allowance used upSe agotó la cuota del mes.Espera al mes siguiente o sube de plan. Las herramientas de solo lectura siguen funcionando.
Not enough CI checks leftLa llamada tiene más statements que checks restantes este mes. No se evaluó nada.Envía como máximo los statements que indica el mensaje, o sube de plan.
PARSE_ERRORCasi siempre, el dialecto equivocado.Pasa el dialect correcto; whoami lo muestra por base.