Skip to main content

​
Overview

Data Connectors allow you to link your existing database directly to Cobi, enabling the Data Assistant to query and analyze your data in real-time.
All database connections are read-only. Cobi will never modify your data.

​
Supported Databases

Cobi currently supports the following database types:
  • PostgreSQL (versions 12 and above)
  • MySQL (version 8.0 and above)
  • MongoDB (Atlas via SRV connection strings and self-hosted instances)

​
Connecting Your Database

1

Open Developer Settings

Navigate to the Developer section in the sidebar, then select Data Connectors.
2

Add New Connection

Click the Add Data Source button to open the connection form.
3

Enter Connection Details

Fill in your database credentials:
FieldDescription
Connection NameA friendly name to identify this data source (e.g., “Production DB”, “Analytics”)
HostYour database server address (e.g., db.example.com or an IP address)
PortThe database port (default: 5432 for PostgreSQL)
Database NameThe name of the specific database to connect to
UsernameDatabase user with read access
PasswordPassword for the database user
4

Test Connection

Click Test Connection to verify your credentials. Cobi will attempt to connect and confirm access.
5

Save Connection

Once the test succeeds, click Save Changes to store your connection.

​
Network Configuration

​
IP Allowlisting

If your database is behind a firewall, you’ll need to allowlist Cobi’s IP addresses: 
xx.xx.xxx.xx
xx.xx.xxx.xx
Contact [email protected] to get the IP addresses for your region.

​
Using SSH Tunnels

For databases that aren’t publicly accessible, we recommend setting up an SSH tunnel or using a bastion host. Contact our support team for guidance on secure connection options.

​
Managing Connections

​
Edit a Connection

To update connection details:
  1. Go to Developer > Data Connectors
  2. Click on the connection you want to edit
  3. Update the fields as needed
  4. Click Test Connection to verify, then Save Changes

​
Delete a Connection

To remove a data source:
  1. Go to Developer > Data Connectors
  2. Click on the connection
  3. Click Delete Connection
Deleting a connection will remove all learned information and custom instructions associated with that data source.

​
Next Steps

Once your database is connected:
  • Add Custom Instructions to help Cobi understand your data
  • Start a conversation with the Data Assistant to explore your data