Keboola

Serveur MCP Keboola

Connectez vos agents IA, clients MCP (Cursor, Claude, Windsurf, VS Code ...) et autres assistants IA à Keboola. Exposez des données, des transformations, des requêtes SQL et des déclencheurs de tâches—sans code de colle requis. Livrez les bonnes données aux agents quand et où ils en ont besoin.

Vue d'ensemble

Le serveur MCP Keboola est un pont open-source entre votre projet Keboola et les outils IA modernes. Il transforme les fonctionnalités de Keboola—comme l'accès au stockage, les transformations SQL et les déclencheurs de tâches—en outils appelables pour Claude, Cursor, CrewAI, LangChain, Amazon Q, et plus encore.

• Démarrage rapide
• Configuration locale

Fonctionnalités

Avec l'agent IA et le serveur MCP, vous pouvez :

• Stockage : Interroger des tables directement et gérer les descriptions de tables ou de buckets
• Composants : Créer, lister et inspecter les extracteurs, les écrivains, les applications de données et les configurations de transformation
• SQL : Créer des transformations SQL en langage naturel
• Tâches : Exécuter des composants et des transformations, et récupérer les détails d'exécution des tâches
• Flux : Construire et gérer des pipelines de flux de travail en utilisant les flux conditionnels et les flux d'orchestration.
• Applications de données : Créer, déployer et gérer des applications de données Keboola Streamlit affichant vos requêtes sur les données de stockage.
• Métadonnées : Rechercher, lire et mettre à jour la documentation du projet et les métadonnées des objets en langage naturel
• Branches de développement : Travailler en toute sécurité dans des branches de développement hors production, où toutes les opérations sont limitées à la branche sélectionnée.

---

🚀 Démarrage rapide : Serveur MCP distant (le plus simple)

Le moyen le plus simple d'utiliser le serveur MCP Keboola est via notre serveur MCP distant. Cette solution hébergée élimine le besoin de configuration locale, de paramétrage ou d'installation.

Qu'est-ce que le serveur MCP distant ?

Notre serveur distant est hébergé sur chaque pile multi-tenant Keboola et prend en charge l'authentification OAuth. Vous pouvez vous y connecter depuis n'importe quel assistant IA qui prend en charge la connexion HTTP Streamable distante et l'authentification OAuth.

Comment se connecter

1. Obtenez l'URL de votre serveur distant : Accédez à Paramètres du projet Keboola → onglet MCP Server
2. Copiez l'URL du serveur : Elle ressemblera à https://mcp.<YOUR_REGION>.keboola.com/mcp
3. Configurez votre assistant IA : Collez l'URL dans les paramètres MCP de votre assistant IA
4. Authentifiez-vous : Vous serez invité à vous connecter avec votre compte Keboola. Le(s) projet(s) sur le(s)quel(s) travailler est choisi ensuite, dans la conversation (par exemple "liste mes projets Keboola" / "utilise le projet X")

Clients pris en charge

• Cursor : Utilisez le bouton "Installer dans Cursor" dans les paramètres du serveur MCP de votre projet ou cliquez sur ce bouton
• Claude Desktop : Ajoutez l'intégration via Paramètres → Intégrations
• Claude Code : Installez en utilisant claude mcp add --transport http keboola <URL> (voir ci-dessous pour plus de détails)
• Windsurf : Configurez avec l'URL du serveur distant
• Make : Configurez avec l'URL du serveur distant
• Autres clients MCP : Configurez avec l'URL du serveur distant

Configuration de Claude Code

Claude Code est un outil d'interface en ligne de commande qui vous permet d'interagir avec Claude en utilisant votre terminal. Vous pouvez installer l'intégration du serveur MCP Keboola en utilisant une simple commande.

Installation :

Exécutez la commande suivante dans votre terminal, en remplaçant <YOUR_REGION> par votre région Keboola :

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

Commandes spécifiques à la région :

