mcp-server

mcp-server — официальный MCP-сервер от keboola. Подключение ИИ-ассистентов к Keboola: данные, трансформации и SQL-запросы. Ставится через uvx. Доступен и как удалённый сервер. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
keboola
Лицензия
MIT
Транспорт
stdio, streamable_http
Авторизация
oauth
ОС
Не указана
Языки
python

Уровень риска: high

Запускает задания, создаёт конфигурации, трансформации и дата-приложения в проекте Keboola; есть режим только для чтения и ветки разработки.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"keboola\": {\n      \"command\": \"uvx\",\n      \"args\": [\"keboola_mcp_server --transport <transport>\"],\n      \"env\": {\n        \"KBC_STORAGE_API_URL\": \"https://connection.YOUR_REGION.keboola.com\",\n        \"KBC_BRANCH_ID\": \"your_branch_id_optional\"\n      }\n    }\n  }\n}",
    "lang": "json",
    "notes": "Сначала uvx keboola_mcp_server login",
    "verified": "docs"
}

Что умеет

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

Возможности:

  • Хранилище — запросы к таблицам и управление описаниями таблиц и бакетов.
  • Компоненты — создание, просмотр и изучение экстракторов, райтеров, дата-приложений и конфигураций трансформаций.
  • SQL — создание SQL-трансформаций по описанию на естественном языке.
  • Задания — запуск компонентов и трансформаций, сведения о выполнении.
  • Потоки — сборка и управление конвейерами Conditional Flows и Orchestrator Flows.
  • Дата-приложения — создание, развёртывание и управление приложениями Keboola (python-js и Streamlit).
  • Метаданные — поиск, чтение и обновление документации проекта и метаданных объектов.
  • Ветки разработки — работа вне продакшена: все операции ограничены выбранной веткой (KBC_BRANCH_ID).

Контроль доступа. В режиме HTTP набор инструментов ограничивается заголовками: X-Allowed-Tools (разрешённые), X-Disallowed-Tools (исключённые) и X-Read-Only-Mode (только чтение). Фильтры применяются по порядку: разрешённые, затем пересечение с режимом чтения, затем исключения.

Без аккаунта. Если запустить сервер только с адресом региона и без учётных данных, он работает в режиме начальной настройки. В нём доступен инструмент create_project, который создаёт новый проект на стеке с включённым автоматическим созданием проектов.

Кому подойдёт

  • Командам данных на Keboola, которые хотят запрашивать данные и строить конвейеры через ассистента.
  • Аналитикам — для запросов и разборов данных на естественном языке.

Похожие серверы — в категории данные и аналитика.

Установка

Проще всего подключить удалённый сервер: он размещён на каждом многопользовательском стеке Keboola и поддерживает OAuth. Адрес сервера есть в настройках проекта на вкладке MCP Server; при подключении нужно войти в аккаунт Keboola, а проект выбирается уже в разговоре. Для локального запуска нужен uv. Один раз войдите через браузер командой uvx keboola_mcp_server login с адресом своего региона — сессия сохранится в ~/.keboola/mcp/credentials.json и будет обновляться автоматически. Для CI без браузера можно передать токен в KBC_STORAGE_TOKEN.

Подключение к клиентам

Конфиги приведены дословно из README; подставьте свой регион, а в локальных конфигах — транспорт (по умолчанию stdio). Подробнее — в инструкции как подключить MCP.

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

Claude Code подключается к удалённому серверу; README приводит готовые адреса для регионов AWS, GCP и Azure в США и Европе. Конфиги Claude Desktop (Settings → Developer → Edit Config, файл claude_desktop_config.json) и Cursor (Settings → MCP) запускают сервер локально: клиент стартует его сам, нужно только заранее войти через login. Удалённый сервер в Claude Desktop добавляется через Settings → Integrations, в Cursor — кнопкой установки в настройках проекта.

Проверка

Спросите ассистента, какие бакеты и таблицы есть в вашем проекте Keboola.

Примеры задач

Найди 10 клиентов с наибольшей выручкой.
Создай SQL-трансформацию, которая объединяет таблицы клиентов и заказов.

Риски

  • Изменения в проекте. Агент запускает задания, создаёт конфигурации, трансформации и приложения. Для безопасной работы используйте ветку разработки или режим только для чтения.
  • Сессия и токены. Сессия хранится в ~/.keboola/mcp/credentials.json; токен для CI держите в переменных окружения.
  • Политики безопасности строк и столбцов. Сервер их не читает и не применяет: это делает сама платформа Keboola.

Частые вопросы

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

Нет: Claude и Cursor запускают его сами, вручную — только для тестов в командной строке и в Docker.

Можно ли ограничить агента чтением?

Да, заголовком X-Read-Only-Mode: true в режиме HTTP.

Работает ли без аккаунта?

Да, в режиме начальной настройки с инструментом create_project.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники