Keboola MCP Server

offiziell

Erstellen Sie robuste Daten-Workflows, Integrationen und Analysen auf einer einzigen intuitiven Plattform.

Dokumentation

Keboola MCP Server

Verbinden Sie Ihre KI-Agenten, MCP-Clients (Cursor, Claude, Windsurf, VS Code ...) und andere KI-Assistenten mit Keboola. Stellen Sie Daten, Transformationen, SQL-Abfragen und Job-Trigger bereit – ganz ohne Glue-Code. Liefern Sie Agenten die richtigen Daten, wann und wo sie sie benötigen.

Überblick

Der Keboola MCP Server ist eine Open-Source-Brücke zwischen Ihrem Keboola-Projekt und modernen KI-Tools. Er macht Keboola-Funktionen – wie Speicherzugriff, SQL-Transformationen und Job-Trigger – zu aufrufbaren Werkzeugen für Claude, Cursor, CrewAI, LangChain, Amazon Q und mehr.

Schnellstart
Lokale Einrichtung

Funktionen

Mit dem KI-Agenten und MCP Server können Sie:

Speicher: Tabellen direkt abfragen und Tabellen- oder Bucket-Beschreibungen verwalten
Komponenten: Extraktoren, Writer, Data Apps und Transformationskonfigurationen erstellen, auflisten und inspizieren
SQL: SQL-Transformationen in natürlicher Sprache erstellen
Jobs: Komponenten und Transformationen ausführen und Details zur Job-Ausführung abrufen
Flows: Workflow-Pipelines mit Conditional Flows und Orchestrator Flows erstellen und verwalten.
Data Apps: Keboola Streamlit Data Apps erstellen, bereitstellen und verwalten, die Ihre Abfragen über Speicherdaten anzeigen.
Metadaten: Projektdokumentation und Objektmetadaten in natürlicher Sprache durchsuchen, lesen und aktualisieren
Dev Branches: Sicher in Entwicklungsbranches außerhalb der Produktion arbeiten, wobei alle Operationen auf den ausgewählten Branch beschränkt sind.

🚀 Schnellstart: Remote MCP Server (Einfachster Weg)

Der einfachste Weg, den Keboola MCP Server zu nutzen, ist über unseren Remote MCP Server. Diese gehostete Lösung macht lokale Einrichtung, Konfiguration oder Installation überflüssig.

Was ist der Remote MCP Server?

Unser Remote-Server wird auf jedem mandantenfähigen Keboola-Stack gehostet und unterstützt OAuth-Authentifizierung. Sie können sich von jedem KI-Assistenten aus verbinden, der eine entfernte Streamable HTTP-Verbindung und OAuth-Authentifizierung unterstützt.

So verbinden Sie sich

Holen Sie sich Ihre Remote-Server-URL: Navigieren Sie zu Ihren Keboola-Projekteinstellungen → Tab MCP Server
Kopieren Sie die Server-URL: Sie sieht etwa so aus: https://mcp.<YOUR_REGION>.keboola.com/mcp
Konfigurieren Sie Ihren KI-Assistenten: Fügen Sie die URL in die MCP-Einstellungen Ihres KI-Assistenten ein
Authentifizieren Sie sich: Sie werden aufgefordert, sich mit Ihrem Keboola-Konto zu authentifizieren und Ihr Projekt auszuwählen

Unterstützte Clients

Cursor: Verwenden Sie die Schaltfläche „In Cursor installieren“ in den MCP-Server-Einstellungen Ihres Projekts oder klicken Sie auf diese Schaltfläche
Claude Desktop: Fügen Sie die Integration über Einstellungen → Integrationen hinzu
Claude Code: Installation mit claude mcp add --transport http keboola <URL> (Details siehe unten)
Windsurf: Konfiguration mit der Remote-Server-URL
Make: Konfiguration mit der Remote-Server-URL
Andere MCP-Clients: Konfiguration mit der Remote-Server-URL

Claude Code Einrichtung

Claude Code ist ein Kommandozeilen-Tool, mit dem Sie über Ihr Terminal mit Claude interagieren können. Sie können die Keboola MCP Server-Integration mit einem einfachen Befehl installieren.

Installation:

Führen Sie den folgenden Befehl in Ihrem Terminal aus und ersetzen Sie <YOUR_REGION> durch Ihre Keboola-Region:

