Keboola

oficial

Construye flujos de datos robustos, integraciones y análisis en una única plataforma intuitiva.

¿Qué puedes hacer con Keboola MCP?

  • Tablas de almacenamiento de consultas — Pídele a tu asistente que explore buckets y tablas, o ejecute consultas SQL para encontrar los clientes principales por ingresos.
  • Crear transformaciones SQL — Describe una transformación en lenguaje natural, como unir tablas de clientes y pedidos, y haz que se construya por ti.
  • Gestionar componentes y trabajos — Lista extractores y escritores, inicia trabajos de extracción de datos y recupera detalles de ejecución para tus pipelines.
  • Construir flujos de trabajo — Crea y gestiona Flujos Condicionales o de Orquestación para automatizar pipelines de datos de varios pasos.
  • Implementar aplicaciones de datos — Crea y gestiona Aplicaciones de Datos de Streamlit que muestren resultados de consultas sobre tus datos de almacenamiento.
  • Trabajar en ramas de desarrollo — Limita todas las operaciones a una rama de desarrollo para probar cambios de forma segura sin afectar la producción.

Documentación

Ask DeepWiki

Servidor MCP de Keboola

Conecta tus agentes de IA, clientes MCP (Cursor, Claude, Windsurf, VS Code ...) y otros asistentes de IA a Keboola. Expón datos, transformaciones, consultas SQL y disparadores de trabajos—sin necesidad de código de integración. Entrega los datos correctos a los agentes cuando y donde los necesiten.

Descripción general

El Servidor MCP de Keboola es un puente de código abierto entre tu proyecto Keboola y las herramientas de IA modernas. Convierte las funciones de Keboola—como acceso al almacenamiento, transformaciones SQL y disparadores de trabajos—en herramientas invocables para Claude, Cursor, CrewAI, LangChain, Amazon Q y más.

Funciones

Con el Agente de IA y el Servidor MCP, puedes:

  • Almacenamiento: Consultar tablas directamente y gestionar descripciones de tablas o buckets
  • Componentes: Crear, listar e inspeccionar extractores, escritores, aplicaciones de datos y configuraciones de transformación
  • SQL: Crear transformaciones SQL con lenguaje natural
  • Trabajos: Ejecutar componentes y transformaciones, y recuperar detalles de ejecución de trabajos
  • Flujos: Construir y gestionar pipelines de flujos de trabajo usando Flujos Condicionales y Flujos Orquestadores.
  • Aplicaciones de Datos: Crear, implementar y gestionar Aplicaciones de Datos Streamlit de Keboola que muestren tus consultas sobre datos de almacenamiento.
  • Metadatos: Buscar, leer y actualizar documentación del proyecto y metadatos de objetos usando lenguaje natural
  • Ramas de Desarrollo: Trabajar de forma segura en ramas de desarrollo fuera de producción, donde todas las operaciones están limitadas a la rama seleccionada.

🚀 Inicio rápido: Servidor MCP Remoto (La forma más fácil)

La forma más fácil de usar el Servidor MCP de Keboola es a través de nuestro Servidor MCP Remoto. Esta solución alojada elimina la necesidad de configuración local, ajustes o instalación.

¿Qué es el Servidor MCP Remoto?

Nuestro servidor remoto está alojado en cada stack multi-tenant de Keboola y admite autenticación OAuth. Puedes conectarte desde cualquier asistente de IA que admita conexión HTTP Streamable remota y autenticación OAuth.

Cómo conectarse

  1. Obtén la URL de tu servidor remoto: Navega a Configuración de tu Proyecto Keboola → pestaña MCP Server
  2. Copia la URL del servidor: Se verá como https://mcp.<YOUR_REGION>.keboola.com/mcp
  3. Configura tu asistente de IA: Pega la URL en la configuración MCP de tu asistente de IA
  4. Autentícate: Se te pedirá que inicies sesión con tu cuenta de Keboola. La elección de en qué proyecto(s) trabajar se realiza después, en la conversación (por ejemplo, "lista mis proyectos de Keboola" / "usa el proyecto X")