Région	Commande d'installation
US Virginie AWS	claude mcp add --transport http keboola https://mcp.keboola.com/mcp
US Virginie GCP	claude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp
UE Francfort AWS	claude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp
UE Irlande Azure	claude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp
UE Francfort GCP	claude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp

Utilisation :

Une fois installé, vous pouvez utiliser le serveur MCP Keboola dans Claude Code en tapant /mcp dans votre conversation et en sélectionnant les outils Keboola que vous souhaitez utiliser.

Authentification :

Lors de la première utilisation du serveur MCP Keboola dans Claude Code, une fenêtre de navigateur s'ouvrira vous invitant à :

1. Vous connecter avec votre compte Keboola
2. Autoriser la connexion

Après l'authentification, vous pouvez commencer à utiliser les outils Keboola directement depuis Claude Code. La sélection du projet se fait ensuite, dans la conversation — demandez simplement à Claude quel(s) projet(s) Keboola utiliser.

Pour des instructions de configuration détaillées et des URL spécifiques à la région, consultez notre documentation de configuration du serveur distant.

Utilisation des branches de développement

Vous pouvez travailler en toute sécurité dans les branches de développement Keboola sans affecter vos données de production. Les serveurs MCP hébergés à distance respectent le paramètre KBC_BRANCH_ID et limiteront toutes les opérations à la branche spécifiée. Vous pouvez trouver l'ID de la branche de développement dans l'URL lors de la navigation vers la branche de développement dans l'interface, par exemple : https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. L'ID de la branche doit être inclus dans chaque requête en utilisant l'en-tête X-Branch-Id: <branchId>, sinon le serveur MCP utilise la branche de production par défaut. Cela doit être géré par le client IA ou l'environnement gérant la connexion au serveur.

Autorisation des outils et contrôle d'accès

Lors de l'utilisation de transports basés sur HTTP (HTTP Streamable), vous pouvez contrôler quels outils sont disponibles pour les clients en utilisant les en-têtes HTTP. Cela est utile pour restreindre les capacités des agents IA ou appliquer des politiques de conformité.

En-têtes d'autorisation

En-tête	Description	Exemple
X-Allowed-Tools	Liste séparée par des virgules des outils autorisés	get_configs,get_buckets,query_data
X-Disallowed-Tools	Liste séparée par des virgules des outils à exclure	create_config,run_job
X-Read-Only-Mode	Restreindre aux outils en lecture seule uniquement	true, 1, ou yes

Comportement du filtre

Les filtres s'appliquent dans l'ordre : autorisé → intersection lecture seule → exclusion interdite. En-têtes vides = aucune restriction.

Outils en lecture seule

Les outils en lecture seule sont ceux annotés avec readOnlyHint=True. Ces outils ne font que récupérer des informations sans apporter de modifications à votre projet Keboola. Pour la liste actuelle des outils en lecture seule, consultez le fichier TOOLS.md qui est un instantané généré automatiquement de l'ensemble réel des outils.

Exemple : Accès en lecture seule

X-Read-Only-Mode: true

Pour une documentation détaillée, consultez developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.

---

Configuration locale du serveur MCP (Méthode personnalisée ou de développement)

Exécutez le serveur MCP sur votre propre machine pour un contrôle total et un développement facile. Choisissez cette option lorsque vous souhaitez personnaliser les outils, déboguer localement ou itérer rapidement. Vous installerez le serveur, vous vous authentifierez (une connexion navigateur unique — aucun jeton à coller), et vous le démarrerez. Cette approche offre une flexibilité maximale (outils personnalisés, journalisation locale, itération hors ligne) mais nécessite une configuration manuelle et vous gérez vous-même les mises à jour et les secrets.

Le serveur prend en charge plusieurs options de transport, qui peuvent être sélectionnées en fournissant l'argument --transport <transport> lors du démarrage du serveur :

