Skip to main content
Connect Claude Code or Claude Desktop to your Definite data using the Model Context Protocol (MCP). Query databases, run semantic layer queries, and explore your data schema directly from Claude.

​
Quick Start

​
Claude Code CLI

1

HTTP Transport (recommended)If your client supports HTTP transport, use this for increased reliability:
claude mcp add --transport http definite-api \
  https://api.definite.app/v3/mcp/http \
  --header "Authorization: YOUR_API_KEY"
2

SSE Transport (alternative)If HTTP transport isn’t supported, use SSE:
claude mcp add --transport sse definite-api \
  https://api.definite.app/v3/mcp/sse \
  --header "Authorization: YOUR_API_KEY"
3

Verify the connection
claude mcp list

​
Claude Desktop

1

Open Settings → Developer → Edit Config
2

Add the following configuration:HTTP Transport (recommended):
{
  "mcpServers": {
    "definite": {
      "transport": "http",
      "url": "https://api.definite.app/v3/mcp/http",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}
SSE Transport (alternative):
{
  "mcpServers": {
    "definite": {
      "transport": "sse",
      "url": "https://api.definite.app/v3/mcp/sse",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}
3

Save and restart Claude Desktop

​
Import from Claude Desktop

If you’ve already configured Claude Desktop, import the settings to Claude Code: 
claude mcp add-from-claude-desktop

​
Authentication

Get your API key from Definite Settings. Replace YOUR_API_KEY with your actual key.
API key format: sk_live_... or sk_test_...

​
Available Tools

Once connected, Claude can interact with your Definite data using these tools:
  • run_sql_query - Execute SQL queries against your databases
  • run_cube_query - Query your semantic layer using Cube
  • search_cube_schema - Discover available cubes, dimensions, and measures

​
Troubleshooting

Connection fails
  • Verify your API key is valid and not expired
  • Check that you have the correct permissions
  • Ensure you’re using the correct transport (HTTP or SSE)
Connection timeout or session errors The connection may have timed out. Restart Claude Code or Claude Desktop to reconnect. For persistent issues, try switching between HTTP and SSE transports. Remove the server 
claude mcp remove definite-api

​
Support

For issues or questions, contact hello@definite.app or visit docs.definite.app.