Keboola

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 – ohne Klebecode. Liefern Sie den Agenten die richtigen Daten, wann und wo sie sie benötigen.

Überblick

Keboola MCP Server ist eine Open-Source-Brücke zwischen Ihrem Keboola-Projekt und modernen KI-Tools. Es verwandelt Keboola-Funktionen – wie Speicherzugriff, SQL-Transformationen und Job-Trigger – in aufrufbare Tools 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 mit natürlicher Sprache erstellen
• Jobs: Komponenten und Transformationen ausführen und Job-Ausführungsdetails 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 mit natürlicher Sprache suchen, lesen und aktualisieren
• Entwicklungszweige: Sicher in Entwicklungszweigen außerhalb der Produktion arbeiten, wobei alle Operationen auf den ausgewählten Zweig beschränkt sind

---

🚀 Schnellstart: Remote MCP Server (Einfachster Weg)

Der einfachste Weg, 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 Multi-Tenant-Keboola-Stack gehostet und unterstützt OAuth-Authentifizierung. Sie können sich von jedem KI-Assistenten verbinden, der Remote-Streamable-HTTP-Verbindungen und OAuth-Authentifizierung unterstützt.

So verbinden Sie sich

1. Holen Sie sich Ihre Remote-Server-URL: Navigieren Sie zu Ihren Keboola-Projekteinstellungen → Registerkarte MCP Server
2. Kopieren Sie die Server-URL: Sie sieht aus wie https://mcp.<YOUR_REGION>.keboola.com/mcp
3. Konfigurieren Sie Ihren KI-Assistenten: Fügen Sie die URL in die MCP-Einstellungen Ihres KI-Assistenten ein
4. Authentifizieren Sie sich: Sie werden aufgefordert, sich mit Ihrem Keboola-Konto anzumelden. Welches Projekt bzw. welche Projekte bearbeitet werden sollen, wird anschließend im Gespräch gewählt (z. B. „liste meine Keboola-Projekte auf“ / „verwende Projekt X“)

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: Installieren Sie mit claude mcp add --transport http keboola <URL> (Details siehe unten)
• Windsurf: Konfigurieren Sie mit der Remote-Server-URL
• Make: Konfigurieren Sie mit der Remote-Server-URL
• Andere MCP-Clients: Konfigurieren Sie mit der Remote-Server-URL

Claude Code Einrichtung

Claude Code ist ein Befehlszeilentool, 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 Irland 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 Ihr Gespräch eingeben und die Keboola-Tools auswählen, die Sie verwenden 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:

1. Sich mit Ihrem Keboola-Konto anzumelden
2. Die Verbindung zu autorisieren

Nach der Authentifizierung können Sie Keboola-Tools direkt aus Claude Code verwenden. Die Projektauswahl erfolgt anschließend im Gespräch – fragen Sie einfach Claude, welche Keboola-Projekte verwendet werden sollen.

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

Verwendung von Entwicklungszweigen

Sie können sicher in Keboola-Entwicklungszweigen 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 Zweig. Die Entwicklungszweig-ID finden Sie in der URL, wenn Sie in der Benutzeroberfläche zum Entwicklungszweig navigieren, z. B.: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. Die Zweig-ID muss in jeder Anfrage über den Header X-Branch-Id: <branchId> enthalten sein, andernfalls verwendet der MCP-Server standardmäßig den Produktionszweig. Dies sollte vom KI-Client oder der Umgebung verwaltet werden, die die Serververbindung verarbeitet.

Tool-Autorisierung und Zugriffskontrolle

Bei Verwendung von HTTP-basierten Transports (Streamable HTTP) können Sie steuern, welche Tools Clients über HTTP-Header zur Verfügung stehen. Dies ist nützlich, um KI-Agentenfähigkeiten einzuschränken oder Compliance-Richtlinien durchzusetzen.

Autorisierungs-Header

Header	Beschreibung	Beispiel
X-Allowed-Tools	Kommagetrennte Liste der erlaubten Tools	get_configs,get_buckets,query_data
X-Disallowed-Tools	Kommagetrennte Liste der auszuschließenden 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 → schreibgeschützte Schnittmenge → Ausschluss. 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 eine automatisch generierte Momentaufnahme des tatsächlichen Tool-Sets ist.

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 (Benutzerdefinierter oder Entwicklerweg)

