To chart Postgres data in Claude, ChatGPT or another AI client, connect it here, then create an app on it.
Bonnard reads PostgreSQL through a read-only user, so your apps query only what you grant.
DataConnect the databases and integrations your apps read.Available connectionsDatabasesPostgreSQLBigQueryRedshiftClickHouseMotherDuckMySQL / MariaDBMSSQLIntegrationsPostHogDemo dataEcommerceEcommerceSetting up…PostHogDatabaseConnect a databaseConnection nameAcme sampleImport from connection string (optional)postgresql://user:password@host:5432/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)5432DatabaseacmeUseracme_readerSSL modeverify-fullCA certificate (PEM) (optional)Optional. Paste the CA bundle for verify-ca/verify-full when the DB uses a private CA (e.g. AWS RDS). Not needed for public-CA hosts.Password••••••••••••••••Encrypted at rest.Allow our IP addressesIf your database is firewalled, allowlist these egress IPs so we can reach it:208.77.244.241208.77.244.242152.55.184.240These addresses are stable. We will give advance notice before any change.Test & connectBackTesting connection...Back1Details2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseConnection nameAcme sampleImport from connection string (optional)postgresql://user:password@host:5432/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)5432DatabaseacmeUseracme_readerSSL modeverify-fullCA certificate (PEM) (optional)Optional. Paste the CA bundle for verify-ca/verify-full when the DB uses a private CA (e.g. AWS RDS). Not needed for public-CA hosts.Password••••••••••••••••Encrypted at rest.Allow our IP addressesIf your database is firewalled, allowlist these egress IPs so we can reach it:208.77.244.241208.77.244.242152.55.184.240These addresses are stable. We will give advance notice before any change.Test & connectBackTesting connection...Back1Details2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantRow-levelisolationbytenant,withapolicythatfiltersoncurrent_setting('app.tenant_id').RequiresRLSalreadyenabledonyourtables.SeesetupSQL.Tenant ID lookup (optional)Pick a table and column where your customer IDs are, these will be used for tenant mapping purposes.TableSelect a table…ColumnSelect a column…Save & continueBackSaving…BackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantRow-levelisolationbytenant,withapolicythatfiltersoncurrent_setting('app.tenant_id').RequiresRLSalreadyenabledonyourtables.SeesetupSQL.Tenant ID lookup (optional)Pick a table and column where your customer IDs are, these will be used for tenant mapping purposes.TableSelect a table…ColumnSelect a column…Save & continueBackSaving…BackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseConnection saved"Acme sample" is ready to use.4 tables discovered · No tenancySearch tables…4 tablesSchemaTable ↑TypeRowsColumnspubliccustomerstable–5publicorder_itemstable–5publicorderstable–6publicproductstable–4Next stepCreate an app so your users can query these tables from their AI client.Create an app Or view source detailsBack to setupDetailsTenancyDoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseConnection saved"Acme sample" is ready to use.4 tables discovered · No tenancySearch tables…4 tablesSchemaTable ↑TypeRowsColumnspubliccustomerstable–5publicorder_itemstable–5publicorderstable–6publicproductstable–4Next stepCreate an app so your users can query these tables from their AI client.Create an app Or view source detailsBack to setupDetailsTenancyDoneNeed help?Setup guideConnection details areencrypted at rest.
Requirements
The Admin role in your Bonnard workspace.
A PostgreSQL login that can create roles.
1. Create a read-only user
Bonnard connects as this user. Agents can query only the tables it can read.
SQL
-- A user that can log in and read, nothing moreCREATE ROLE mcp_reader LOGIN PASSWORD '<password>' NOSUPERUSER NOCREATEDB NOCREATEROLE NOBYPASSRLS;-- Run these two lines once for each schema apps should queryGRANT USAGE ON SCHEMA <schema> TO mcp_reader;GRANT SELECT ON <schema>.<table_1>, <schema>.<table_2> TO mcp_reader;
Replace <password>, <schema> and the table names with your own. Grant tables you add later the same way.
2. Allow Bonnard’s IP addresses
If your database limits who can connect, allow Bonnard’s IP addresses on port 5432. The connect form lists them
under Allow our IP addresses. Bonnard cannot reach databases on a private network.
3. Add the connection
In the console at app.bonnard.ai, select Data, then PostgreSQL.DataConnect the databases and integrations your apps read.Available connectionsDatabasesPostgreSQLBigQueryRedshiftClickHouseMotherDuckMySQL / MariaDBMSSQLIntegrationsPostHogDemo dataEcommerceEcommerceSetting up…PostHogDataConnect the databases and integrations your apps read.Available connectionsDatabasesPostgreSQLBigQueryRedshiftClickHouseMotherDuckMySQL / MariaDBMSSQLIntegrationsPostHogDemo dataEcommerceEcommerceSetting up…PostHog
Enter a Connection name and the user’s details from the table below. To fill them from a URL, paste it into
Import from connection string (optional) and select Fill fields.DatabaseConnect a databaseConnection nameAcme sampleImport from connection string (optional)postgresql://user:password@host:5432/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)5432DatabaseacmeUseracme_readerSSL modeverify-fullCA certificate (PEM) (optional)Optional. Paste the CA bundle for verify-ca/verify-full when the DB uses a private CA (e.g. AWS RDS). Not needed for public-CA hosts.Password••••••••••••••••Encrypted at rest.Allow our IP addressesIf your database is firewalled, allowlist these egress IPs so we can reach it:208.77.244.241208.77.244.242152.55.184.240These addresses are stable. We will give advance notice before any change.Test & connectBackTesting connection...Back1Details2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseConnection nameAcme sampleImport from connection string (optional)postgresql://user:password@host:5432/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)5432DatabaseacmeUseracme_readerSSL modeverify-fullCA certificate (PEM) (optional)Optional. Paste the CA bundle for verify-ca/verify-full when the DB uses a private CA (e.g. AWS RDS). Not needed for public-CA hosts.Password••••••••••••••••Encrypted at rest.Allow our IP addressesIf your database is firewalled, allowlist these egress IPs so we can reach it:208.77.244.241208.77.244.242152.55.184.240These addresses are stable. We will give advance notice before any change.Test & connectBackTesting connection...Back1Details2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.
Select Test & connect. Bonnard logs in as the user and reads the tables it can see.
PostgreSQL connection fields
Field
Enter
Connection name
A name for this database in Bonnard, such as Production.
Host
The server’s public hostname or IP address.
Port
5432, unless your server listens on another port.
Database
The database to read.
User and Password
The read-only user from step 1, such as mcp_reader.
SSL mode
Keep verify-full. For a private CA, such as Amazon RDS, paste its bundle into CA certificate (PEM).
4. Choose the tenancy
Choose how callers see the data, then select Save & continue.
Tenancy options
Option
Use it when
No tenancy
Every caller should see the same data.
Multi-tenant (RLS)
Your row-level security policies decide each caller’s rows. They read the caller’s tenant (the customer they belong to) from current_setting('app.tenant_id').
Schema per tenant
Each tenant’s tables sit in their own schema, named by a pattern such as customer_{tenant}.
DatabaseConnect a databaseconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantRow-levelisolationbytenant,withapolicythatfiltersoncurrent_setting('app.tenant_id').RequiresRLSalreadyenabledonyourtables.SeesetupSQL.Tenant ID lookup (optional)Pick a table and column where your customer IDs are, these will be used for tenant mapping purposes.TableSelect a table…ColumnSelect a column…Save & continueBackSaving…BackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyMulti-tenant (RLS)Schema per tenantRow-levelisolationbytenant,withapolicythatfiltersoncurrent_setting('app.tenant_id').RequiresRLSalreadyenabledonyourtables.SeesetupSQL.Tenant ID lookup (optional)Pick a table and column where your customer IDs are, these will be used for tenant mapping purposes.TableSelect a table…ColumnSelect a column…Save & continueBackSaving…BackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.
Connection saved shows the number of tables discovered.
DatabaseConnect a databaseConnection saved"Acme sample" is ready to use.4 tables discovered · No tenancySearch tables…4 tablesSchemaTable ↑TypeRowsColumnspubliccustomerstable–5publicorder_itemstable–5publicorderstable–6publicproductstable–4Next stepCreate an app so your users can query these tables from their AI client.Create an app Or view source detailsBack to setupDetailsTenancyDoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseConnection saved"Acme sample" is ready to use.4 tables discovered · No tenancySearch tables…4 tablesSchemaTable ↑TypeRowsColumnspubliccustomerstable–5publicorder_itemstable–5publicorderstable–6publicproductstable–4Next stepCreate an app so your users can query these tables from their AI client.Create an app Or view source detailsBack to setupDetailsTenancyDoneNeed help?Setup guideConnection details areencrypted at rest.
Troubleshooting
Host resolves to a private or reserved address. Use the public hostname. Bonnard cannot reach private networks.
The test times out. Check that Bonnard’s IP addresses are allowed (step 2).
Connected, but introspect failed: <message> The user cannot read the table list. Fix what the message names.
A table is missing. Grant SELECT on it, then select Re-introspect on the database’s Tables tab.
Any other error is PostgreSQL’s own message. Check the field it names, then select Test & connect again.
Charts in your AI client
Create an app on this database, so AI clients such as Claude and ChatGPT can query it and draw charts.