Keboola

официальный

Создавайте надежные рабочие процессы с данными, интеграции и аналитику на единой интуитивно понятной платформе.

Что можно делать с Keboola MCP?

  • Таблицы хранения запросов — Попросите ассистента изучить buckets и таблицы или выполнить SQL-запросы, чтобы найти лучших клиентов по выручке.
  • Создание SQL-трансформаций — Опишите трансформацию на естественном языке, например, объединение таблиц клиентов и заказов, и она будет создана для вас.
  • Управление компонентами и заданиями — Списывайте экстракторы и писатели, запускайте задания по извлечению данных и получайте детали выполнения для ваших пайплайнов.
  • Построение потоков рабочих процессов — Создавайте и управляйте условными потоками или потоками-оркестраторами для автоматизации многоэтапных пайплайнов данных.
  • Развертывание приложений данных — Создавайте и управляйте Streamlit-приложениями для данных, которые отображают результаты запросов по вашим данным хранения.
  • Работа в ветках разработки — Ограничьте все операции веткой разработки, чтобы безопасно тестировать изменения, не затрагивая продакшн.

Документация

Ask DeepWiki

Keboola MCP Server

Подключите своих AI-агентов, MCP-клиенты (Cursor, Claude, Windsurf, VS Code ...) и другие AI-ассистенты к Keboola. Предоставляйте доступ к данным, трансформациям, SQL-запросам и запуску задач — без написания связующего кода. Доставляйте нужные данные агентам тогда и там, где они нужны.

Обзор

Keboola MCP Server — это мост с открытым исходным кодом между вашим проектом Keboola и современными AI-инструментами. Он превращает возможности Keboola — такие как доступ к хранилищу, SQL-трансформации и запуск задач — в вызываемые инструменты для Claude, Cursor, CrewAI, LangChain, Amazon Q и других.

Возможности

С помощью AI-агента и MCP-сервера вы можете:

  • Хранилище: Запрашивать таблицы напрямую и управлять описаниями таблиц или сегментов
  • Компоненты: Создавать, просматривать и проверять экстракторы, писатели, data apps и конфигурации трансформаций
  • SQL: Создавать SQL-трансформации на естественном языке
  • Задачи: Запускать компоненты и трансформации, получать детали выполнения задач
  • Потоки: Создавать и управлять конвейерами рабочих процессов с помощью условных потоков и потоков-оркестраторов
  • Data Apps: Создавать, развертывать и управлять Keboola Streamlit Data Apps, отображающими ваши запросы к данным хранилища
  • Метаданные: Искать, читать и обновлять документацию проекта и метаданные объектов на естественном языке
  • Dev-ветки: Безопасно работать в ветках разработки вне продакшена, где все операции ограничены выбранной веткой

🚀 Быстрый старт: удаленный MCP-сервер (самый простой способ)

Самый простой способ использовать Keboola MCP Server — через наш удаленный MCP-сервер. Это hosted-решение устраняет необходимость в локальной настройке, конфигурации или установке.

Что такое удаленный MCP-сервер?

Наш удаленный сервер размещен на каждом мультитенантном стеке Keboola и поддерживает аутентификацию OAuth. Вы можете подключиться к нему из любого AI-ассистента, поддерживающего удаленное Streamable HTTP-соединение и аутентификацию OAuth.

Как подключиться

  1. Получите URL вашего удаленного сервера: Перейдите в Настройки проекта Keboola → вкладка MCP Server
  2. Скопируйте URL сервера: Он будет выглядеть как https://mcp.<YOUR_REGION>.keboola.com/mcp
  3. Настройте ваш AI-ассистент: Вставьте URL в настройки MCP вашего AI-ассистента
  4. Аутентификация: Вам будет предложено войти с помощью вашей учетной записи Keboola. Выбор проекта(ов) для работы происходит позже, в диалоге (например, "перечисли мои проекты Keboola" / "используй проект X")

Поддерживаемые клиенты

  • Cursor: Используйте кнопку "Install In Cursor" в настройках MCP-сервера вашего проекта или нажмите эту кнопку Install MCP Server
  • Claude Desktop: Добавьте интеграцию через Настройки → Интеграции
  • Claude Code: Установите с помощью claude mcp add --transport http keboola <URL> (подробности ниже)
  • Windsurf: Настройте с помощью URL удаленного сервера
  • Make: Настройте с помощью URL удаленного сервера
  • Другие MCP-клиенты: Настройте с помощью URL удаленного сервера

Настройка Claude Code

Claude Code — это инструмент командной строки, который позволяет взаимодействовать с Claude через ваш терминал. Вы можете установить интеграцию Keboola MCP Server с помощью простой команды.

