1. Home
  2. AI Features
  3. MCP Server

Keboola Model Context Protocol (MCP) Server

Connect your MCP clients and AI assistants to your Keboola Project and give them the powers of a Keboola Expert user:

  • Cursor - Direct deeplink installation
  • Claude - Organization-level integration
  • Windsurf - Plugin store or manual configuration
  • VS Code - Agent mode with MCP servers
  • Make - Agent mode with MCP servers
  • Other clients - Remote server connection

Query data, create transformations, write SQL queries, and build your pipelines — all with no clicks required.

Overview

Keboola’s MCP Server brings powerful AI agents like Claude and Cursor directly into your data workflows. Just describe what you need in plain language to:

  • Search and explore your data.
  • Set up and manage workflows — no code required.
  • Build SQL queries and transformations using AI.
  • Launch and monitor jobs in real time.
  • Automatically document everything — down to the column level.

Business Use Cases:

  • Analyze customer orders, segment users, or monitor campaign performance — just by describing what you need, your assistant will query the data in your project directly.
  • Instantly get data from any system (CRM, ERP, ads) without touching the UI.
  • Update and run data pipelines before key meetings — no technical help required.
  • Automatically generate clear, human-readable descriptions down to the column level for full data transparency.

Claude debug error flow in MCP Server

Connecting to Keboola’s MCP Server

Keboola MCP Server is hosted on every multi-tenant stack and supports OAuth authentication. You can use the remote server in any AI Assistant that supports remote Streamable HTTP connection and OAuth authentication.

Remote Server Setup

In case your AI assistant supports remote connection, you can connect to Keboola’s MCP Server by following these steps:

  1. Obtain the remote server URL of the stack https://mcp.<YOUR_REGION>.keboola.com/mcp.
    • Available stack URLs:
      • https://mcp.keboola.com/mcp
      • https://mcp.us-east4.gcp.keboola.com/mcp
      • https://mcp.eu-central-1.keboola.com/mcp
      • https://mcp.north-europe.azure.keboola.com/mcp
      • https://mcp.europe-west3.gcp.keboola.com/mcp
    • You can find the url in your Keboola Project Settings under the tab MCP Server
      • In there you can also find specific instructions for various clients.
  2. Copy the server URL and paste it into your AI assistant’s settings.
  3. Once you save the settings and refresh your AI assistant, you will be prompted to authenticate with your Keboola account and select the project you want to connect to.

For other options of local deployments see the Developers Documentation.

Using with Claude Desktop

These steps must be done by a Claude organization owner or primary owner, or on either a Claude Pro or Claude Max plan. The added integration will be available to all users in the Claude organization, but each user will still be required to authenticate themselves separately.

  • Go to Settings > Integrations
  • Click the “Add more” button
  • Give the integration a name (Keboola) and paste in your Integration URL
    • https://mcp.<YOUR_REGION>.keboola.com/mcp
  • Click “Add”
  • You’ll be prompted to authenticate with your Keboola account and select the project you want to connect to.

Via mcp-remote adapter

If you don’t have a paid version you can still use the mcp-remote adapter to connect Claude Desktop to Keboola’s MCP Server.

NOTE: This method requires you to have Node.js installed on your computer. For more information refer to the Developers Documentation

  1. Open the Claude menu on your computer and select “Settings…”
  2. Click on “Developer” in the left-hand bar of the Settings pane, and then click on “Edit Config”
  3. Paste the following JSON into the config file and save. 
    {
  "mcpServers": {
 "keboola": {
   "command": "npx",
   "args": [
     "mcp-remote",
     "https://mcp.<YOUR_REGION>.keboola.com/mcp"
   ]
 }
  }
}
  4. Restart Claude Desktop, you’ll be prompted to authenticate with your Keboola account and select the project you want to connect to.

Using with Cursor

Click the button related to your region below:

Stack (Region) Cursor Deeplink
US Virginia AWS (default) Add to Cursor
US Virginia GCP (us-east4) Add to Cursor
EU Frankfurt AWS (eu-central-1) Add to Cursor
EU Ireland Azure (north-europe) Add to Cursor
EU Frankfurt GCP (europe-west3) Add to Cursor

Alternatively, you can:

  1. Navigate to Keboola project settings, click Users & Settings > MCP Server.
  2. Click the Cursor tab.
  3. Click the “Install In Cursor” button.
  4. You’ll be prompted to login into your Keboola account and select the project you want to connect to.

Using with Windsurf

Windsurf supports MCP through its native integration with Cascade. You can add Keboola’s MCP Server in two ways:

  1. Open the Windsurf settings and navigate to Cascade > Plugins
  2. Click on “Add MCP Plugin” or edit the mcp_config.json file directly
  3. Add the Keboola MCP Server configuration:
{
  "mcpServers": {
    "keboola": {
      "serverUrl": "https://mcp.<YOUR_REGION>.keboola.com/mcp"
    }
  }
}
  1. Replace <YOUR_REGION> with your specific stack URL from the available stack URLs
  2. Press the refresh button after adding the configuration
  3. You’ll be prompted to authenticate with your Keboola account and select the project

For detailed instructions and troubleshooting, see the Windsurf MCP documentation.

Using with VS Code

VS Code supports MCP servers through GitHub Copilot’s agent mode. Follow these steps to set up Keboola’s MCP Server:

Prerequisites

  • VS Code with GitHub Copilot extension installed
  • GitHub Copilot subscription (Pro, Business, or Enterprise)

Setup Instructions

  1. Open VS Code and ensure you have the latest version of the GitHub Copilot extension
  2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run “MCP: Configure Servers”
  3. This will create or open your MCP configuration file (mcp.json)
  4. Add the Keboola MCP Server configuration:
{
  "servers": {
    "keboola": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.<YOUR_REGION>.keboola.com/mcp"
      ]
    }
  }
}
  1. Replace <YOUR_REGION> with your specific stack URL from the available stack URLs
  2. Save the configuration file
  3. Restart VS Code or run “MCP: Restart Servers” from the Command Palette
  4. You’ll be prompted to authenticate with your Keboola account and select the project

Using MCP Tools in VS Code

  • Open the Chat view and enable agent mode
  • Select the Tools button to see available Keboola tools
  • Use # in your chat to reference specific tools or resources
  • The tools will be available with up to 128 tools per request

For detailed setup and troubleshooting, see the VS Code MCP documentation.

Using with MAKE

  1. Create your scenario in MAKE.
  2. Use the MCP Client component within the scenario.
  3. In the dropdown of the MCP Client, select Keboola.
  4. Navigate to Keboola project settings, click Users & Settings > MCP Server.
  5. Click the MAKE tab.
  6. Copy the integration URL displayed there into the MCP Client configuration in MAKE.

Available Tools

Keboola’s MCP Server comes with a rich set of tools your AI client (like Claude or Cursor) can use to interact with your data environment — just by asking in plain language. Don’t worry about remembering command names — your AI client handles that. Just describe what you want to do.

  • Components & Transformations – Create, edit, and launch them with natural language.
  • Storage – Browse, edit, and document buckets, tables, and columns.
  • SQL – Run and manage SQL queries (BigQuery not supported).
  • Jobs – Start, monitor, and debug execution flows.
  • Documentation – Search official Keboola docs from within your AI chat.

Advanced Setup Options

These methods are for developers or specific use cases (e.g., testing, contributing to the MCP server). For CLI control, dev environments, or contributing to the MCP Server, check out the MCP GitHub repo.

Support and Feedback

Need help or want to contribute? Open an issue on GitHub to report bugs, request features, or suggest improvements. We’d love your ideas, fixes, and feedback to make MCP even better.

Don't forget to give us a star on GitHub!