Führen Sie den MCP-Server auf Ihrem eigenen Rechner aus, für volle Kontrolle und einfache Entwicklung. Wählen Sie dies, wenn Sie Tools anpassen, lokal debuggen oder schnell iterieren möchten. Sie installieren den Server, authentifizieren sich (ein einmaliger Browser-Login – kein Token zum Einfügen) und starten ihn. Dieser Ansatz bietet maximale Flexibilität (benutzerdefinierte Tools, lokale Protokollierung, 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-Eingabe/-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. Verbinden Sie sich über /mcp (z. B. http://localhost:8000/mcp).
• http-compat - Ein Alias für streamable-http, aus Gründen der Abwärtskompatibilität beibehalten.

Um mit Ihrem Keboola-Projekt zu arbeiten, benötigt der Server zwei Dinge: Ihre Keboola-Region (KBC_STORAGE_API_URL) und eine Möglichkeit zur Authentifizierung. Der empfohlene Weg ist ein einmaliger Browser-Login – Sie erstellen, kopieren oder fügen nie ein Token ein. Optional können Sie KBC_BRANCH_ID setzen, um in einem Entwicklungszweig zu arbeiten.

Einige der Variablen werden nicht aus den Anfrage-Headern übernommen:

• KBC_STORAGE_API_URL: Ein Server, der mit seiner eigenen Storage-API-URL gestartet wurde (der Parameter --api-url oder die Umgebungsvariable KBC_STORAGE_API_URL), bedient nur diesen einen Keboola-Stack. Ein X-Storage-Api-Url-Header, der einen anderen Host anfordert, wird ignoriert (eine Warnung wird protokolliert) – der Server behält seine eigene URL für die Anfrage. Starten Sie den Server ohne eigene Storage-API-URL, wenn jede Anfrage ihren Stack selbst wählen soll.
• KBC_KUBERNETES_TOKEN_PATH (nur bereitgestellte Server, siehe docs/kubernetes-sa-auth.md): wird nur aus der Umgebung gelesen, niemals aus einem Header.
• KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA: Gleiche Idee wie die Storage-API-URL oben – ein Server, der mit seinem eigenen Workspace-Pin gestartet wurde (über eine der beiden Variablen oder --workspace-id), behält diesen Pin für jede Anfrage; ein X-Workspace-Id- oder X-Workspace-Schema-Header, der einen anderen Workspace anfordert, wird ignoriert (eine Warnung wird protokolliert). Ein Server ohne eigenen Pin (der gemeinsame Multi-User-Fall) übernimmt den Pin weiterhin pro Anfrage aus der Anfrage, wie unten beschrieben.

Anmelden

Melden Sie sich einmal mit Ihrem Browser an; der Server speichert die Sitzung und erneuert sie automatisch, sodass keine Tokens zu verwalten sind:

uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com

Dies öffnet Ihren Browser, um sich bei Keboola anzumelden, und speichert dann die Stack-weite Sitzung in ~/.keboola/mcp/credentials.json (nur für Sie lesbar, ein Eintrag pro Stack). Starten Sie danach den Server nur mit KBC_STORAGE_API_URL – kein Token erforderlich. Welches Projekt bzw. welche Projekte bearbeitet werden sollen, wird anschließend im Gespräch gewählt (get_accessible_projects / set_project_scope), nicht während der Anmeldung.

Befehl	Was er tut
login --api-url <url>	Bei einem Stack anmelden
login --force	Erneut anmelden / Konto wechseln
login --show-token	Aktuelles Sitzungstoken ausgeben (Debugging)
logout [--api-url <url>] [--all]	Gespeicherte Sitzung für einen Stack (oder alle Stacks) entfernen

Wenn Sie den Server über stdio in einem interaktiven Terminal ohne gespeicherte Sitzung starten, führt er diesen Browser-Login beim ersten Start automatisch aus. MCP-Clients (Claude, Cursor, …) starten den Server im Hintergrund, wo kein Browser geöffnet werden kann. Führen Sie daher login einmal selbst aus.

Starten ohne Keboola-Konto

Sie können den Server auch nur mit KBC_STORAGE_API_URL und ohne Anmeldeinformationen starten. Er startet im Bootstrap-Modus: Tools, die Keboola-Zugriff benötigen, erklären, wie Sie eine Anmeldeinformation erhalten, und ein Tool funktioniert ohne eine – create_project. Es erstellt ein neues Keboola-Projekt, meldet die Sitzung dort an und gibt eine Bestätigungs-URL zurück. Wenn Sie diese URL in einem Browser öffnen und sich anmelden, gehört das Projekt dauerhaft Ihnen; bis dahin ist es temporär und Keboola kann es zurückfordern. Sobald Sie bestätigen, wird die vom Tool erstellte Sitzung widerrufen und Sie arbeiten mit Ihrem eigenen login weiter.

Dies erfordert einen Stack mit aktivierter Agentenbereitstellung; andernfalls meldet das Tool, dass es nicht verfügbar ist.

Authentifizierung ohne Browser

Für Container oder CI, wo ein Browser-Login nicht möglich ist, stellen Sie ein Keboola-Zugriffs- oder persönliches Zugriffstoken direkt bereit – setzen Sie KBC_STORAGE_TOKEN (Umgebungsvariable) oder senden Sie den X-StorageAPI-Token-Header – zusammen mit KBC_PROJECT_ID (oder dem X-KBC-ProjectId-Header), um das Projekt auszuwählen. Bei HTTP-Transports können diese pro Anfrage als Header bereitgestellt werden, sodass jede Anfrage ihre eigenen Anmeldeinformationen trägt.

KBC_WORKSPACE_ID

Pinnt Abfragen auf einen bestimmten, bereits vorhandenen Workspace anhand seiner ID, anstelle der oben beschriebenen Schema-basierten Suche, und hat Vorrang vor KBC_WORKSPACE_SCHEMA, wenn beide gesetzt sind. Dies ist die Option, die ein Data App-/kai-Agent-Aufrufer bereitstellt, als X-Workspace-Id-Header, sodass Kai, das in dieser App eingebettet ist, nur über seinen eigenen Workspace abfragt.

Setzen Sie es über die Umgebungsvariable KBC_WORKSPACE_ID, das CLI-Flag --workspace-id oder (pro Anfrage, für Multi-User-Bereitstellungen) den Header X-Workspace-Id.

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 die URL in Ihrem Browser betrachten, 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 mit einem bestimmten Keboola-Entwicklungszweig zu arbeiten, legen Sie die Zweig-ID mit dem Parameter KBC_BRANCH_ID fest. Der MCP-Server beschränkt seine Funktionalität auf den angegebenen Zweig, sodass alle Änderungen isoliert bleiben und den Produktionszweig nicht beeinträchtigen.

• Wenn nicht angegeben, verwendet der Server standardmäßig den Produktionszweig.
• Für Entwicklungsarbeiten setzen Sie KBC_BRANCH_ID auf die numerische ID Ihres Zweigs (z. B. 123456). Sie finden die Entwicklungszweig-ID in der URL, wenn Sie in der Benutzeroberfläche zum Entwicklungszweig navigieren, zum Beispiel: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
• Bei Remote-Transports können Sie die 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. Installieren von uv:

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.

Ausführen des Keboola MCP Servers

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

Option A: Integrierter Modus (Empfohlen)

In diesem Modus startet Claude oder Cursor den MCP-Server automatisch für Sie.

1. Melden Sie sich einmal in einem Terminal an, damit eine Sitzung gespeichert wird (der Client startet den Server im Hintergrund, wo kein Browser geöffnet werden kann):

   uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com
   

2. Konfigurieren Sie Ihren MCP-Client (Claude/Cursor) mit den folgenden Einstellungen — nur KBC_STORAGE_API_URL ist erforderlich.
3. Der Client startet den MCP-Server bei Bedarf automatisch.

Claude Desktop-Konfiguration

1. 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)
2. Fügen Sie die folgende Konfiguration hinzu:
3. 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_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

1. Gehen Sie zu Einstellungen → MCP
2. Klicken Sie auf „+ Neuen globalen MCP-Server hinzufügen"
3. 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_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

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

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_BRANCH_ID=your_branch_id_optional &&",
          "/snap/bin/uvx keboola_mcp_server --transport <transport>",
          "'"
      ]
    }
  }
}

