Respuesta corta: a un agente de IA le puedes dar una URL de conexión, un rol de solo lectura, un servidor MCP de base de datos, un proxy que revisa cada sentencia o una herramienta que revisa el SQL antes de ejecutarlo. Para todo lo que toque producción, no le des una credencial propia de la base: que llegue a los datos con un rol de solo lectura detrás de un proxy o un servidor MCP que evalúe cada sentencia, y mantén la credencial directa fuera de su entorno.
Las cinco formas de un vistazo
Las mismas cinco opciones sirven para agentes de programación (Claude Code, Cursor, Codex) y para agentes que construyes con LangChain o el OpenAI Agents SDK. Cambia quién tiene la credencial y quién revisa el SQL.
| Forma | Quién tiene la credencial | Quién revisa el SQL |
|---|---|---|
| 1. URL de conexión directa | El agente | Nadie |
| 2. Rol de solo lectura | El agente | Los privilegios de la base |
| 3. Un servidor MCP de base de datos | El servidor MCP | Lo que ese servidor implemente |
4. El proxy de Vericto o vericto-proxy mcp | El proxy | Las reglas de Vericto, sobre el AST de cada sentencia, antes de que la base la vea |
5. El servidor MCP de runtime y check_sql | Tu propia herramienta (Vericto nunca se conecta) | Vericto devuelve un veredicto; el agente o tu herramienta actúan según él |
Se combinan: un rol de solo lectura conviene debajo de cualquiera de las otras opciones.
1. Una URL de conexión directa
Cuándo usarla
Una base local o descartable, sin nada que vayas a extrañar: un contenedor de Docker, una base de desarrollo con datos de prueba, una rama que puedes recrear.
Configuración
El agente lee una URL del entorno, de un archivo .env o de la configuración de su herramienta, y ejecuta SQL con psql, un driver, el wrapper de base de datos SQL de LangChain o una function tool que registras en el OpenAI Agents SDK.
Qué puede salir mal
- El agente tiene todos los privilegios de ese usuario. Si la URL es del rol dueño, un
DELETEsinWHERE, unDROP TABLEo un reset del esquema se ejecutan tal cual. - Todo lo que está en el entorno se puede leer. Un agente de programación puede leer el
.envy las variables de la shell, y usar esa credencial desde cualquier herramienta, no solo desde la que pensabas. - Las filas son texto que lee el modelo. Un valor guardado en una tabla puede traer instrucciones; con permisos de escritura, una instrucción inyectada puede terminar en una escritura.
Hay desarrolladores que reportaron agentes que ejecutaron sentencias destructivas contra producción: mira un agente de IA borró la base de producción, Claude Code y Codex.
Esta es la sentencia que las páginas de reglas llaman VERICTO-001, y lo que la CLI de Vericto reporta para ella:
-- cleanup.sql
DELETE FROM users;$ npx @vericto/vericto-cli@2.3.0 check --offline cleanup.sql
note: offline mode: 42 standard rules at default severities, engine 5.1.0. Custom rules, overrides, sensitive columns, allowlists and the audit trail apply online only.
✖ cleanup.sql BLOCKED VERICTO-001 critical
DeleteStmt > WhereClause = NULL
fix: DELETE FROM users WHERE id = $1
1 blocked · 0 allowed · 0 flagged · 0 monitored (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))
✖ Vericto blocked 1 statement (ruleset standard@engine-5.1.0 · mode: offline (engine 5.1.0, 42 standard rules, no workspace policy))
✖ cleanup.sql BLOCKED VERICTO-001 critical
DeleteStmt > WhereClause = NULL
fix: DELETE FROM users WHERE id = $1
This is Vericto enforcing a rule — the exit code is intentional, not a crash.
To allow a finding on purpose, add an inline comment on the statement:
-- vericto:ignore[VERICTO-001] <reason> (a reason is required)Salida real de @vericto/vericto-cli@2.3.0 (engine 5.1.0) sobre el ejemplo de la página de VERICTO-001.
2. Un rol de solo lectura
Cuándo usarlo
Siempre, como capa base, cuando el agente solo necesita leer. Un rol con permisos SELECT y nada más hace que la propia base rechace las escrituras.
Configuración
PostgreSQL (GRANT):
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;De la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
MySQL (GRANT):
CREATE USER 'agent_ro'@'%' IDENTIFIED BY '…';
GRANT SELECT ON shop.* TO 'agent_ro'@'%';De la documentación, no probado aquí: Manual de referencia de MySQL 8.4: GRANT
Qué puede salir mal
- Leer también hace daño. Un rol de solo lectura puede ejecutar un
SELECTsin límite sobre una tabla grande, y puede leer cada columna que se le otorgó, incluidos emails o números de tarjeta que luego terminan en el contexto del modelo. - Los ajustes de sesión no son un candado. Ajustes como
default_transaction_read_onlyystatement_timeoutson valores por defecto de la conexión que una sesión puede cambiar; lo que se sostiene son los permisos. - Algunos catálogos los lee cualquier rol. En PostgreSQL,
pg_catalogdescribe el esquema a cualquiera que pueda conectarse.
Lo probamos en PostgreSQL 17, sentencia por sentencia: lo que un rol de solo lectura de Postgres frena y lo que no cuando se conecta un agente de IA.
3. Un servidor MCP de base de datos
Cuándo usarlo
Cuando el agente habla el Model Context Protocol (Claude Code, Cursor, Codex y muchos otros lo hacen) y quieres que llame a una herramienta de base de datos en lugar de a una shell. Un servidor MCP de base de datos es un proceso que tiene la credencial y le expone al agente herramientas como "ejecuta este SQL" o "describe el esquema".
Configuración
Registras el servidor en la configuración MCP del agente (un comando que lanza, o una URL) y le das al servidor la URL de conexión. Los flags exactos dependen del servidor que elijas: sigue su propia documentación.
Qué puede salir mal
- La credencial se mueve, el riesgo no. El agente ya no ve la URL, pero el servidor ejecuta lo que pide el modelo con los privilegios de esa credencial.
- Muchos servidores ejecutan cualquier SQL que escriba el modelo. Revisa si el que usas restringe sentencias, acota resultados o corre dentro de una transacción de solo lectura; si no, el rol de solo lectura es tu único control.
- Los resultados son datos no confiables. Las filas vuelven al contexto del modelo, donde una instrucción inyectada puede dirigir las otras herramientas del agente.
- Un segundo camino lo anula. Si el agente también tiene un
DATABASE_URLen su entorno, puede rodear el servidor.
4. El proxy de Vericto o vericto-proxy mcp
Los dos ponen a Vericto entre el agente y la base: cada sentencia se evalúa sobre su AST contra las reglas antes de que la base la reciba.
Cuándo usarlo
- El proxy TCP (PostgreSQL y MySQL) para un agente o una aplicación que ya habla el protocolo de la base, incluido el SQL que genera un ORM. Sin cambios de código: la URL de conexión apunta al proxy.
vericto-proxy mcp(PostgreSQL, de solo lectura en 5.0.1) para un agente de programación: recibeexecute_sql,describe_schema,check_sqlywhoami, y ninguna credencial de la base.
Configuración: el proxy TCP
Corre el proxy junto a la base y apunta el cliente a él, con el mismo usuario y contraseña (guía de integración):
# docker-compose.yml
services:
vericto-proxy:
image: ghcr.io/vericto/vericto-proxy:latest
ports:
- "5433:5433"
environment:
VERICTO_API_URL: "https://api.vericto.com"
VERICTO_API_KEY: "${VERICTO_API_KEY}"
VERICTO_DATABASE_ID: "${VERICTO_DATABASE_ID}"
VERICTO_WIRE_PROTOCOL: "postgres" # or "mysql"
UPSTREAM_HOST: "your-db-host.rds.amazonaws.com"
UPSTREAM_PORT: "5432"
PROXY_LISTEN_PORT: "5433"
# Remote DB (RDS): encrypt the proxy → database hop.
UPSTREAM_SSLMODE: "require" # or "verify-full" + UPSTREAM_SSLROOTCERT
app:
environment:
# Point your app to the proxy — same user:pass as before
DATABASE_URL: "postgres://user:pass@vericto-proxy:5433/mydb"
depends_on:
- vericto-proxyDe la documentación, no probado aquí: Guía de integración de Vericto: el proxy TCP
Configuración: vericto-proxy mcp, sin cuenta
Desde 5.0.1 hay binarios nativos para Linux, macOS y Windows. Sin VERICTO_API_KEY, el servidor corre en local con el ruleset integrado y no reporta nada a ningún lado.
- Crea un rol que use solo este servidor, con el SQL de solo lectura del paso 2.
- Guarda la URL en un archivo, no en la configuración del agente:
mkdir -p ~/.config/vericto && chmod 700 ~/.config/vericto
printf '%s' 'postgres://vericto_agent_ro:…@db.example.com:5432/shop?sslmode=verify-full' \
> ~/.config/vericto/shop.url
chmod 600 ~/.config/vericto/shop.urlDe la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
- Instala el binario y registra el servidor. Claude Code:
curl --proto '=https' --tlsv1.2 -LsSf \
https://github.com/vericto/vericto-proxy/releases/download/v5.0.1/vericto-proxy-installer.sh | sh
claude mcp add vericto-db -- ~/.cargo/bin/vericto-proxy \
mcp --database-url-file ~/.config/vericto/shop.urlDe la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"vericto-db": {
"command": "/Users/me/.cargo/bin/vericto-proxy",
"args": ["mcp", "--database-url-file", "/Users/me/.config/vericto/shop.url"]
}
}
}De la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
Codex (~/.codex/config.toml):
[mcp_servers.vericto-db]
command = "/Users/me/.cargo/bin/vericto-proxy"
args = ["mcp", "--database-url-file", "/Users/me/.config/vericto/shop.url"]De la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
- Pídele al agente que llame a
whoami. Esta es la respuesta real en modo local:
whoami {}
Proxy mode · local (no control plane) · database shop (postgres) · tiers: read enabled, write/delete/ddl off · ruleset standard@5.0.0 (built-in)
Limits: 200 rows (max 1000), 262144 bytes, 8192 bytes per value, 15000 ms timeout.
Warning (no_control_plane): no control plane (local mode): the built-in ruleset only, without the workspace's rules, masks, allowlists, kill switch or reportingSalida real: vericto-proxy 5.0.1 release binary, `vericto-proxy mcp` in local mode, 2026-11-14.
Una sentencia que las reglas bloquean nunca se ejecuta, y una escritura se rechaza porque en 5.0.1 solo existe el nivel de lectura. Respuestas reales:
execute_sql { "sql": "DROP TABLE users" }
BLOCKED (BLOCKED): Blocked by VERICTO-010 (DropStmt).
Suggested fix: Use a versioned migration tool (Flyway, Prisma Migrate, Alembic, Rails migrations)
Next: not run; apply the suggested fix and call execute_sql again with the corrected SQL.
Ruleset standard@5.0.0Salida real: vericto-proxy 5.0.1 release binary, `vericto-proxy mcp` in local mode, 2026-11-14.
execute_sql { "sql": "DELETE FROM users WHERE id = 1" }
BLOCKED (TIER_NOT_ENABLED): The delete tier is not enabled for this database.
Next: not run: this is a DELETE and only read is enabled for you on shop. Each tier (write, delete, DDL) needs a person to enable it, and each statement needs approval; ask the user. Rephrasing will not help.
Ruleset standard@5.0.0Salida real: vericto-proxy 5.0.1 release binary, `vericto-proxy mcp` in local mode, 2026-11-14.
Enlazado a un workspace de Vericto (VERICTO_API_KEY y VERICTO_DATABASE_ID), el mismo servidor aplica las reglas propias del workspace, las máscaras de columnas sensibles y las allowlists de acceso de agentes, registra cada llamada en el audit trail y agrega un kill switch. El proxy es código abierto bajo AGPL-3.0-only.
Qué puede salir mal
- Otra credencial lo rodea. La documentación lo dice claro: solo funciona si el agente no tiene otra credencial de la base. El servidor avisa, por nombre, si ve
DATABASE_URL,PGPASSWORD, un~/.pgpassy similares en su entorno. En Claude Code también puedes negarles a las herramientas del agente el acceso al secreto ensettings.json:
"permissions": { "deny": ["Read(~/.config/vericto/**)", "Bash(psql:*)", "Bash(cat ~/.config/vericto/*)"] }De la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
- MySQL y las escrituras no están en
vericto-proxy mcp5.0.1. Para MySQL, usa el proxy TCP. - Las máscaras tienen límites. Una columna marcada que solo aparece en
WHEREno es una lectura; la documentación recomienda una allowlist de acceso para el usuario de base del agente.
5. El servidor MCP de runtime de Vericto y check_sql
Cuándo usarlo
Cuando el agente escribe SQL (migraciones, queries en el código, una herramienta de texto a SQL) y debe recibir un veredicto antes de que se ejecute nada, en cualquiera de los seis dialectos. Vericto solo analiza el texto: nunca se conecta a tu base.
Configuración: un agente de programación
Crea una API key solo con el scope ci_dryrun:execute, expórtala como VERICTO_API_KEY y agrega el servidor remoto (documentación de MCP):
claude mcp add --scope user --transport http vericto https://mcp.vericto.com/mcp \
--header 'Authorization: Bearer ${VERICTO_API_KEY}'De la documentación, no probado aquí: Documentación de Vericto: agentes de IA (MCP)
El agente llama a check_sql y recibe BLOCKED, FLAGGED, MONITORED o ALLOWED por sentencia, con la regla, la línea y una corrección sugerida. La salida real de abajo viene del check_sql local de vericto-proxy mcp, que evalúa "como responde el check_sql alojado", con el mismo formato:
check_sql { "dialect": "postgres", "sql":
"SELECT id, email FROM users WHERE id = 42 LIMIT 1;
DELETE FROM users;
UPDATE orders SET status = 'cancelled';
SELECT id, email FROM users WHERE name = 'x' OR 1 = 1;
SELECT id, email FROM users WHERE active;" }
BLOCKED: 3 of 5 statements must not ship as written.
- line 2 BLOCKED VERICTO-001 (critical): DELETE FROM users Fix: DELETE FROM users WHERE id = $1
- line 3 BLOCKED VERICTO-030 (critical): UPDATE orders SET status = 'cancelled' Fix: UPDATE orders SET {col} = $1 WHERE id = $2
- line 4 BLOCKED VERICTO-090 (critical): SELECT id, email FROM users WHERE name = 'x' OR 1 = 1 Fix: SELECT ... WHERE id = $1 -- use parameterized queries
- line 5 FLAGGED VERICTO-050 (medium): SELECT id, email FROM users WHERE active
Next:
- lines 2, 3, 4 (VERICTO-001): do not run it as written; apply the suggested fix, then call check_sql again with the corrected SQL.
- line 5 (VERICTO-050): allowed; mention VERICTO-050 (medium) to the user when you run it.
- line 1: call execute_sql with the same sql.
Ruleset standard@5.0.0 · checked locally, no CI checks spentSalida real: vericto-proxy 5.0.1 release binary, `vericto-proxy mcp` in local mode, 2026-11-14.
Configuración: un agente propio (LangChain, OpenAI Agents SDK)
Los SDK de Python y Node (Apache-2.0) evalúan cada sentencia con la API de runtime antes de que tu driver la ejecute. LangChain tiene una integración oficial, vericto.langchain (VerictoSQLDatabase para SQLDatabaseToolkit y create_sql_agent). Para el OpenAI Agents SDK y otros frameworks, el patrón documentado es una función de herramienta que llama a guard.prepare() antes de ejecutar:
import psycopg
from vericto import Vericto, VerictoBlocked
guard = Vericto() # one per process
conn = psycopg.connect("dbname=app") # a plain connection: the tool does the check
def run_sql(query: str) -> str:
"""The function you register as the agent's SQL tool."""
try:
sql = guard.prepare(query, "postgres") # the masked rewrite when there is one
except VerictoBlocked as exc:
return f"Vericto blocked this query ({exc.verdict.rule_code}); it was not run. Suggested fix: {exc.suggested_fix}"
with conn.cursor() as cur: # VerictoUnavailable and VerictoConfigError propagate
cur.execute(sql)
return repr(cur.fetchall())De la documentación, no probado aquí: Documentación de Vericto: SDK de Python y Node
Qué puede salir mal
check_sqlrecomienda; no ejecuta. Un agente que ignora el veredicto puede ejecutar la original por otra herramienta. Combínalo con un rol de solo lectura, o con el proxy cuando tiene que sostenerse.- El SDK protege el SQL que pasa por él. No otra conexión, el objeto original del driver ni otro proceso con las mismas credenciales.
- No conviertas los errores en texto para el modelo. Deja que
VerictoUnavailableyVerictoConfigErrorse propaguen, para que una mala configuración falle cerrada.
Cuál elegir
| Forma | Configuración | Qué frena un DELETE o un DROP | Columnas sensibles | Auditoría | MySQL |
|---|---|---|---|---|---|
| URL de conexión directa | Una URL | Nada | No | Solo lo que registre la base | Sí |
| Rol de solo lectura | Unas pocas sentencias SQL | La base rechaza las escrituras | Solo lo que dejes fuera de los permisos o las vistas | Solo lo que registre la base | Sí |
| Un servidor MCP de base de datos | Una entrada en la configuración del agente | Depende del servidor y del rol detrás | Depende del servidor | Depende del servidor | Depende del servidor |
| Proxy TCP de Vericto | Un contenedor y una cuenta de Vericto | El proxy la bloquea antes de la base | Bloquear, marcar o enmascarar por columna | Cada sentencia en el audit trail | Sí |
vericto-proxy mcp | Un binario; sin cuenta en modo local | Solo el nivel de lectura, más las reglas | Máscaras al enlazarlo a un workspace | Cada llamada, si está enlazado | No (PostgreSQL en 5.0.1) |
MCP de runtime y check_sql | Un comando y una API key | Un veredicto BLOCKED que el agente debe seguir | La query enmascarada como la única aprobada | Historial de checks en el dashboard | Sí (dialect: mysql) |
Una regla práctica: datos locales, una URL directa está bien; datos compartidos o de producción, un rol de solo lectura más el proxy o vericto-proxy mcp, y check_sql para el SQL que el agente escribe en el código.
Preguntas frecuentes
Fuentes
La documentación oficial que cita esta guía, revisada el 2026-11-14:
- vericto-proxy 5.0.1: docs/MCP.md (modo MCP)
- Documentación de Vericto: agentes de IA (MCP)
- Documentación de Vericto: SDK de Python y Node
- Guía de integración de Vericto: el proxy TCP
- Model Context Protocol: especificación
- Documentación de PostgreSQL: GRANT
- Documentación de PostgreSQL: valores por defecto de la conexión (default_transaction_read_only, statement_timeout)
- Manual de referencia de MySQL 8.4: GRANT
Páginas relacionadas
- Texto a SQL con LLM: cómo funciona y cómo validar el SQL antes de ejecutarlo
- Data masking en bases de datos: opciones nativas y el enfoque de proxy
- Documentación: agentes de IA (MCP)
- Documentación: acceso de agentes, una allowlist por agente
- MCP para agentes de IA
- Guía de integración: proxy TCP, API, CLI y MCP
- Páginas de reglas: cada sentencia peligrosa, con la salida real de la CLI
- Páginas de incidentes: un agente de IA o el ORM borró datos
- Blog: agentes de IA con acceso a la base de datos, casos documentados
- Blog: lo que un rol de solo lectura de Postgres frena y lo que no