Clientes compatibles

  • Cursor: Usa el botón "Instalar en Cursor" en la configuración del Servidor MCP de tu proyecto o haz clic en este botón Install MCP Server
  • Claude Desktop: Añade la integración vía Configuración → Integraciones
  • Claude Code: Instala usando claude mcp add --transport http keboola <URL> (ver detalles abajo)
  • Windsurf: Configura con la URL del servidor remoto
  • Make: Configura con la URL del servidor remoto
  • Otros clientes MCP: Configura con la URL del servidor remoto

Configuración de Claude Code

Claude Code es una herramienta de interfaz de línea de comandos que te permite interactuar con Claude usando tu terminal. Puedes instalar la integración del Servidor MCP de Keboola usando un comando simple.

Instalación:

Ejecuta el siguiente comando en tu terminal, reemplazando <YOUR_REGION> con tu región de Keboola:

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

Comandos específicos por región:

RegiónComando de instalación
US Virginia AWSclaude mcp add --transport http keboola https://mcp.keboola.com/mcp
US Virginia GCPclaude mcp add --transport http keboola https://mcp.us-east4.gcp.keboola.com/mcp
EU Frankfurt AWSclaude mcp add --transport http keboola https://mcp.eu-central-1.keboola.com/mcp
EU Irlanda Azureclaude mcp add --transport http keboola https://mcp.north-europe.azure.keboola.com/mcp
EU Frankfurt GCPclaude mcp add --transport http keboola https://mcp.europe-west3.gcp.keboola.com/mcp

Uso:

Una vez instalado, puedes usar el Servidor MCP de Keboola en Claude Code escribiendo /mcp en tu conversación y seleccionando las herramientas de Keboola que quieras usar.

Autenticación:

Cuando uses por primera vez el Servidor MCP de Keboola en Claude Code, se abrirá una ventana del navegador pidiéndote que:

  1. Inicies sesión con tu cuenta de Keboola
  2. Autorices la conexión

Después de la autenticación, puedes empezar a usar las herramientas de Keboola directamente desde Claude Code. La selección del proyecto ocurre después, en la conversación—solo pregunta a Claude qué proyecto(s) de Keboola usar.

Para instrucciones detalladas de configuración y URLs específicas por región, consulta nuestra documentación de configuración del servidor remoto.

Uso de Ramas de Desarrollo

Puedes trabajar de forma segura en ramas de desarrollo de Keboola sin afectar tus datos de producción. Los Servidores MCP alojados remotamente respetan el parámetro KBC_BRANCH_ID y limitarán todas las operaciones a la rama especificada. Puedes encontrar el ID de la rama de desarrollo en la URL al navegar a la rama de desarrollo en la interfaz, por ejemplo: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. El ID de la rama debe incluirse en cada solicitud usando el encabezado X-Branch-Id: <branchId>; de lo contrario, el Servidor MCP usa la rama de producción por defecto. Esto debe ser gestionado por el cliente de IA o el entorno que maneja la conexión del servidor.

Autorización de herramientas y control de acceso

Cuando se usan transportes basados en HTTP (HTTP Streamable), puedes controlar qué herramientas están disponibles para los clientes usando encabezados HTTP. Esto es útil para restringir las capacidades de los agentes de IA o hacer cumplir políticas de cumplimiento.

Encabezados de autorización

EncabezadoDescripciónEjemplo
X-Allowed-ToolsLista separada por comas de herramientas permitidasget_configs,get_buckets,query_data
X-Disallowed-ToolsLista separada por comas de herramientas a excluircreate_config,run_job
X-Read-Only-ModeRestringir solo a herramientas de solo lecturatrue, 1, o yes

Comportamiento del filtro

Los filtros se aplican en orden: permitido → intersección de solo lectura → exclusión por desautorización. Encabezados vacíos = sin restricción.

Herramientas de solo lectura

Las herramientas de solo lectura son aquellas anotadas con readOnlyHint=True. Estas herramientas solo recuperan información sin hacer cambios en tu proyecto de Keboola. Para la lista actual de herramientas de solo lectura, consulta el archivo TOOLS.md que es una instantánea generada automáticamente del conjunto real de herramientas.

