To chart MySQL or MariaDB data in Claude, ChatGPT or another AI client, connect it here, then create an app on it.
Bonnard reads MySQL or MariaDB 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)mysql://user:password@host:3306/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)3306DatabaseacmeUseracme_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)mysql://user:password@host:3306/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)3306DatabaseacmeUseracme_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 tenancyDatabase per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyDatabase per tenantEach tenant gets its own database.Representative database *customer_acmeOne real, existing tenant database. We connect + read table shapes from it (they're identical across tenants). Required.How are tenant databases named?Naming patternMap each tenantcustomer_{tenant}Preview: tenant acme database …Enter a representative database so we can read the table shapes.Save & continueBackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseconnectedAcme sampleNo tenancyDatabase per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyDatabase per tenantEach tenant gets its own database.Representative database *customer_acmeOne real, existing tenant database. We connect + read table shapes from it (they're identical across tenants). Required.How are tenant databases named?Naming patternMap each tenantcustomer_{tenant}Preview: tenant acme database …Enter a representative database so we can read the table shapes.Save & continueBackDetails2Tenancy3DoneNeed 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 ↑TypeRowsColumnsacmecustomerstable12045acmeorder_itemstable148765acmeorderstable53106acmeproductstable484Next 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 ↑TypeRowsColumnsacmecustomerstable12045acmeorder_itemstable148765acmeorderstable53106acmeproductstable484Next 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 MySQL or MariaDB user that can create users and grant privileges.
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, nothing more. '%' accepts any client address;-- a narrower host part must match Bonnard's IP addressesCREATE USER 'mcp_reader'@'%' IDENTIFIED BY '<password>';-- Run this once for each database apps should query-- SHOW VIEW lets agents read how each view is definedGRANT SELECT, SHOW VIEW ON <database>.* TO 'mcp_reader'@'%';
Replace <password> and <database> with your own. The grant covers tables you add to the database later. If each
tenant (the customer a caller belongs to) has its own database, grant each one.
2. Allow Bonnard’s IP addresses
If your database limits who can connect, allow Bonnard’s IP addresses on port 3306. 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 MySQL / MariaDB.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)mysql://user:password@host:3306/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)3306DatabaseacmeUseracme_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)mysql://user:password@host:3306/databaseFill fieldsParsed into the fields below; the string itself is not stored.Hostdb.acme.internalPort (optional)3306DatabaseacmeUseracme_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.
MySQL / MariaDB connection fields
Field
Enter
Connection name
A name for this database in Bonnard, such as Production.
Host
The server’s public hostname. With verify-full, an IP address fails the certificate check.
Port
3306, 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.
Database per tenant
Each tenant’s tables sit in their own database, named by a pattern such as customer_{tenant}.
DatabaseConnect a databaseconnectedAcme sampleNo tenancyDatabase per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyDatabase per tenantEach tenant gets its own database.Representative database *customer_acmeOne real, existing tenant database. We connect + read table shapes from it (they're identical across tenants). Required.How are tenant databases named?Naming patternMap each tenantcustomer_{tenant}Preview: tenant acme database …Enter a representative database so we can read the table shapes.Save & continueBackDetails2Tenancy3DoneNeed help?Setup guideConnection details areencrypted at rest.DatabaseConnect a databaseconnectedAcme sampleNo tenancyDatabase per tenantNo customer routing is applied. Every allowed caller sees the data available to this credential.Save & continueBackSaving…BackconnectedAcme sampleNo tenancyDatabase per tenantEach tenant gets its own database.Representative database *customer_acmeOne real, existing tenant database. We connect + read table shapes from it (they're identical across tenants). Required.How are tenant databases named?Naming patternMap each tenantcustomer_{tenant}Preview: tenant acme database …Enter a representative database so we can read the table shapes.Save & continueBackDetails2Tenancy3DoneNeed 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 ↑TypeRowsColumnsacmecustomerstable12045acmeorder_itemstable148765acmeorderstable53106acmeproductstable484Next 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 ↑TypeRowsColumnsacmecustomerstable12045acmeorder_itemstable148765acmeorderstable53106acmeproductstable484Next 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.
Hostname/IP does not match certificate's altnames: <reason>Host is an IP address and SSL mode is
verify-full. Enter the hostname the certificate names, or choose verify-ca.
Any other error is MySQL’s or MariaDB’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.