Установка:

Выполните следующую команду в терминале, заменив <YOUR_REGION> на ваш регион Keboola:

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

Команды для конкретных регионов:

РегионКоманда установки
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 Ireland 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

Использование:

После установки вы можете использовать Keboola MCP Server в Claude Code, введя /mcp в диалоге и выбрав нужные инструменты Keboola.

Аутентификация:

При первом использовании Keboola MCP Server в Claude Code откроется окно браузера с предложением:

  1. Войти с помощью вашей учетной записи Keboola
  2. Авторизовать соединение

После аутентификации вы можете начать использовать инструменты Keboola прямо из Claude Code. Выбор проекта происходит позже, в диалоге — просто попросите Claude указать, какие проекты Keboola использовать.

Подробные инструкции по настройке и URL для конкретных регионов см. в документации по настройке удаленного сервера.

Использование веток разработки

Вы можете безопасно работать в ветках разработки Keboola, не затрагивая данные продакшена. Удаленно размещенные MCP-серверы учитывают параметр KBC_BRANCH_ID и ограничивают все операции указанной веткой. ID ветки разработки можно найти в URL при переходе к ветке разработки в интерфейсе, например: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard. ID ветки должен быть включен в каждый запрос с помощью заголовка X-Branch-Id: <branchId>, иначе MCP-сервер по умолчанию использует ветку продакшена. Это должно управляться AI-клиентом или средой, обрабатывающей соединение с сервером.

Авторизация инструментов и контроль доступа

При использовании HTTP-транспортов (Streamable HTTP) вы можете управлять тем, какие инструменты доступны клиентам, с помощью HTTP-заголовков. Это полезно для ограничения возможностей AI-агентов или соблюдения политик соответствия.

Заголовки авторизации

ЗаголовокОписаниеПример
X-Allowed-ToolsСписок разрешенных инструментов через запятуюget_configs,get_buckets,query_data
X-Disallowed-ToolsСписок исключаемых инструментов через запятуюcreate_config,run_job
X-Read-Only-ModeОграничение только инструментами чтенияtrue, 1 или yes

Поведение фильтров

Фильтры применяются в порядке: разрешенные → пересечение с инструментами чтения → исключение запрещенных. Пустые заголовки = без ограничений.

Инструменты только для чтения

Инструменты только для чтения — это инструменты, помеченные readOnlyHint=True. Эти инструменты только получают информацию без внесения изменений в ваш проект Keboola. Актуальный список инструментов только для чтения см. в файле TOOLS.md, который является автоматически сгенерированным снимком фактического набора инструментов.

Пример: доступ только для чтения

X-Read-Only-Mode: true

Подробную документацию см. на developers.keboola.com/integrate/mcp/#tool-authorization-and-access-control.


Локальная настройка MCP-сервера (пользовательский или dev-способ)

Запустите MCP-сервер на своей машине для полного контроля и удобной разработки. Выбирайте этот вариант, если хотите настраивать инструменты, отлаживать локально или быстро итерировать. Вы установите сервер, пройдете аутентификацию (одноразовый вход в браузере — без вставки токенов) и запустите его. Этот подход обеспечивает максимальную гибкость (пользовательские инструменты, локальное логирование, офлайн-итерации), но требует ручной настройки, и вы сами управляете обновлениями и секретами.