Ejemplo: Acceso de solo lectura

X-Read-Only-Mode: true

Para documentación detallada, consulta developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.


Configuración local del Servidor MCP (Forma personalizada o de desarrollo)

Ejecuta el servidor MCP en tu propia máquina para control total y desarrollo fácil. Elige esto cuando quieras personalizar herramientas, depurar localmente o iterar rápidamente. Instalarás el servidor, te autenticarás (un inicio de sesión único en el navegador—sin token que pegar) y lo iniciarás. Este enfoque ofrece máxima flexibilidad (herramientas personalizadas, registro local, iteración sin conexión) pero requiere configuración manual y tú gestionas las actualizaciones y secretos.

El servidor admite múltiples opciones de transporte, que se pueden seleccionar proporcionando el argumento --transport <transport> al iniciar el servidor:

  • stdio - Predeterminado cuando --transport no se especifica. Entrada/salida estándar, típicamente usado para implementación local con un solo cliente.
  • streamable-http - Ejecuta el servidor remotamente sobre HTTP con un canal de streaming bidireccional, permitiendo que el cliente y el servidor intercambien mensajes continuamente. Conéctate vía /mcp (por ejemplo, http://localhost:8000/mcp).
  • http-compat - Un alias para streamable-http, mantenido por compatibilidad hacia atrás.

Para trabajar con tu proyecto de Keboola, el servidor necesita dos cosas: tu Región de Keboola (KBC_STORAGE_API_URL) y una forma de autenticarse. La forma recomendada es un inicio de sesión único en el navegador—nunca creas, copias o pegas un token. Opcionalmente, establece KBC_BRANCH_ID para trabajar dentro de una rama de desarrollo.

Algunas de las variables no se toman de los encabezados de solicitud:

  • KBC_STORAGE_API_URL: un servidor que se inició con su propia URL de Storage API (el parámetro --api-url o la variable de entorno KBC_STORAGE_API_URL) solo sirve ese stack de Keboola. Un encabezado X-Storage-Api-Url que solicite un host diferente se ignora (se registra una advertencia)—el servidor mantiene su propia URL para la solicitud. Inicia el servidor sin una URL de Storage API propia si quieres que cada solicitud elija su stack.
  • KBC_KUBERNETES_TOKEN_PATH (solo servidores implementados, ver docs/kubernetes-sa-auth.md): se lee solo del entorno, nunca de un encabezado.
  • KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA: misma idea que la URL de Storage API anterior—un servidor iniciado con su propio pin de workspace (vía cualquiera de las variables, o --workspace-id) mantiene ese pin para cada solicitud; un encabezado X-Workspace-Id o X-Workspace-Schema que solicite un workspace diferente se ignora (se registra una advertencia). Un servidor sin pin propio (el caso compartido multi-usuario) sigue tomando el pin de la solicitud, por solicitud, como se describe abajo.

Iniciar sesión

Inicia sesión una vez con tu navegador; el servidor almacena la sesión y la renueva automáticamente, por lo que no hay tokens que gestionar:

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

Esto abre tu navegador para iniciar sesión en Keboola, luego guarda la sesión de todo el stack en ~/.keboola/mcp/credentials.json (legible solo por ti, una entrada por stack). Después, inicia el servidor con solo KBC_STORAGE_API_URL configurado—sin necesidad de token. La elección de en qué proyecto(s) trabajar se realiza después, en la conversación (get_accessible_projects / set_project_scope), no durante el inicio de sesión.

ComandoQué hace
login --api-url <url>Iniciar sesión en un stack
login --forceIniciar sesión de nuevo / cambiar de cuenta
login --show-tokenImprimir el token de sesión actual (depuración)
logout [--api-url <url>] [--all]Eliminar la sesión almacenada para un stack (o todos los stacks)

Cuando inicias el servidor sobre stdio en una terminal interactiva sin sesión almacenada, ejecuta este inicio de sesión en el navegador automáticamente en el primer arranque. Los clientes MCP (Claude, Cursor, …) lanzan el servidor en segundo plano donde un navegador no puede abrirse, así que ejecuta login una vez tú mismo primero.

Iniciar sin una cuenta de Keboola

También puedes iniciar el servidor con solo KBC_STORAGE_API_URL y sin credenciales. Se inicia en modo bootstrap: las herramientas que necesitan acceso a Keboola explican cómo obtener una credencial, y una herramienta funciona sin una—create_project. Crea un nuevo proyecto de Keboola, firma la sesión en él y devuelve una URL de confirmación. Abrir esa URL en un navegador e iniciar sesión hace que el proyecto sea permanentemente tuyo; hasta entonces es temporal y Keboola puede reclamarlo, y una vez que confirmes, la sesión que creó la herramienta se revoca y continúas con tu propio login.

Esto requiere un stack con aprovisionamiento de agentes habilitado; en otros lugares, la herramienta informa que no está disponible.

Autenticarse sin navegador

Para contenedores o CI donde un inicio de sesión en el navegador no es posible, proporciona un token de acceso o acceso personal de Keboola directamente—establece KBC_STORAGE_TOKEN (variable de entorno) o envía el encabezado X-StorageAPI-Token—junto con KBC_PROJECT_ID (o el encabezado X-KBC-ProjectId) para seleccionar el proyecto. En transportes HTTP, estos se pueden proporcionar por solicitud como encabezados, por lo que cada solicitud lleva sus propias credenciales.

KBC_WORKSPACE_ID

Fija consultas a un workspace específico, ya existente, por su ID en lugar de la búsqueda basada en esquema anterior, y tiene prioridad sobre KBC_WORKSPACE_SCHEMA cuando ambos están configurados. Esta es la opción que un llamador de Data App / kai-agent proporciona, como el encabezado X-Workspace-Id, para que Kai integrado en esa aplicación consulte solo a través de su propio workspace.

Se configura vía la variable de entorno KBC_WORKSPACE_ID, el indicador de CLI --workspace-id, o (por solicitud, para implementaciones multi-usuario) el encabezado X-Workspace-Id.

KBC_STORAGE_API_URL (Región de Keboola)

La URL de la API de tu Región de Keboola depende de tu región de implementación. Puedes determinar tu región mirando la URL en tu navegador cuando inicias sesión en tu proyecto de Keboola:

RegiónURL de la API
AWS América del Nortehttps://connection.keboola.com
AWS Europahttps://connection.eu-central-1.keboola.com
Google Cloud EUhttps://connection.europe-west3.gcp.keboola.com
Google Cloud UShttps://connection.us-east4.gcp.keboola.com
Azure EUhttps://connection.north-europe.azure.keboola.com

KBC_BRANCH_ID (Opcional)

Para operar en una rama de desarrollo de Keboola específica, establezca el ID de la rama usando el parámetro KBC_BRANCH_ID. El servidor MCP limita su funcionalidad a la rama especificada, asegurando que todos los cambios permanezcan aislados y no afecten a la rama de producción.

  • Si no se proporciona, el servidor usa la rama de producción por defecto.
  • Para trabajo de desarrollo, establezca KBC_BRANCH_ID al ID numérico de su rama (por ejemplo, 123456). Puede encontrar el ID de la rama de desarrollo en la URL al navegar a la rama de desarrollo en la interfaz de usuario, por ejemplo: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
  • En transportes remotos, puede anular por solicitud con el encabezado HTTP X-Branch-Id: <branchId> o KBC_BRANCH_ID: <branchId>.

Instalación

Asegúrese de tener:

  • Python 3.10+ instalado
  • Acceso a un proyecto de Keboola con derechos de administrador
  • Su cliente MCP preferido (Claude, Cursor, etc.)

Nota: Asegúrese de tener uv instalado. El cliente MCP lo usará para descargar y ejecutar automáticamente el servidor MCP de Keboola. Instalación de 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

Para más opciones de instalación, consulte la documentación oficial de uv.

Ejecución del Servidor MCP de Keboola

Hay cuatro formas de usar el Servidor MCP de Keboola, según sus necesidades:

Opción A: Modo Integrado (Recomendado)

En este modo, Claude o Cursor inician automáticamente el servidor MCP por usted.

  1. Inicie sesión una vez en una terminal para que se almacene una sesión (el cliente lanza el servidor en segundo plano, donde un navegador no puede abrirse):
    uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com
    
  2. Configure su cliente MCP (Claude/Cursor) con la configuración a continuación — solo se necesita KBC_STORAGE_API_URL.
  3. El cliente lanzará automáticamente el servidor MCP cuando sea necesario.

Configuración de Claude Desktop

  1. Vaya a Claude (esquina superior izquierda de su pantalla) -> Configuración → Desarrollador → Editar Configuración (si no ve claude_desktop_config.json, créelo)
  2. Agregue la siguiente configuración:
  3. Reinicie Claude desktop para que los cambios surtan efecto
{
  "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"
      }
    }
  }
}