• stdio - Par défaut lorsque --transport n'est pas spécifié. Entrée/sortie standard, généralement utilisée pour le déploiement local avec un seul client.
• streamable-http - Exécute le serveur à distance sur HTTP avec un canal de streaming bidirectionnel, permettant au client et au serveur d'échanger en continu des messages. Connectez-vous via /mcp (par exemple, http://localhost:8000/mcp).
• http-compat - Un alias pour streamable-http, conservé pour la rétrocompatibilité.

Pour travailler avec votre projet Keboola, le serveur a besoin de deux choses : votre région Keboola (KBC_STORAGE_API_URL) et un moyen de s'authentifier. La méthode recommandée est une connexion navigateur unique — vous ne créez, copiez ou collez jamais de jeton. Optionnellement, définissez KBC_BRANCH_ID pour travailler dans une branche de développement.

Certaines variables ne sont pas extraites des en-têtes de requête :

• KBC_STORAGE_API_URL : un serveur démarré avec sa propre URL d'API de stockage (le paramètre --api-url ou la variable d'environnement KBC_STORAGE_API_URL) ne sert que cette pile Keboola. Un en-tête X-Storage-Api-Url demandant un hôte différent est ignoré (un avertissement est journalisé) — le serveur conserve sa propre URL pour la requête. Démarrez le serveur sans URL d'API de stockage propre si vous souhaitez que chaque requête choisisse sa pile.
• KBC_KUBERNETES_TOKEN_PATH (serveurs déployés uniquement, voir docs/kubernetes-sa-auth.md) : lu uniquement depuis l'environnement, jamais depuis un en-tête.
• KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA : même idée que l'URL d'API de stockage ci-dessus — un serveur démarré avec son propre ancrage d'espace de travail (via l'une ou l'autre variable, ou --workspace-id) conserve cet ancrage pour chaque requête ; un en-tête X-Workspace-Id ou X-Workspace-Schema demandant un espace de travail différent est ignoré (un avertissement est journalisé). Un serveur sans ancrage propre (le cas partagé multi-utilisateurs) continue de prendre l'ancrage de la requête, par requête, comme décrit ci-dessous.

Connexion

Connectez-vous une fois avec votre navigateur ; le serveur stocke la session et la rafraîchit automatiquement, donc il n'y a aucun jeton à gérer :

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

Cela ouvre votre navigateur pour vous connecter à Keboola, puis enregistre la session à l'échelle de la pile dans ~/.keboola/mcp/credentials.json (lisible uniquement par vous, une entrée par pile). Ensuite, démarrez le serveur avec uniquement KBC_STORAGE_API_URL défini — aucun jeton requis. Le(s) projet(s) sur le(s)quel(s) travailler est choisi ensuite, dans la conversation (get_accessible_projects / set_project_scope), pas pendant la connexion.

Commande	Ce qu'elle fait
login --api-url <url>	Se connecter à une pile
login --force	Se reconnecter / changer de compte
login --show-token	Afficher le jeton de session actuel (débogage)
logout [--api-url <url>] [--all]	Supprimer la session stockée pour une pile (ou toutes les piles)

Lorsque vous démarrez le serveur via stdio dans un terminal interactif sans session stockée, il exécute automatiquement cette connexion navigateur au premier démarrage. Les clients MCP (Claude, Cursor, …) lancent le serveur en arrière-plan où un navigateur ne peut pas s'ouvrir, donc exécutez login une fois vous-même d'abord.

Démarrage sans compte Keboola

Vous pouvez également démarrer le serveur avec uniquement KBC_STORAGE_API_URL et aucune information d'identification. Il démarre en mode bootstrap : les outils qui nécessitent un accès Keboola expliquent comment obtenir une information d'identification, et un outil fonctionne sans — create_project. Il crée un nouveau projet Keboola, connecte la session à celui-ci et renvoie une URL de confirmation. Ouvrir cette URL dans un navigateur et se connecter rend le projet définitivement vôtre ; jusqu'à ce moment, il est temporaire et Keboola peut le récupérer, et une fois que vous confirmez, la session créée par l'outil est révoquée et vous continuez avec votre propre login.

Cela nécessite une pile avec la fourniture d'agents activée ; ailleurs, l'outil signale qu'il n'est pas disponible.