Сервер поддерживает несколько вариантов транспорта, которые можно выбрать, указав аргумент --transport <transport> при запуске сервера:

  • stdio — по умолчанию, если --transport не указан. Стандартный ввод/вывод, обычно используется для локального развертывания с одним клиентом.
  • streamable-http — запускает сервер удаленно по HTTP с двунаправленным потоковым каналом, позволяя клиенту и серверу непрерывно обмениваться сообщениями. Подключение через /mcp (например, http://localhost:8000/mcp).
  • http-compat — псевдоним для streamable-http, сохранен для обратной совместимости.

Для работы с вашим проектом Keboola серверу нужны две вещи: ваш регион Keboola (KBC_STORAGE_API_URL) и способ аутентификации. Рекомендуемый способ — одноразовый вход в браузере — вам никогда не нужно создавать, копировать или вставлять токен. При необходимости установите KBC_BRANCH_ID для работы внутри ветки разработки.

Некоторые переменные не берутся из заголовков запросов:

  • KBC_STORAGE_API_URL: сервер, запущенный с собственным URL Storage API (параметр --api-url или переменная окружения KBC_STORAGE_API_URL), обслуживает только один стек Keboola. Заголовок X-Storage-Api-Url, запрашивающий другой хост, игнорируется (в лог записывается предупреждение) — сервер сохраняет свой URL для запроса. Запустите сервер без собственного URL Storage API, если хотите, чтобы каждый запрос выбирал свой стек.
  • KBC_KUBERNETES_TOKEN_PATH (только для развернутых серверов, см. docs/kubernetes-sa-auth.md): читается только из окружения, никогда из заголовка.
  • KBC_WORKSPACE_ID / KBC_WORKSPACE_SCHEMA: та же идея, что и с URL Storage API выше — сервер, запущенный с собственным закрепленным workspace (через любую из переменных или --workspace-id), сохраняет этот workspace для каждого запроса; заголовок X-Workspace-Id или X-Workspace-Schema, запрашивающий другой workspace, игнорируется (в лог записывается предупреждение). Сервер без собственного закрепленного workspace (общий многопользовательский случай) продолжает брать workspace из запроса, для каждого запроса, как описано ниже.

Вход в систему

Войдите один раз через браузер; сервер сохраняет сессию и автоматически обновляет ее, поэтому управлять токенами не нужно:

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

Это откроет браузер для входа в Keboola, затем сохранит сессию для стека в ~/.keboola/mcp/credentials.json (доступно только вам, одна запись на стек). После этого запустите сервер, указав только KBC_STORAGE_API_URL — токен не требуется. Выбор проекта(ов) для работы происходит позже, в диалоге (get_accessible_projects / set_project_scope), а не при входе.

КомандаЧто делает
login --api-url <url>Войти в стек
login --forceВойти снова / сменить учетную запись
login --show-tokenВывести текущий токен сессии (отладка)
logout [--api-url <url>] [--all]Удалить сохраненную сессию для стека (или всех стеков)

Когда вы запускаете сервер через stdio в интерактивном терминале без сохраненной сессии, он автоматически выполняет этот вход в браузере при первом запуске. MCP-клиенты (Claude, Cursor, …) запускают сервер в фоновом режиме, где браузер не может открыться, поэтому сначала выполните login самостоятельно.

Запуск без учетной записи Keboola

Вы также можете запустить сервер, указав только KBC_STORAGE_API_URL и без каких-либо учетных данных. Он запустится в режиме начальной загрузки: инструменты, которым нужен доступ к Keboola, объяснят, как получить учетные данные, и один инструмент работает без них — create_project. Он создает новый проект Keboola, подписывает сессию на него и возвращает URL подтверждения. Открыв этот URL в браузере и войдя, вы сделаете проект постоянно вашим; до этого он временный, и Keboola может его забрать, а после подтверждения сессия, созданная инструментом, отзывается, и вы продолжаете работу со своим собственным login.

Для этого нужен стек с включенной подготовкой агентов; в других местах инструмент сообщает, что он недоступен.

Аутентификация без браузера

Для контейнеров или CI, где вход в браузер невозможен, укажите токен доступа или персональный токен доступа Keboola напрямую — установите KBC_STORAGE_TOKEN (переменная окружения) или отправьте заголовок X-StorageAPI-Token — вместе с KBC_PROJECT_ID (или заголовком X-KBC-ProjectId) для выбора проекта. На HTTP-транспортах их можно передавать в каждом запросе как заголовки, так что каждый запрос несет свои учетные данные.

KBC_WORKSPACE_ID

Закрепляет запросы за одним конкретным, уже существующим workspace по его ID вместо поиска на основе схемы, описанного выше, и имеет приоритет над KBC_WORKSPACE_SCHEMA, когда оба установлены. Это вариант, который предоставляет вызывающий Data App / kai-agent, как заголовок X-Workspace-Id, чтобы Kai, встроенный в это приложение, запрашивал данные только через свой собственный workspace.

Устанавливается через переменную окружения KBC_WORKSPACE_ID, флаг CLI --workspace-id или (для каждого запроса, в многопользовательских развертываниях) заголовок X-Workspace-Id.

KBC_STORAGE_API_URL (регион Keboola)

URL API вашего региона Keboola зависит от региона развертывания. Вы можете определить свой регион, посмотрев на URL в браузере при входе в ваш проект Keboola:

РегионURL API
AWS North Americahttps://connection.keboola.com
AWS Europehttps://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 (необязательно)

Чтобы работать с конкретной веткой разработки Keboola, задайте ID ветки с помощью параметра KBC_BRANCH_ID. MCP-сервер ограничивает свою функциональность указанной веткой, гарантируя, что все изменения остаются изолированными и не влияют на производственную ветку.

  • Если параметр не указан, сервер по умолчанию использует производственную ветку.
  • Для разработки задайте KBC_BRANCH_ID равным числовому ID вашей ветки (например, 123456). ID ветки разработки можно найти в URL при переходе к ветке разработки в интерфейсе, например: https://connection.us-east4.gcp.keboola.com/admin/projects/PROJECT_ID/branch/BRANCH_ID/dashboard.
  • На удалённых транспортах вы можете переопределить параметр для каждого запроса с помощью HTTP-заголовка X-Branch-Id: <branchId> или KBC_BRANCH_ID: <branchId>.

Установка

Убедитесь, что у вас есть:

  • Установлен Python 3.10+
  • Доступ к проекту Keboola с правами администратора
  • Предпочитаемый MCP-клиент (Claude, Cursor и т. д.)

Примечание: Убедитесь, что у вас установлен uv. MCP-клиент будет использовать его для автоматической загрузки и запуска Keboola MCP Server. Установка 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

Дополнительные варианты установки см. в официальной документации uv.

Запуск Keboola MCP Server

Существует четыре способа использования Keboola MCP Server в зависимости от ваших потребностей:

Вариант A: Интегрированный режим (рекомендуется)

В этом режиме Claude или Cursor автоматически запускают MCP-сервер за вас.

  1. Войдите один раз в терминале, чтобы сеанс был сохранён (клиент запускает сервер в фоновом режиме, где браузер не может открыться):
    uvx keboola_mcp_server login --api-url https://connection.YOUR_REGION.keboola.com
    
  2. Настройте свой MCP-клиент (Claude/Cursor) с параметрами ниже — требуется только KBC_STORAGE_API_URL.
  3. Клиент автоматически запустит MCP-сервер при необходимости.

Конфигурация Claude Desktop

  1. Перейдите в Claude (левый верхний угол экрана) -> Settings → Developer → Edit Config (если файла claude_desktop_config.json нет, создайте его)
  2. Добавьте следующую конфигурацию:
  3. Перезапустите Claude desktop, чтобы изменения вступили в силу
{
  "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"
      }
    }
  }
}

