Data sources

Add a Database Target

Targets expose databases to your agent with policy controls. We recommend starting read-only while you confirm auditing and tooling. This guide uses our demo credentials, but the same flow applies to your own hosts.

1) Open Databases in Console

In Console, navigate to Databases and click New target. You’ll see existing connections and their status.

Gentility Console databases list with an existing ecommerce demo target — Use this list to monitor status and jump back into a target for edits later.

2) Paste the connection URL

Choose your database type then paste the connection string. Gentility parses the URL and pre-fills host, port, user, and database fields.

Try a demo database (read-only)

postgresql://readonly:[email protected]:5432/ecommerce_demo mssql://readonly:[email protected]:1433/ecommerce_demo

New database target form filled with the demo PostgreSQL connection string — Hit **Parse**, verify the preview, and keep the mode set to read-only until policies are validated.

3) Configure access mode

Start with Direct (IP Allowlist) or your Gentility portal depending on network placement. Keep Read-only enabled for initial testing.

Read-only: safest default, blocks mutating SQL by policy.
Guarded writes: allow specific whitelisted commands or stored procedures after review.
Full writes: only after you trust policy coverage and observability.

4) Test and save

Click Test connection. When the green success badge appears, save the target. The database is now exposed to Gentility tools with your chosen policies.

Gentility agent denying a write because the database is read-only — Use the read-only mode to confirm writes are blocked and audits are captured before opening up access.

Next steps

Hook the database into your MCP workflow or API calls, and monitor the initial command traffic via MCP Logs.

Return to Getting Started Connect with ChatGPT Connect with Claude