Option B: Lokaler Entwicklungsmodus

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

1. Klonen Sie das Repository und richten Sie eine lokale Umgebung ein
2. Konfigurieren Sie Claude/Cursor so, dass es Ihren lokalen Python-Pfad verwendet:

{
  "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_BRANCH_ID": "your_branch_id_optional"
      }
    }
  }
}

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

Sie können den Server manuell in einem Terminal zum Testen oder Debuggen ausführen:

# Sign in once (stores a session under ~/.keboola/mcp), then start the server.
export KBC_STORAGE_API_URL=https://connection.YOUR_REGION.keboola.com
uvx keboola_mcp_server login --api-url "$KBC_STORAGE_API_URL"

uvx keboola_mcp_server --transport streamable-http

Hinweis: Dieser Modus dient hauptsächlich zum Debuggen oder Testen. Für die normale Verwendung mit Claude oder Cursor müssen Sie den Server nicht manuell ausführen.

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: Verwendung von Docker

Ein Container kann keinen Browser öffnen. Authentifizieren Sie sich daher mit einem Token (siehe Authentifizierung ohne Browser): Setzen Sie KBC_STORAGE_TOKEN auf ein Keboola-Zugriffs-/persönliches Zugriffstoken und KBC_PROJECT_ID auf das Zielprojekt. (Über HTTP können Sie stattdessen die Header X-StorageAPI-Token / X-KBC-ProjectId pro Anfrage übergeben und diese weglassen.)

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_TOKEN" \
  -e KBC_PROJECT_ID="YOUR_PROJECT_ID" \
  -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 Container-Port woanders hinzuzuordnen.