Расположение файлов конфигурации:

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

Конфигурация Cursor

  1. Перейдите в Settings → MCP
  2. Нажмите "+ Add new global MCP Server"
  3. Настройте с этими параметрами:
{
  "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"
      }
    }
  }
}

Примечание: Используйте короткие описательные имена для MCP-серверов. Поскольку полное имя инструмента включает имя сервера и должно оставаться в пределах ~60 символов, более длинные имена могут быть отфильтрованы в Cursor и не будут отображаться для агента.

Конфигурация Cursor для Windows WSL

При запуске MCP-сервера из подсистемы Windows для Linux с Cursor AI используйте эту конфигурацию:

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

Вариант B: Режим локальной разработки

Для разработчиков, работающих над кодом самого MCP-сервера:

  1. Клонируйте репозиторий и настройте локальное окружение
  2. Настройте Claude/Cursor на использование вашего локального пути 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"
      }
    }
  }
}

Вариант C: Ручной режим CLI (только для тестирования)

Вы можете запустить сервер вручную в терминале для тестирования или отладки:

# 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

Примечание: Этот режим в первую очередь предназначен для отладки или тестирования. Для обычного использования с Claude или Cursor вам не нужно запускать сервер вручную.

Примечание: Сервер будет использовать транспорт Streamable HTTP и прослушивать localhost:8000 для входящих подключений на /mcp. Вы можете использовать параметры --port и --host, чтобы настроить прослушивание в другом месте.

Вариант D: Использование Docker

Контейнер не может открыть браузер, поэтому аутентифицируйтесь с помощью токена (см. Аутентификация без браузера): задайте KBC_STORAGE_TOKEN равным токену доступа Keboola/персональному токену доступа и KBC_PROJECT_ID — целевому проекту. (Через HTTP вы можете вместо этого передавать заголовки X-StorageAPI-Token / X-KBC-ProjectId для каждого запроса и опустить эти параметры.)

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

Примечание: Сервер будет использовать транспорт Streamable HTTP и прослушивать localhost:8000 для входящих подключений на /mcp. Вы можете изменить -p, чтобы переназначить порт контейнера в другое место.

Нужно ли мне запускать сервер самостоятельно?

СценарийНужно ли запускать вручную?Используйте эту настройку
Использование Claude/CursorНетНастройте MCP в настройках приложения
Локальная разработка MCPНет (Claude запускает его)Укажите путь к python в конфигурации
Ручное тестирование CLIДаИспользуйте терминал для запуска
Использование DockerДаЗапустите docker-контейнер

Использование MCP Server