Ubicaciones del archivo de configuración:

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

Configuración de Cursor

  1. Vaya a Configuración → MCP
  2. Haga clic en "+ Agregar nuevo servidor MCP global"
  3. Configure con esta configuración:
{
  "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"
      }
    }
  }
}

Nota: Use nombres cortos y descriptivos para los servidores MCP. Dado que el nombre completo de la herramienta incluye el nombre del servidor y debe mantenerse por debajo de ~60 caracteres, los nombres más largos pueden filtrarse en Cursor y no se mostrarán al Agente.

Configuración de Cursor para Windows WSL

Al ejecutar el servidor MCP desde el Subsistema de Windows para Linux con Cursor AI, use esta configuración:

{
  "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>",
          "'"
      ]
    }
  }
}

Opción B: Modo de Desarrollo Local

Para desarrolladores que trabajan en el código del servidor MCP:

  1. Clone el repositorio y configure un entorno local
  2. Configure Claude/Cursor para usar su ruta local de Python:
{
  "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"
      }
    }
  }
}

Opción C: Modo CLI Manual (Solo para Pruebas)

Puede ejecutar el servidor manualmente en una terminal para pruebas o depuración:

# 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

Nota: Este modo es principalmente para depuración o pruebas. Para uso normal con Claude o Cursor, no necesita ejecutar el servidor manualmente.