Authentification sans navigateur

Pour les conteneurs ou CI où une connexion navigateur n'est pas possible, fournissez un jeton d'accès ou personnel Keboola directement — définissez KBC_STORAGE_TOKEN (variable d'environnement) ou envoyez l'en-tête X-StorageAPI-Token — avec KBC_PROJECT_ID (ou l'en-tête X-KBC-ProjectId) pour sélectionner le projet. Sur les transports HTTP, ceux-ci peuvent être fournis par requête comme en-têtes, donc chaque requête porte ses propres informations d'identification.

KBC_WORKSPACE_ID

Épingle les requêtes à un espace de travail spécifique, déjà existant, par son ID au lieu de la recherche basée sur le schéma ci-dessus, et a priorité sur KBC_WORKSPACE_SCHEMA lorsque les deux sont définis. C'est l'option qu'un appelant Data App / kai-agent fournit, comme en-tête X-Workspace-Id, afin que Kai intégré dans cette application interroge uniquement via son propre espace de travail.

Définissez via la variable d'environnement KBC_WORKSPACE_ID, le drapeau CLI --workspace-id, ou (par requête, pour les déploiements multi-utilisateurs) l'en-tête X-Workspace-Id.

KBC_STORAGE_API_URL (Région Keboola)

L'URL de l'API de votre région Keboola dépend de votre région de déploiement. Vous pouvez déterminer votre région en regardant l'URL dans votre navigateur lorsque vous êtes connecté à votre projet Keboola :

Région	URL de l'API
AWS Amérique du Nord	https://connection.keboola.com
AWS Europe	https://connection.eu-central-1.keboola.com
Google Cloud UE	https://connection.europe-west3.gcp.keboola.com
Google Cloud US	https://connection.us-east4.gcp.keboola.com
Azure UE	https://connection.north-europe.azure.keboola.com

KBC_BRANCH_ID (Optionnel)

Pour travailler sur une branche de développement Keboola spécifique, définissez l'ID de branche à l'aide du paramètre KBC_BRANCH_ID. Le serveur MCP limite ses fonctionnalités à la branche spécifiée, garantissant que toutes les modifications restent isolées et n'impactent pas la branche de production.

• Si non fourni, le serveur utilise la branche de production par défaut.
• Pour le travail de développement, définissez KBC_BRANCH_ID sur l'ID numérique de votre branche (par exemple, 123456). Vous pouvez trouver l'ID de la branche de développement dans l'URL lors de la navigation vers la branche de développement dans l'interface utilisateur, par exemple : https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
• Sur les transports distants, vous pouvez remplacer par requête avec l'en-tête HTTP X-Branch-Id: <branchId> ou KBC_BRANCH_ID: <branchId>.

Installation

Assurez-vous d'avoir :

• Python 3.10+ installé
• Accès à un projet Keboola avec des droits d'administrateur
• Votre client MCP préféré (Claude, Cursor, etc.)

Remarque : Assurez-vous d'avoir uv installé. Le client MCP l'utilisera pour télécharger et exécuter automatiquement le serveur MCP Keboola. Installation d'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

Pour plus d'options d'installation, consultez la documentation officielle d'uv.

Exécution du serveur MCP Keboola

Il existe quatre façons d'utiliser le serveur MCP Keboola, selon vos besoins :

Option A : Mode intégré (recommandé)

Dans ce mode, Claude ou Cursor démarre automatiquement le serveur MCP pour vous.

1. Connectez-vous une fois dans un terminal afin qu'une session soit stockée (le client lance le serveur en arrière-plan, où un navigateur ne peut pas s'ouvrir) :

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

2. Configurez votre client MCP (Claude/Cursor) avec les paramètres ci-dessous — seul KBC_STORAGE_API_URL est nécessaire.
3. Le client lancera automatiquement le serveur MCP lorsque nécessaire.

Configuration de Claude Desktop

1. Allez dans Claude (coin supérieur gauche de votre écran) -> Paramètres → Développeur → Modifier la configuration (si vous ne voyez pas claude_desktop_config.json, créez-le)
2. Ajoutez la configuration suivante :
3. Redémarrez Claude Desktop pour que les modifications prennent effet

{
  "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"
      }
    }
  }
}

