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.
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/accountDespué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/accountEl 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.urlmacOS 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.urlClaude 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
| Herramienta | Qué hace | Cuota |
|---|---|---|
check_sql | Evalúa SQL contra las reglas del workspace y devuelve un veredicto por statement. | 1 check por statement evaluado, con sql o con queries |
whoami | Plan, checks restantes del mes, versión del ruleset y las bases del workspace con su dialecto. | Gratis |
list_rules | Catálogo efectivo de reglas (estándar y personalizadas) con la acción resuelta. | Gratis |
show_rule | Detalle de una regla por código, incluida la condición AST que evalúa. | Gratis |
list_reports | Los checks hechos con esta misma API key, del más reciente al más antiguo. | Gratis |
show_report | El 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 unlineopcional. 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
| Plan | Checks por mes (CLI, API de validación y MCP) |
|---|---|
| Free | 1.000 |
| Builder | 10.000 |
| Team | Ilimitados |
| Enterprise | Ilimitados |
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:executeno 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/accounty luego/mcp→ autenticar. - Cursor: en
~/.cursor/mcp.json, la entradavericto-accountcon 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.
| Herramienta | Permiso | Qué hace |
|---|---|---|
setup_status | setup:read | Qué 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_proxy | proxy:read | El estado de cada proxy TCP (sano, en silencio, con retraso, perdiendo telemetría), su versión y qué revisar. |
explain_block | events:read | Por qué un evento o un check se bloqueó o solo se marcó: la regla, su condición y el modo del workspace. |
search_docs | docs:read | Busca en esta documentación. Toda conexión tiene este permiso. |
get_config | config:read | La 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_ticket | tickets:write | Abre un ticket de soporte en tu nombre. Solo si la conexión tiene el permiso tickets:write. |
plan_config_change | config:read | Paso 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_change | config:write | Paso 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_status | config:write | Lee el resultado de un cambio enviado a aprobación: pendiente, aplicado, rechazado, vencido o no aplicado. |
check_sql | sql:check | Comprueba 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_rule | ruleset:read | Las reglas del workspace y el detalle de una, con su condición. |
list_reports, show_report | reports:read | Los 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. |
whoami | setup:read | El 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:writepideconfig:read) ydocs:readva siempre. Por defecto, una conexión nueva solo lee. - Un viewer solo puede tener permisos de lectura;
tickets:writepide member o superior, yconfig: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_changey solo después de tu OK explícito llama aapply_config_change. Elplan_idvence 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 pideconfig:ready aplicar pideconfig: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/mcpcon 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.
| Plataforma | Archivo |
|---|---|
| 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 silicon | vericto-proxy-aarch64-apple-darwin.tar.xz |
| macOS Intel | vericto-proxy-x86_64-apple-darwin.tar.xz |
| Windows x86_64 | vericto-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íntoma | Causa | Qué hacer |
|---|---|---|
401 | Falta 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. |
403 | La key no tiene el scope ci_dryrun:execute. | Crea una key con ese scope. |
Rate limited | Demasiadas llamadas en poco tiempo. | Espera los segundos que indica el mensaje. |
Monthly CI-check allowance used up | Se agotó la cuota del mes. | Espera al mes siguiente o sube de plan. Las herramientas de solo lectura siguen funcionando. |
Not enough CI checks left | La 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_ERROR | Casi siempre, el dialecto equivocado. | Pasa el dialect correcto; whoami lo muestra por base. |