claude mcp add --transport http keboola https://mcp.<YOUR_REGION>.keboola.com/mcp

Regionsspezifische Befehle:

Region	Installationsbefehl
US Virginia AWS	`claude mcp add --transport http keboola https://mcp.keboola.com/mcp`
US Virginia GCP	`claude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp`
EU Frankfurt AWS	`claude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp`
EU Ireland Azure	`claude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp`
EU Frankfurt GCP	`claude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp`

Verwendung:

Nach der Installation können Sie den Keboola MCP Server in Claude Code verwenden, indem Sie /mcp in Ihre Konversation eingeben und die Keboola-Tools auswählen, die Sie nutzen möchten.

Authentifizierung:

Wenn Sie den Keboola MCP Server zum ersten Mal in Claude Code verwenden, öffnet sich ein Browserfenster, in dem Sie aufgefordert werden:

Sich mit Ihrem Keboola-Konto anzumelden
Das Projekt auszuwählen, mit dem Sie sich verbinden möchten
Die Verbindung zu autorisieren

Nach der Authentifizierung können Sie Keboola-Tools direkt aus Claude Code heraus nutzen.

Detaillierte Einrichtungsanweisungen und regionsspezifische URLs finden Sie in unserer Remote Server Setup-Dokumentation.

Entwicklungsbranches verwenden

Sie können sicher in Keboola-Entwicklungsbranches arbeiten, ohne Ihre Produktionsdaten zu beeinträchtigen. Die remote gehosteten MCP-Server respektieren den Parameter KBC_BRANCH_ID und beschränken alle Operationen auf den angegebenen Branch. Die Entwicklungsbranch-ID finden Sie in der URL, wenn Sie in der Benutzeroberfläche zum Entwicklungsbranch navigieren, zum Beispiel: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. Die Branch-ID muss in jeder Anfrage über den Header X-Branch-Id: <branchId> enthalten sein, andernfalls verwendet der MCP-Server standardmäßig den Produktionsbranch. Dies sollte vom KI-Client oder der Umgebung verwaltet werden, die die Serververbindung handhabt.

Tool-Autorisierung und Zugriffskontrolle

Bei Verwendung HTTP-basierter Transporte (Streamable HTTP) können Sie über HTTP-Header steuern, welche Tools für Clients verfügbar sind. Dies ist nützlich, um die Fähigkeiten von KI-Agenten einzuschränken oder Compliance-Richtlinien durchzusetzen.

Autorisierungs-Header

Header	Beschreibung	Beispiel
`X-Allowed-Tools`	Kommagetrennte Liste erlaubter Tools	`get_configs,get_buckets,query_data`
`X-Disallowed-Tools`	Kommagetrennte Liste auszuschließender Tools	`create_config,run_job`
`X-Read-Only-Mode`	Nur auf schreibgeschützte Tools beschränken	`true`, `1` oder `yes`

Filterverhalten

Filter werden in dieser Reihenfolge angewendet: erlaubt → Schnittmenge mit schreibgeschützt → Ausschluss unerwünschter. Leere Header = keine Einschränkung.

Schreibgeschützte Tools

Schreibgeschützte Tools sind solche, die mit readOnlyHint=True annotiert sind. Diese Tools rufen nur Informationen ab, ohne Änderungen an Ihrem Keboola-Projekt vorzunehmen. Die aktuelle Liste der schreibgeschützten Tools finden Sie in der Datei TOOLS.md, die einen automatisch generierten Snapshot des tatsächlichen Tool-Sets darstellt.

Beispiel: Schreibgeschützter Zugriff

X-Read-Only-Mode: true

Detaillierte Dokumentation finden Sie unter developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.

Lokale MCP Server Einrichtung (Individueller oder Entwickler-Weg)

Führen Sie den MCP-Server auf Ihrem eigenen Rechner aus, um volle Kontrolle und einfache Entwicklung zu haben. Wählen Sie diesen Weg, wenn Sie Tools anpassen, lokal debuggen oder schnell iterieren möchten. Sie klonen das Repository, setzen Keboola-Anmeldeinformationen über Umgebungsvariablen oder Header (abhängig vom Server-Transport), installieren Abhängigkeiten und starten den Server. Dieser Ansatz bietet maximale Flexibilität (benutzerdefinierte Tools, lokales Logging, Offline-Iteration), erfordert jedoch manuelle Einrichtung und Sie verwalten Updates und Geheimnisse selbst.

