Skip to main content

PostgreSQL Integration

To interface your MCP server with a PostgreSQL instance, you must define the connection parameters and establish a secure handshake. This process ensures the server can successfully orchestrate query execution and schema inference.

Connection Parameters

Configure the following fields to authorize the MCP server's access to your database. Use a dedicated service account with limited privileges to maintain strict data governance.

ParameterTechnical DescriptionRequired
Database HostThe server address or IP where the database resides.Yes
PortThe communication port (Default: 5432).Yes
Database NameThe specific relational schema to be indexed.Yes
CredentialsThe Username and Password for authentication.Yes
TimeoutDuration (seconds) before a connection terminates.Optional (Default: 30)

Manual Connect PostgreSQL Method

Required Permissions

Currently, the database user must have permissions to list tables and describe table schemas (e.g., access to information_schema). This allows the engine to automate tool generation. A fallback for custom SQL definitions without these requirements is currently in development.

Use Quick Connect for Faster Provisioning

If you have a PostgreSQL Connection URI (e.g., postgresql://user:pass@host:5432/db), use the Quick Connect toggle. This automatically parses and populates all required fields in a single step.

Handshake & Schema Discovery

Once you click Next, the MCP server initiates an automated validation sequence:

  • Connection Test: Validates the network path and credentials.
  • Schema Discovery: Queries the database to identify all available tables.
  • Inference Engine: Prepares the initial data mappings for your configuration.

If the connection fails, the system will provide an error message to help you troubleshoot.