Emplacements des fichiers de configuration :

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

Configuration de Cursor

1. Allez dans Paramètres → MCP
2. Cliquez sur « + Ajouter un nouveau serveur MCP global »
3. Configurez avec ces paramètres :

{
  "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"
      }
    }
  }
}

Remarque : Utilisez des noms courts et descriptifs pour les serveurs MCP. Étant donné que le nom complet de l'outil inclut le nom du serveur et doit rester sous environ 60 caractères, les noms plus longs peuvent être filtrés dans Cursor et ne seront pas affichés à l'agent.

Configuration de Cursor pour Windows WSL

Lors de l'exécution du serveur MCP depuis le sous-système Windows pour Linux avec Cursor AI, utilisez cette configuration :

{
  "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 : Mode de développement local

Pour les développeurs travaillant sur le code du serveur MCP lui-même :

1. Clonez le dépôt et configurez un environnement local
2. Configurez Claude/Cursor pour utiliser votre chemin Python local :

{
  "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 : Mode CLI manuel (pour tests uniquement)

Vous pouvez exécuter le serveur manuellement dans un terminal pour les tests ou le débogage :

# 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

Remarque : Ce mode est principalement destiné au débogage ou aux tests. Pour une utilisation normale avec Claude ou Cursor, vous n'avez pas besoin d'exécuter le serveur manuellement.

Remarque : Le serveur utilisera le transport HTTP Streamable et écoutera sur localhost:8000 pour les connexions entrantes à /mcp. Vous pouvez utiliser les paramètres --port et --host pour le faire écouter ailleurs.

Option D : Utilisation de Docker

Un conteneur ne peut pas ouvrir un navigateur, alors authentifiez-vous avec un jeton (voir Authentification sans navigateur) : définissez KBC_STORAGE_TOKEN sur un jeton d'accès/personnel Keboola et KBC_PROJECT_ID sur le projet cible. (Sur HTTP, vous pouvez également passer les en-têtes X-StorageAPI-Token / X-KBC-ProjectId par requête et omettre ceux-ci.)

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

Remarque : Le serveur utilisera le transport HTTP Streamable et écoutera sur localhost:8000 pour les connexions entrantes à /mcp. Vous pouvez modifier -p pour mapper le port du conteneur ailleurs.

Dois-je démarrer le serveur moi-même ?

Scénario	Besoin d'exécution manuelle ?	Utilisez cette configuration
Utilisation de Claude/Cursor	Non	Configurez MCP dans les paramètres de l'application
Développement MCP localement	Non (Claude le démarre)	Pointez la configuration vers le chemin Python
Test CLI manuel	Oui	Utilisez le terminal pour exécuter
Utilisation de Docker	Oui	Exécutez le conteneur Docker

Utilisation du serveur MCP

Une fois votre client MCP (Claude/Cursor) configuré et exécuté, vous pouvez commencer à interroger vos données Keboola :

Vérifiez votre configuration

Vous pouvez commencer par une requête simple pour confirmer que tout fonctionne :

What buckets and tables are in my Keboola project?

Exemples de ce que vous pouvez faire

Exploration des données :

• « Quelles tables contiennent des informations sur les clients ? »
• « Exécutez une requête pour trouver les 10 meilleurs clients par chiffre d'affaires »

Analyse des données :

• « Analysez mes données de ventes par région pour le dernier trimestre »
• « Trouvez des corrélations entre l'âge des clients et la fréquence d'achat »

Pipelines de données :

• « Créez une transformation SQL qui joint les tables clients et commandes »
• « Démarrez le travail d'extraction de données pour mon composant Salesforce »

Compatibilité

Prise en charge des clients MCP

Client MCP	Statut de prise en charge	Méthode de connexion
Claude (Desktop & Web)	✅ pris en charge	stdio
Cursor	✅ pris en charge	stdio
Windsurf, Zed, Replit	✅ pris en charge	stdio
Codeium, Sourcegraph	✅ pris en charge	Streamable HTTP
Clients MCP personnalisés	✅ pris en charge	Streamable HTTP ou stdio

Outils pris en charge

Remarque : Vos agents IA s'adapteront automatiquement aux nouveaux outils.

Pour une liste complète des outils disponibles avec des descriptions détaillées, des paramètres et des exemples d'utilisation, consultez TOOLS.md.

Dépannage

Problèmes courants

Problème	Solution
Erreurs d'authentification	Réexécutez keboola_mcp_server login (ou, si vous vous authentifiez avec un jeton, vérifiez le jeton et KBC_PROJECT_ID)
Délai de connexion expiré	Vérifiez la connectivité réseau

Développement

Installation

Configuration de base :

uv sync --extra dev

Avec la configuration de base, vous pouvez utiliser uv run tox pour exécuter les tests et vérifier le style de code.

Configuration recommandée :

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

Avec la configuration recommandée, les packages pour les tests et la vérification du style de code seront installés, ce qui permet aux IDE comme VsCode ou Cursor de vérifier le code ou d'exécuter les tests pendant le développement.

Tests d'intégration

Pour exécuter les tests d'intégration localement, utilisez uv run tox -e integtests. REMARQUE : Vous devrez définir les variables d'environnement suivantes :

• INTEGTEST_POOL_STORAGE_API_URL
• INTEGTEST_STORAGE_TOKENS
• INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Pour obtenir ces valeurs, vous avez besoin de projets Keboola dédiés pour les tests d'intégration. Chaque session de test crée son propre espace de travail en lecture seule, donc aucun schéma d'espace de travail ne doit être configuré. Consultez integtests/README.md pour des instructions de configuration détaillées et la documentation de conception.

Mise à jour de uv.lock

Mettez à jour le fichier uv.lock si vous avez ajouté ou supprimé des dépendances. Envisagez également de mettre à jour le verrou avec des versions de dépendances plus récentes lors de la création d'une version (uv lock --upgrade).

Mise à jour de la documentation des outils

Lorsque vous apportez des modifications aux descriptions d'outils (docstrings dans les fonctions d'outil), vous devez régénérer le fichier de documentation TOOLS.md pour refléter ces modifications :

uv run python -m src.keboola_mcp_server.generate_tool_docs

Publication

Nous ne publions pas une version pour chaque PR fusionné. Le travail arrive sur le tronc (main) en continu, et nous publions périodiquement une fois que les modifications ont été re-testées ensemble — cela évite de casser les configurations existantes des utilisateurs.

Une version est effectuée en poussant une ou deux balises git :

• vX.Y.Z — la version du serveur MCP (toujours)
• agent-vX.Y.Z — la version de l'agent In Platform (uniquement lorsque l'agent est également publié)

Chaque balise déclenche le CI release.yml, qui construit et publie l'image Docker. KaiBench s'exécute uniquement sur les balises de production vX.Y.Z (pas agent-vX.Y.Z, et pas les préversions -dev.). Utilisez la compétence release-notes — elle prépare les notes de version et le projet de PR et guide à travers le marquage des deux vX.Y.Z et agent-vX.Y.Z.

Support et commentaires

⭐ Le principal moyen d'obtenir de l'aide, de signaler des bogues ou de demander des fonctionnalités est d'ouvrir un problème sur GitHub. ⭐

L'équipe de développement surveille activement les problèmes et répondra dès que possible. Pour des informations générales sur Keboola, veuillez utiliser les ressources ci-dessous.

Ressources

• Documentation utilisateur
• Documentation développeur
• Plateforme Keboola
• Suivi des problèmes ← Méthode de contact principale pour le serveur MCP

Connectez-vous

• LinkedIn
• Twitter
• Journal des modifications