Muss ich den Server selbst starten?

Szenario	Muss ich manuell ausführen?	Verwenden Sie dieses Setup
Verwendung von Claude/Cursor	Nein	MCP in den App-Einstellungen konfigurieren
Lokale MCP-Entwicklung	Nein (Claude startet ihn)	Konfiguration auf Python-Pfad zeigen lassen
Manuelles CLI-Testen	Ja	Terminal zum Ausführen verwenden
Verwendung von Docker	Ja	Docker-Container ausführen

Verwendung des MCP-Servers

Sobald Ihr MCP-Client (Claude/Cursor) konfiguriert ist und ausgeführt wird, können Sie mit Abfragen Ihrer Keboola-Daten beginnen:

Überprüfen Sie Ihr Setup

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 für mögliche Aktionen

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 Bestelltabelle verknüpft"
• „Starten Sie den Datenextraktionsjob für meine Salesforce-Komponente"

Kompatibilität

MCP-Client-Unterstützung

MCP-Client	Support-Status	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 Tools

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

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

Fehlerbehebung

Häufige Probleme

Problem	Lösung
Authentifizierungsfehler	Führen Sie keboola_mcp_server login erneut aus (oder überprüfen Sie bei der Authentifizierung mit einem Token das Token und KBC_PROJECT_ID)
Verbindungszeitüberschreitung	Netzwerkverbindung prüfen

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 Codestil zu überprüfen.

Empfohlene Einrichtung:

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

Mit der empfohlenen Einrichtung werden Pakete für Tests und Codestilprüfung installiert, sodass IDEs wie VsCode oder Cursor den Code während der Entwicklung prüfen oder Tests ausführen können.

Integrationstests

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

• 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 Arbeitsbereich, sodass kein Workspace-Schema konfiguriert werden muss. Siehe integtests/README.md für detaillierte Einrichtungsanweisungen und Designdokumentation.

Aktualisieren von uv.lock

Aktualisieren Sie die Datei uv.lock, 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).

Aktualisieren der Tool-Dokumentation

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

uv run python -m src.keboola_mcp_server.generate_tool_docs

Veröffentlichung

Wir erstellen nicht für jeden gemergten PR ein Release. Die Arbeit landet kontinuierlich auf dem Trunk (main), und wir veröffentlichen regelmäßig, sobald Änderungen gemeinsam erneut getestet wurden — dies vermeidet, dass funktionierende Setups für Benutzer beschädigt werden.

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)

Jedes Tag löst release.yml CI aus, das das Docker-Image erstellt und veröffentlicht. KaiBench läuft nur auf Produktions-vX.Y.Z-Tags (nicht agent-vX.Y.Z und nicht -dev.-Vorabversionen). Verwenden Sie die release-notes-Fähigkeit — sie bereitet die Release-Notizen und den Entwurf-PR vor und führt durch das Taggen von sowohl vX.Y.Z als auch agent-vX.Y.Z.

Support und Feedback

⭐ Der primäre Weg, Hilfe zu erhalten, Fehler zu melden oder Funktionen anzufragen, ist das Öffnen eines Issues auf GitHub. ⭐

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

Ressourcen

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

Verbinden

• LinkedIn
• Twitter
• Changelog