Nota: El servidor usará el transporte Streamable HTTP y escuchará en localhost:8000 para conexiones entrantes en /mcp. Puede usar los parámetros --port y --host para hacer que escuche en otro lugar.

Opción D: Usando Docker

Un contenedor no puede abrir un navegador, así que autentíquese con un token (consulte Autenticación sin navegador): establezca KBC_STORAGE_TOKEN a un token de acceso/personal de Keboola y KBC_PROJECT_ID al proyecto objetivo. (Sobre HTTP, puede pasar los encabezados X-StorageAPI-Token / X-KBC-ProjectId por solicitud y omitir estos.)

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

Nota: El servidor usará el transporte Streamable HTTP y escuchará en localhost:8000 para conexiones entrantes en /mcp. Puede cambiar -p para mapear el puerto del contenedor a otro lugar.

¿Necesito Iniciar el Servidor Yo Mismo?

Escenario¿Necesita Ejecutar Manualmente?Use Esta Configuración
Usando Claude/CursorNoConfigure MCP en la configuración de la aplicación
Desarrollando MCP localmenteNo (Claude lo inicia)Apunte la configuración a la ruta de python
Probando CLI manualmenteUse la terminal para ejecutar
Usando DockerEjecute el contenedor docker

Uso del Servidor MCP

Una vez que su cliente MCP (Claude/Cursor) esté configurado y ejecutándose, puede comenzar a consultar sus datos de Keboola:

Verifique su Configuración

Puede comenzar con una consulta simple para confirmar que todo funciona:

What buckets and tables are in my Keboola project?

Ejemplos de lo que Puede Hacer

Exploración de Datos:

  • "¿Qué tablas contienen información de clientes?"
  • "Ejecute una consulta para encontrar los 10 principales clientes por ingresos"

