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; есть режим только для чтения и ветки разработки.
Настройка клиентов
{
"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/mcpClaude 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.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.