Der Server unterstützt mehrere Transport-Optionen, die durch Angabe des Arguments --transport <transport> beim Starten des Servers ausgewählt werden können:

stdio – Standard, wenn --transport nicht angegeben ist. Standard-Ein-/Ausgabe, typischerweise für lokale Bereitstellung mit einem einzelnen Client verwendet.
streamable-http – Führt den Server remote über HTTP mit einem bidirektionalen Streaming-Kanal aus, sodass Client und Server kontinuierlich Nachrichten austauschen können. Verbindung über /mcp (z. B. http://localhost:8000/mcp).
http-compat – Ein Alias für streamable-http, aus Gründen der Abwärtskompatibilität beibehalten.

Für die Client-Server-Kommunikation müssen Keboola-Anmeldeinformationen bereitgestellt werden, um die Arbeit mit Ihrem Projekt in Ihrer Keboola-Region zu ermöglichen. Folgendes ist erforderlich: KBC_STORAGE_TOKEN, KBC_STORAGE_API_URL, KBC_WORKSPACE_SCHEMA und optional KBC_BRANCH_ID. Sie können diese auf zwei Arten bereitstellen:

Für den persönlichen Gebrauch (hauptsächlich mit stdio-Transport): Setzen Sie die Umgebungsvariablen, bevor Sie den Server starten. Alle Anfragen verwenden diese vordefinierten Anmeldeinformationen wieder.
Für die Mehrbenutzernutzung: Fügen Sie die Variablen in die Anfrage-Header ein, sodass jede Anfrage die mitgelieferten Anmeldeinformationen verwendet.

KBC_STORAGE_TOKEN

Dies ist Ihr Authentifizierungstoken für Keboola:

Anweisungen zum Erstellen und Verwalten von Storage-API-Tokens finden Sie in der offiziellen Keboola-Dokumentation.

Hinweis: Wenn der MCP-Server eingeschränkten Zugriff haben soll, verwenden Sie ein benutzerdefiniertes Storage-Token; wenn der MCP auf alles in Ihrem Projekt zugreifen soll, verwenden Sie das Master-Token.

KBC_WORKSPACE_SCHEMA

Dies identifiziert Ihren Workspace in Keboola und wird für SQL-Abfragen verwendet. Dies ist jedoch nur erforderlich, wenn Sie ein benutzerdefiniertes Storage-Token anstelle des Master-Tokens verwenden:

Bei Verwendung des Master-Tokens: Der Workspace wird automatisch im Hintergrund erstellt
Bei Verwendung eines benutzerdefinierten Storage-Tokens: Befolgen Sie diese Keboola-Anleitung, um Ihr KBC_WORKSPACE_SCHEMA zu erhalten

Hinweis: Wenn Sie einen Workspace manuell erstellen, aktivieren Sie die Option „Schreibgeschützten Zugriff auf alle Projektdaten gewähren“

Hinweis: KBC_WORKSPACE_SCHEMA wird in BigQuery-Workspaces als Dataset-Name bezeichnet; Sie klicken einfach auf „Verbinden“ und kopieren den Dataset-Namen

KBC_STORAGE_API_URL (Keboola-Region)

Ihre Keboola-Region-API-URL hängt von Ihrer Bereitstellungsregion ab. Sie können Ihre Region bestimmen, indem Sie in Ihrem Browser auf die URL schauen, wenn Sie in Ihrem Keboola-Projekt angemeldet sind:

Region	API-URL
AWS Nordamerika	`https://connection.keboola.com`
AWS Europa	`https://connection.eu-central-1.keboola.com`
Google Cloud EU	`https://connection.europe-west3.gcp.keboola.com`
Google Cloud US	`https://connection.us-east4.gcp.keboola.com`
Azure EU	`https://connection.north-europe.azure.keboola.com`

KBC_BRANCH_ID (Optional)

Um auf einem bestimmten Keboola-Entwicklungsbranch zu arbeiten, setzen Sie die Branch-ID mit dem Parameter KBC_BRANCH_ID. Der MCP-Server beschränkt seine Funktionalität auf den angegebenen Branch und stellt sicher, dass alle Änderungen isoliert bleiben und den Produktionsbranch nicht beeinträchtigen.

Wenn nicht angegeben, verwendet der Server standardmäßig den Produktionsbranch.
Für Entwicklungsarbeiten setzen Sie KBC_BRANCH_ID auf die numerische ID Ihres Branches (z. B. 123456). Die Entwicklungsbranch-ID finden Sie in der URL, wenn Sie in der Benutzeroberfläche zum Entwicklungsbranch navigieren, zum Beispiel: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
Bei Remote-Transporten können Sie dies pro Anfrage mit dem HTTP-Header X-Branch-Id: <branchId> oder KBC_BRANCH_ID: <branchId> überschreiben.

Installation

Stellen Sie sicher, dass Sie Folgendes haben:

Python 3.10+ installiert
Zugriff auf ein Keboola-Projekt mit Administratorrechten
Ihren bevorzugten MCP-Client (Claude, Cursor usw.)

Hinweis: Stellen Sie sicher, dass uv installiert ist. Der MCP-Client verwendet es, um den Keboola MCP Server automatisch herunterzuladen und auszuführen. uv installieren:

macOS/Linux:

#if homebrew is not installed on your machine use:
# /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install using Homebrew
brew install uv

Windows:

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

Weitere Installationsoptionen finden Sie in der offiziellen uv-Dokumentation.

Keboola MCP Server ausführen

Es gibt vier Möglichkeiten, den Keboola MCP Server zu nutzen, je nach Ihren Anforderungen:

Option A: Integrierter Modus (Empfohlen)

In diesem Modus startet Claude oder Cursor den MCP-Server automatisch für Sie. Sie müssen keine Befehle in Ihrem Terminal ausführen.

Konfigurieren Sie Ihren MCP-Client (Claude/Cursor) mit den entsprechenden Einstellungen
Der Client startet den MCP-Server automatisch bei Bedarf

Claude Desktop Konfiguration

Gehen Sie zu Claude (oben links auf Ihrem Bildschirm) -> Einstellungen → Entwickler → Konfiguration bearbeiten (wenn Sie die claude_desktop_config.json nicht sehen, erstellen Sie sie)
Fügen Sie die folgende Konfiguration hinzu:
Starten Sie Claude Desktop neu, damit die Änderungen wirksam werden

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Speicherorte der Konfigurationsdatei:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor Konfiguration

Gehen Sie zu Einstellungen → MCP
Klicken Sie auf „+ Neuen globalen MCP-Server hinzufügen“
Konfigurieren Sie mit diesen Einstellungen:

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": ["keboola_mcp_server --transport <transport>"],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Hinweis: Verwenden Sie kurze, beschreibende Namen für MCP-Server. Da der vollständige Tool-Name den Servernamen enthält und unter ~60 Zeichen bleiben muss, können längere Namen in Cursor herausgefiltert und dem Agenten nicht angezeigt werden.

Cursor Konfiguration für Windows WSL

Wenn Sie den MCP-Server aus dem Windows-Subsystem für Linux mit Cursor AI ausführen, verwenden Sie diese Konfiguration:

{
  "mcpServers": {
    "keboola":{
      "command": "wsl.exe",
      "args": [
          "bash",
          "-c '",
          "export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com &&",
          "export KBC_STORAGE_TOKEN=your_keboola_storage_token &&",
          "export KBC_WORKSPACE_SCHEMA=your_workspace_schema &&",
          "export KBC_BRANCH_ID=your_branch_id_optional &&",
          "/snap/bin/uvx keboola_mcp_server --transport <transport>",
          "'"
      ]
    }
  }
}

Option B: Lokaler Entwicklungsmodus

Für Entwickler, die am MCP-Server-Code selbst arbeiten:

Repository klonen und eine lokale Umgebung einrichten
Claude/Cursor so konfigurieren, dass Ihr lokaler Python-Pfad verwendet wird:

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m",
        "keboola_mcp_server --transport <transport>"
      ],
      "env": {
        "KBC_STORAGE_API_URL": "https://connection.YOUR_REGION.keboola.com",
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",
        "KBC_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

Option C: Manueller CLI-Modus (Nur zum Testen)

Sie können den Server manuell in einem Terminal ausführen, um zu testen oder zu debuggen:

# Set environment variables
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
export KBC_BRANCH_ID=your_branch_id_optional

uvx keboola_mcp_server --transport streamable-http

Hinweis: Dieser Modus ist hauptsächlich zum Debuggen oder Testen gedacht. Für die normale Nutzung mit Claude oder Cursor müssen Sie den Server nicht manuell starten.

Hinweis: Der Server verwendet den Streamable HTTP-Transport und lauscht auf localhost:8000 für eingehende Verbindungen unter /mcp. Sie können die Parameter --port und --host verwenden, um ihn woanders lauschen zu lassen.

Option D: Docker verwenden

docker pull keboola/mcp-server:latest

docker run \
  --name keboola_mcp_server \
  --rm \
  -it \
  -p 127.0.0.1:8000:8000 \
  -e KBC_STORAGE_API_URL="https://connection.YOUR_REGION.keboola.com" \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  -e KBC_BRANCH_ID="YOUR_BRANCH_ID_OPTIONAL" \
  keboola/mcp-server:latest \
  --transport streamable-http \
  --host 0.0.0.0

Hinweis: Der Server verwendet den Streamable HTTP-Transport und lauscht auf localhost:8000 für eingehende Verbindungen unter /mcp. Sie können -p ändern, um den Port des Containers woanders hin zu mappen.

Muss ich den Server selbst starten?

Szenario	Manuell ausführen?	Diese Einrichtung verwenden
Claude/Cursor verwenden	Nein	MCP in den App-Einstellungen konfigurieren
MCP lokal entwickeln	Nein (Claude startet ihn)	Konfiguration auf Python-Pfad verweisen
CLI manuell testen	Ja	Terminal zum Ausführen verwenden
Docker verwenden	Ja	Docker-Container ausführen

MCP-Server verwenden

Sobald Ihr MCP-Client (Claude/Cursor) konfiguriert ist und läuft, können Sie beginnen, Ihre Keboola-Daten abzufragen:

Einrichtung überprüfen

Sie können mit einer einfachen Abfrage beginnen, um zu bestätigen, dass alles funktioniert:

What buckets and tables are in my Keboola project?

Beispiele, was Sie tun können

Datenexploration:

"Welche Tabellen enthalten Kundeninformationen?"
"Führen Sie eine Abfrage aus, um die Top-10-Kunden nach Umsatz zu finden"

Datenanalyse:

"Analysieren Sie meine Verkaufsdaten nach Region für das letzte Quartal"
"Finden Sie Korrelationen zwischen Kundenalter und Kaufhäufigkeit"

Datenpipelines:

"Erstellen Sie eine SQL-Transformation, die Kunden- und Bestelltabellen verbindet"
"Starten Sie den Datenextraktionsjob für meine Salesforce-Komponente"

Kompatibilität

MCP-Client-Unterstützung

MCP-Client	Unterstützungsstatus	Verbindungsmethode
Claude (Desktop & Web)	✅ unterstützt	stdio
Cursor	✅ unterstützt	stdio
Windsurf, Zed, Replit	✅ Unterstützt	stdio
Codeium, Sourcegraph	✅ Unterstützt	Streamable HTTP
Benutzerdefinierte MCP-Clients	✅ Unterstützt	Streamable HTTP oder stdio

Unterstützte Werkzeuge

Hinweis: Ihre KI-Agenten passen sich automatisch an neue Werkzeuge an.

Eine vollständige Liste der verfügbaren Werkzeuge mit detaillierten Beschreibungen, Parametern und Anwendungsbeispielen finden Sie in TOOLS.md.

Fehlerbehebung

Häufige Probleme

Problem	Lösung
Authentifizierungsfehler	Überprüfen Sie, ob `KBC_STORAGE_TOKEN` gültig ist
Workspace-Probleme	Bestätigen Sie, dass `KBC_WORKSPACE_SCHEMA` korrekt ist
Verbindungs-Timeout	Überprüfen Sie die Netzwerkkonnektivität

Entwicklung

Installation

Grundlegende Einrichtung:

uv sync --extra dev

Mit der grundlegenden Einrichtung können Sie uv run tox verwenden, um Tests auszuführen und den Code-Stil zu überprüfen.

Empfohlene Einrichtung:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

Mit der empfohlenen Einrichtung werden Pakete zum Testen und zur Code-Stil-Überprüfung installiert, was es IDEs wie VsCode oder Cursor ermöglicht, den Code während der Entwicklung zu überprüfen oder Tests auszuführen.

Integrationstests

Um Integrationstests lokal auszuführen, verwenden Sie uv run tox -e integtests. HINWEIS: Sie müssen die folgenden Umgebungsvariablen setzen:

INTEGTEST_POOL_STORAGE_API_URL
INTEGTEST_STORAGE_TOKENS
INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Um diese Werte zu erhalten, benötigen Sie dedizierte Keboola-Projekte für Integrationstests. Jede Testsitzung erstellt ihren eigenen schreibgeschützten Workspace, sodass kein Workspace-Schema konfiguriert werden muss. Siehe integtests/README.md für detaillierte Einrichtungsanweisungen und Designdokumentation.

`uv.lock` aktualisieren

Aktualisieren Sie die uv.lock-Datei, wenn Sie Abhängigkeiten hinzugefügt oder entfernt haben. Erwägen Sie auch, den Lock mit neueren Abhängigkeitsversionen zu aktualisieren, wenn Sie ein Release erstellen (uv lock --upgrade).

Werkzeugdokumentation aktualisieren

Wenn Sie Änderungen an Werkzeugbeschreibungen (Docstrings in Werkzeugfunktionen) vornehmen, müssen Sie die TOOLS.md-Dokumentationsdatei neu generieren, um diese Änderungen widerzuspiegeln:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Releasing

Wir erstellen kein Release für jeden gemergten PR. Arbeit landet kontinuierlich auf dem Trunk (main), und wir veröffentlichen periodisch, sobald Änderungen gemeinsam erneut getestet wurden — dies vermeidet, dass funktionierende Setups für Benutzer kaputtgehen.

Ein Release wird durch das Pushen von einem oder zwei Git-Tags erstellt:

vX.Y.Z — das MCP-Server-Release (immer)
agent-vX.Y.Z — das In-Platform-Agent-Release (nur wenn der Agent ebenfalls veröffentlicht wird)

Jeder Tag löst release.yml CI aus, die das Docker-Image baut und veröffentlicht. KaiBench läuft nur auf Produktions-vX.Y.Z-Tags (nicht agent-vX.Y.Z und nicht -dev.-Vorabversionen). Verwenden Sie den release-notes-Skill — er bereitet die Release-Notes und den Draft-PR vor und führt durch das Tagging von sowohl vX.Y.Z als auch agent-vX.Y.Z.

Support und Feedback

⭐ Der primäre Weg, um Hilfe zu erhalten, Fehler zu melden oder Funktionen anzufordern, ist das Eröffnen eines Issues auf GitHub. ⭐

Das Entwicklungsteam überwacht Issues aktiv und wird so schnell wie möglich antworten. Für allgemeine Informationen über Keboola nutzen Sie bitte die untenstehenden Ressourcen.

Ressourcen

Benutzerdokumentation
Entwicklerdokumentation
Keboola-Plattform
Issue-Tracker ← Primäre Kontaktmethode für den MCP-Server

Keboola MCP Server

Dokumentation

Keboola MCP Server

Überblick

Funktionen

🚀 Schnellstart: Remote MCP Server (Einfachster Weg)

Was ist der Remote MCP Server?

So verbinden Sie sich

Unterstützte Clients

Claude Code Einrichtung

Entwicklungsbranches verwenden

Tool-Autorisierung und Zugriffskontrolle

Autorisierungs-Header

Filterverhalten

Schreibgeschützte Tools

Beispiel: Schreibgeschützter Zugriff

Lokale MCP Server Einrichtung (Individueller oder Entwickler-Weg)

KBC_STORAGE_TOKEN

KBC_WORKSPACE_SCHEMA

KBC_STORAGE_API_URL (Keboola-Region)

KBC_BRANCH_ID (Optional)

Installation

Keboola MCP Server ausführen

Option A: Integrierter Modus (Empfohlen)

Claude Desktop Konfiguration

Cursor Konfiguration

Cursor Konfiguration für Windows WSL

Option B: Lokaler Entwicklungsmodus

Option C: Manueller CLI-Modus (Nur zum Testen)

Option D: Docker verwenden

Muss ich den Server selbst starten?

MCP-Server verwenden

Einrichtung überprüfen

Beispiele, was Sie tun können

Kompatibilität

MCP-Client-Unterstützung

Unterstützte Werkzeuge

Fehlerbehebung

Häufige Probleme

Entwicklung

Installation

Integrationstests

uv.lock aktualisieren

Werkzeugdokumentation aktualisieren

Releasing

Support und Feedback

Ressourcen

Vernetzen

`uv.lock` aktualisieren