Cómo conectar agentes de IA a bases de datos: 5 formas, paso a paso

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.

FormaQuién tiene la credencialQuién revisa el SQL
1. URL de conexión directaEl agenteNadie
2. Rol de solo lecturaEl agenteLos privilegios de la base
3. Un servidor MCP de base de datosEl servidor MCPLo que ese servidor implemente
4. El proxy de Vericto o vericto-proxy mcpEl proxyLas reglas de Vericto, sobre el AST de cada sentencia, antes de que la base la vea
5. El servidor MCP de runtime y check_sqlTu 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 DELETE sin WHERE, un DROP TABLE o 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 .env y 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 SELECT sin 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_only y statement_timeout son 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_catalog describe 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_URL en 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: recibe execute_sql, describe_schema, check_sql y whoami, 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-proxy

De 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.

  1. Crea un rol que use solo este servidor, con el SQL de solo lectura del paso 2.
  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.url

De la documentación, no probado aquí: vericto-proxy 5.0.1: docs/MCP.md (modo MCP)

  1. 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.url

De 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)

  1. 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 reporting

Salida 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.0

Salida 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.0

Salida 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 ~/.pgpass y similares en su entorno. En Claude Code también puedes negarles a las herramientas del agente el acceso al secreto en settings.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 mcp 5.0.1. Para MySQL, usa el proxy TCP.
  • Las máscaras tienen límites. Una columna marcada que solo aparece en WHERE no 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 spent

Salida 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_sql recomienda; 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 VerictoUnavailable y VerictoConfigError se propaguen, para que una mala configuración falle cerrada.

Cuál elegir

FormaConfiguraciónQué frena un DELETE o un DROPColumnas sensiblesAuditoríaMySQL
URL de conexión directaUna URLNadaNoSolo lo que registre la baseSí
Rol de solo lecturaUnas pocas sentencias SQLLa base rechaza las escriturasSolo lo que dejes fuera de los permisos o las vistasSolo lo que registre la baseSí
Un servidor MCP de base de datosUna entrada en la configuración del agenteDepende del servidor y del rol detrásDepende del servidorDepende del servidorDepende del servidor
Proxy TCP de VerictoUn contenedor y una cuenta de VerictoEl proxy la bloquea antes de la baseBloquear, marcar o enmascarar por columnaCada sentencia en el audit trailSí
vericto-proxy mcpUn binario; sin cuenta en modo localSolo el nivel de lectura, más las reglasMáscaras al enlazarlo a un workspaceCada llamada, si está enlazadoNo (PostgreSQL en 5.0.1)
MCP de runtime y check_sqlUn comando y una API keyUn veredicto BLOCKED que el agente debe seguirLa query enmascarada como la única aprobadaHistorial de checks en el dashboardSí (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: