DOCS
DOCS
  • Writing Queries
  • Creating Charts
  • SQL Reference Guide
  • Uploading Data
  • Discovering Data
  • MCP Integrations
  • Getting Started

Connecting to the Baselight MCP Server

Baselight’s MCP (Model Context Protocol) server lets you seamlessly integrate your favorite applications with the Baselight platform. By connecting to the MCP server, you can browse, discover, and query datasets directly from your preferred environment—whether you’re building, analyzing, or exploring.

This guide walks you through the simple setup process, so you can start working with structured data from Baselight without leaving your tool of choice.

Two ways to connect

You can authenticate with Baselight using either method:

  • Account Sign-in (OAuth): Sign in with your Baselight account directly through your AI tool. This is the quickest way to get started and requires no additional setup outside of your preferred application.
  • API Key: Generate a secure API key from your Baselight account settings and configure it in your tool. This approach is ideal for advanced users, developers, and multi-tool workflows where you want explicit control over credentials.

Both methods provide the same access to all your datasets and queries. Choose the one that best fits your tooling and workflow.

We provide instructions for some popular tools below, but Baselight should work with any tool able to connect to MCP.

ChatGPT (Web)

To use Baselight via ChatGPT, always make sure that the Developer Mode is enabled, which is currently available in beta to Pro, Plus, Business, Enterprise and Education accounts. 

  1. Start by signing in to baselight.app
  2. In ChatGPT, navigate to the Settings menu and select Apps and Connectors
  3. Check Advanced Settings and make sure that Developer mode is enabled (MCP is still in Beta in ChatGPT)
  4. Go back to the Apps and Connectors screen, and next to Enabled connectors click the Create button
  5. Provide a Name for the tool (ideally Baselight) and a description (optional)
  6. In the MCP Server URL field, paste the following: https://api.baselight.app/mcp
  7. Make sure that OAuth is selected in the Authentication field
  8. Click the checkbox next to “I understand and want to continue” and hit Create
  9. In the Authorize Application Access screen you will see next, simply click Authorize
  10. Once authenticated, you’ll see a confirmation that Baselight is now connected and a screen with the configuration. 
  11. Baselight will now appear as an available tool in your conversations. You can use it by clicking the + button in the chat input field and then …More -> Baselight

Your ChatGPT account is now linked to your Baselight workspace. You can start querying datasets immediately in your next conversation. After configuring it via your browser, Baselight will also be available to you inside the ChatGPT desktop application.

Claude Pro/Max/Team (Web/Desktop)

Web connectors are available on Claude, Claude Desktop, and Claude Mobile (iOS and Android) for users with paid plans (Pro, Max, Team, or Enterprise)

Individual accounts

  1. Setup a paid Claude account (if you haven’t already)
  2. Click your name in the bottom-left corner and select Settings
  3. Scroll to the Connectors section
  4. Click “Add custom connector”.
  5. Enter the connector’s name: Baselight and URL: https://api.baselight.app/mcp
  6. In the Authorize Application Access screen you will see next, simply click Authorize
  7. You will be redirected to the Connectors with the Baselight connector active
  8. Ensure the Baselight prompt is selected when starting a new chat

Team accounts

Configuring Connectors for Teams and Enterprise plans requires two steps: adding a custom connector by the Owner of the account and connecting to it by the User.

Owner configuration

  1. When logged in as an Owner, click your name in the bottom-left corner and select Admin Settings
  2. Select to the Connectors section
  3. Click “Add custom connector”.
  4. Enter the connector’s name: Baselight and URL: https://api.baselight.app/mcp

User configuration

After the Owner adds Baselight to the available Connectors, all users from your Organization can connect to Baselight by following the steps below:

  1. Click your name in the bottom-left corner and select Settings
  2. Scroll to the Connectors section
  3. Next to the Baselight icon, click Connect
  4. In the Authorize Application Access screen you will see next, simply click Authorize
  5. You will be redirected to the Connectors with Baselight connector active
  6. Ensure the Baselight prompt is selected when starting a new chat

Claude Free (Desktop)

  1. Sign in to Baselight, click on your profile in the top-right corner, and navigate to Account Settings → Integrations. Click Generate New API Key, provide a name to help you identify its use, and save the key.
  2. Download the Baselight Claude Desktop extension.
  3. On the Claude desktop application, open the left sidebar, click your name, and go to Settings.
  4. Scroll to the bottom, click the Extensions section.
  5. Click Advanced Settings.
  6. Click Install Extension.
  7. Choose the downloaded baselight.dxt file and click Install.
  8. Enter the API key you generated on baselight.app and click Save.
  9. Enable the extension.
  10. (optional) Ensure the Baselight prompt is selected when starting a new chat. Click the plus (+) button, select Add from baselight, and pick baselight-initial-prompt.

Visual Studio Code

  1. Sign in to Baselight, click on your profile in the top-right corner, and navigate to Account Settings → Integrations. Click Generate New API Key, provide a name to help you identify its use, and save the key.
  2. Configure the MCP server in your settings.json by adding:

"mcp": {
  "servers": {
    "baselight": {
      "type": "http",
      "url": "https://api.baselight.app/mcp",
      "headers": { "x-api-key": "YOUR_API_KEY" }
    }
  }
}

You can find more details here.

Gemini CLI

  1. Sign in to Baselight, click on your profile in the top-right corner, and navigate to Account Settings → Integrations. Click Generate New API Key, provide a name to help you identify its use, and save the key.
  2. Add the following to your .gemini/settings.json:

{
  "mcpServers": {
    "baselight": {
      "httpUrl": "https://api.baselight.app/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

You can find more details here.

LibreChat

  1. Sign in to Baselight, click on your profile in the top-right corner, and navigate to Account Settings → Integrations. Click Generate New API Key, provide a name to help you identify its use, and save the key.
  2. Add the following to your librechat.yaml:

mcpServers:
  baselight:
    type: streamable-http
    url: "https://api.baselight.app/mcp"
    headers:
      x-api-key: "YOUR_API_KEY"
    timeout: 30000
    serverInstructions: true

You can find more details here.

Table of Contents