Análisis de Datos:

  • "Analice mis datos de ventas por región para el último trimestre"
  • "Encuentre correlaciones entre la edad del cliente y la frecuencia de compra"

Pipelines de Datos:

  • "Cree una transformación SQL que una las tablas de clientes y pedidos"
  • "Inicie el trabajo de extracción de datos para mi componente de Salesforce"

Compatibilidad

Soporte de Clientes MCP

Cliente MCPEstado de SoporteMétodo de Conexión
Claude (Desktop y Web)✅ compatiblestdio
Cursor✅ compatiblestdio
Windsurf, Zed, Replit✅ Compatiblestdio
Codeium, Sourcegraph✅ CompatibleStreamable HTTP
Clientes MCP Personalizados✅ CompatibleStreamable HTTP o stdio

Herramientas Compatibles

Nota: Sus agentes de IA se ajustarán automáticamente a nuevas herramientas.

Para una lista completa de herramientas disponibles con descripciones detalladas, parámetros y ejemplos de uso, consulte TOOLS.md.

Solución de Problemas

Problemas Comunes

ProblemaSolución
Errores de AutenticaciónVuelva a ejecutar keboola_mcp_server login (o, si autentica con un token, verifique el token y KBC_PROJECT_ID)
Tiempo de Espera de ConexiónVerifique la conectividad de red

Desarrollo

Instalación

Configuración básica:

uv sync --extra dev

Con la configuración básica, puede usar uv run tox para ejecutar pruebas y verificar el estilo del código.

Configuración recomendada:

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

Con la configuración recomendada, se instalarán paquetes para pruebas y verificación de estilo de código, lo que permite que IDE como VsCode o Cursor verifiquen el código o ejecuten pruebas durante el desarrollo.

Pruebas de integración

Para ejecutar pruebas de integración localmente, use uv run tox -e integtests. NOTA: Necesitará establecer las siguientes variables de entorno:

  • INTEGTEST_POOL_STORAGE_API_URL
  • INTEGTEST_STORAGE_TOKENS
  • INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Para obtener estos valores, necesita proyectos dedicados de Keboola para pruebas de integración. Cada sesión de prueba crea su propio espacio de trabajo de solo lectura, por lo que no es necesario configurar ningún esquema de espacio de trabajo. Consulte integtests/README.md para instrucciones detalladas de configuración y documentación de diseño.

Actualización de uv.lock

Actualice el archivo uv.lock si ha agregado o eliminado dependencias. También considere actualizar el bloqueo con versiones de dependencias más nuevas al crear una versión (uv lock --upgrade).

Actualización de la Documentación de Herramientas

Cuando realice cambios en las descripciones de cualquier herramienta (docstrings en las funciones de herramienta), debe regenerar el archivo de documentación TOOLS.md para reflejar estos cambios:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Publicación

No publicamos una versión para cada PR fusionado. El trabajo llega al tronco (main) continuamente, y publicamos periódicamente una vez que los cambios se han vuelto a probar juntos — esto evita romper configuraciones de trabajo para los usuarios.

Una versión se realiza empujando una o dos etiquetas git:

  • vX.Y.Z — la versión del servidor MCP (siempre)
  • agent-vX.Y.Z — la versión del Agente en Plataforma (solo cuando el agente también se publica)

Cualquiera de las etiquetas activa release.yml CI, que construye y publica la imagen Docker. KaiBench se ejecuta solo en etiquetas de producción vX.Y.Z (no agent-vX.Y.Z, y no -dev. prereleases). Use la habilidad release-notes — prepara las notas de versión y el borrador del PR y guía a través del etiquetado de ambos vX.Y.Z y agent-vX.Y.Z.

Soporte y Comentarios

⭐ La forma principal de obtener ayuda, reportar errores o solicitar funciones es abriendo un issue en GitHub. ⭐

El equipo de desarrollo monitorea activamente los issues y responderá lo más rápido posible. Para información general sobre Keboola, use los recursos a continuación.

Recursos

Conectar