← Back to Home

Configuration Guide • Incorta MCP

Setup & Configuration

Follow this comprehensive guide to enable OAuth 2.0 for Incorta public APIs and SQLx, then connect the Incorta MCP server as a custom connector in your AI client. Everything you need is right here.

CMC Setup Claude Setup
Release 2025.10.15-mcp Last updated Nov 11, 2025 Maintained by Incorta MCP team

Overview

This guide walks you through:

  • Enabling OAuth 2.0 for Incorta public APIs
  • Enabling OAuth 2.0 for SQLx (JDBC) at the tenant level
  • Connecting Incorta MCP as a custom connector in your AI client
Keep the authorization server base URL handy. You'll use it both in the CMC and when configuring your AI client.

Prerequisites

  • Access to Incorta Cluster Management Console (CMC)
  • A cluster with permissions to update API Security and tenant settings
  • The OAuth 2.0 authorization server base URL provided by your admin
  • Ability to restart the Incorta Analytics service

Part A — Configure your Cluster in CMC

Step 1 — Open the CMC

Launch the Incorta Cluster Management Console with your administrator credentials.

Step 2 — Select your Cluster

Choose the target cluster where you plan to enable OAuth 2.0 protections.

Step 3 — Enable API Security (OAuth 2.0 for public APIs)

  1. Navigate to Cluster Configurations.
  2. Select API Security.
  3. Enable Allow OAuth 2.0 for Public APIs Authentication.
  4. For OAuth 2.0 authorization server base URL, enter: https://analytics-mcp.incorta.com/
  5. Click Save.
Need a visual? Refer to the CMC screenshot illustrating API Security configuration.
CMC API Security configuration screen
CMC API Security configuration screen.

Part B — Enable OAuth 2.0 for SQLx (JDBC)

  1. Go to the Tenants tab.
  2. Click Configure for your tenant.
  3. Open Integration, then enable OAuth 2.0-based authentication for JDBC connection.
  4. Set OAuth 2.0 authorization server base URL to: https://analytics-mcp.incorta.com/
  5. Click Save.
  6. Restart your Analytics service to apply changes.
Enable OAuth 2.0 for SQLx in tenant settings
Enable OAuth 2.0 for SQLx in the tenant configuration.
Tenant OAuth settings for JDBC
Tenant OAuth settings for JDBC connections.
A restart is required for the JDBC OAuth setting to take effect.

Part C — Connect Incorta MCP in Claude

Step 1 — Open Claude settings

  • Launch Claude.
  • Select the Settings icon.
  • Choose Manage connectors.
Claude manage connectors screen
Claude Manage Connectors screen.

Step 2 — Add a Custom Connector

Add custom connector in Claude
Add the Incorta MCP custom connector in Claude.
If the connector does not appear immediately, restart Claude and try again.

Step 3 — Connect

Once the connector is listed, click Connect to finalize the integration.

Login Information

When setting up your login credentials, ensure the following:

  • Enter the full Incorta URL including the trailing /incorta: https://<machine name>.cloudstaging.incortalabs.com/incorta
  • Specify your correct tenant name
  • Provide the complete SQLx connection string

Troubleshooting

  • If OAuth authentication fails, verify the authorization server base URL matches in both CMC API Security and tenant JDBC settings.
  • Ensure the Analytics service has been restarted after enabling JDBC OAuth.
  • Confirm network access from your cluster and from your AI client to the authorization server URL.

Revision history

Reformatted and clarified steps. Fixed typos and made URLs consistent. Added prerequisites and troubleshooting sections.