После того как ваш MCP-клиент (Claude/Cursor) настроен и запущен, вы можете начать запрашивать данные Keboola:

Проверка настройки

Вы можете начать с простого запроса, чтобы убедиться, что всё работает:

What buckets and tables are in my Keboola project?

Примеры того, что вы можете делать

Исследование данных:

  • "Какие таблицы содержат информацию о клиентах?"
  • "Выполните запрос, чтобы найти топ-10 клиентов по выручке"

Анализ данных:

  • "Проанализируйте мои данные о продажах по регионам за последний квартал"
  • "Найдите корреляции между возрастом клиентов и частотой покупок"

Конвейеры данных:

  • "Создайте SQL-трансформацию, которая объединяет таблицы клиентов и заказов"
  • "Запустите задачу извлечения данных для моего компонента Salesforce"

Совместимость

Поддержка MCP-клиентов

MCP-клиентСтатус поддержкиМетод подключения
Claude (Desktop & Web)✅ поддерживаетсяstdio
Cursor✅ поддерживаетсяstdio
Windsurf, Zed, Replit✅ Поддерживаетсяstdio
Codeium, Sourcegraph✅ ПоддерживаетсяStreamable HTTP
Пользовательские MCP-клиенты✅ ПоддерживаетсяStreamable HTTP или stdio

Поддерживаемые инструменты

Примечание: Ваши ИИ-агенты автоматически адаптируются к новым инструментам.

Полный список доступных инструментов с подробными описаниями, параметрами и примерами использования см. в TOOLS.md.

Устранение неполадок

Частые проблемы

ПроблемаРешение
Ошибки аутентификацииПовторно выполните keboola_mcp_server login (или, если аутентификация выполняется с помощью токена, проверьте токен и KBC_PROJECT_ID)
Тайм-аут подключенияПроверьте сетевое подключение

Разработка

Установка

Базовая настройка:

uv sync --extra dev

С базовой настройкой вы можете использовать uv run tox для запуска тестов и проверки стиля кода.

Рекомендуемая настройка:

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

С рекомендуемой настройкой будут установлены пакеты для тестирования и проверки стиля кода, что позволяет IDE, таким как VsCode или Cursor, проверять код или запускать тесты во время разработки.

Интеграционные тесты

Чтобы запустить интеграционные тесты локально, используйте uv run tox -e integtests. ПРИМЕЧАНИЕ: Вам потребуется задать следующие переменные окружения:

  • INTEGTEST_POOL_STORAGE_API_URL
  • INTEGTEST_STORAGE_TOKENS
  • INTEGTEST_STORAGE_TOKEN_STORAGE_BRANCHES

Чтобы получить эти значения, вам нужны выделенные проекты Keboola для интеграционных тестов. Каждый тестовый сеанс создаёт собственное рабочее пространство только для чтения, поэтому настраивать схему рабочего пространства не нужно. См. integtests/README.md для подробных инструкций по настройке и документации по проектированию.

Обновление uv.lock

Обновите файл uv.lock, если вы добавили или удалили зависимости. Также рассмотрите возможность обновления блокировки с более новыми версиями зависимостей при создании релиза (uv lock --upgrade).

Обновление документации по инструментам

Когда вы вносите изменения в описания любых инструментов (docstrings в функциях инструментов), вы должны перегенерировать файл документации TOOLS.md, чтобы отразить эти изменения:

uv run python -m src.keboola_mcp_server.generate_tool_docs

Релизы

Мы не выпускаем релиз для каждого объединённого PR. Работа непрерывно попадает в основную ветку (main), и мы выпускаем релизы периодически, после того как изменения будут повторно протестированы вместе — это позволяет избежать нарушения рабочих настроек пользователей.

Релиз создаётся путём отправки одного или двух git-тегов:

  • vX.Y.Z — релиз MCP-сервера (всегда)
  • agent-vX.Y.Z — релиз In Platform Agent (только когда агент также выпускается)

Любой из тегов запускает CI release.yml, который собирает и публикует Docker-образ. KaiBench запускается только на производственных тегах vX.Y.Z (не на agent-vX.Y.Z и не на предрелизах -dev.). Используйте навык release-notes — он готовит заметки о выпуске и черновик PR, а также проводит через тегирование обоих vX.Y.Z и agent-vX.Y.Z.

Поддержка и обратная связь

⭐ Основной способ получить помощь, сообщить об ошибке или запросить функцию — открыть issue на GitHub. ⭐

Команда разработчиков активно отслеживает issues и ответит как можно скорее. Для общей информации о Keboola используйте ресурсы ниже.

Ресурсы

Связь