Yandex DataLens MCP: дашборды и датасеты через агента в Claude и Cursor

datalens-tech/datalens-mcp· Проверено 12.11.2026· 4на GitHub

Подключает агента к публичному API Yandex DataLens: найти воркбуки, дашборды, чарты и датасеты, прочитать их устройство, скопировать или собрать новые объекты с правами вашего аккаунта.

3 реализации:

Сервер команды DataLens: 5 инструментов-шлюзов поверх всего API, отдельные уровни чтения, записи и привилегированных команд; работает с Yandex Cloud, внутренней и Enterprise-установкой.

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

Что сделать до подключения

Node.js 20.3 или новее

CLI yc от Yandex Cloud: установить и выполнить yc init, чтобы войти и выбрать облако и каталог

DATALENS_ORG_ID

id вашей организации DataLens, уходит в заголовке x-dl-org-id; IAM-токен сервер сам получает через yc iam create-token

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'DATALENS_ORG_ID=<id организации>' --transport stdio datalens \
  -- npx -y --prefer-online @datalens-tech/mcp@latest

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.datalens]
command = "npx"
args = ["-y", "--prefer-online", "@datalens-tech/mcp@latest"]

[mcp_servers.datalens.env]
DATALENS_ORG_ID = "<id организации>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "datalens": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "datalens": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "datalens": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "datalens": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "datalens": {
        "type": "local",
        "command": ["npx", "-y", "--prefer-online", "@datalens-tech/mcp@latest"],
        "environment": {
          "DATALENS_ORG_ID": "<id организации>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "datalens": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "datalens": {
      "command": "npx",
      "args": ["-y", "--prefer-online", "@datalens-tech/mcp@latest"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_commandsперечисляет команды API

describe_commandsпоказывает схему команды

invoke_read_commandвыполняет команду чтения

invoke_write_commandвыполняет команду записи

invoke_privileged_commandвыполняет привилегированную команду

Каждый метод API отдельным инструментом, всего 70; удаление вырезано, режим DATALENS_READ_ONLY=1 оставляет только чтение.

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

Что сделать до подключения

Node.js с npm: склонировать репозиторий и выполнить npm install и npm run build

DATALENS_IAM_TOKEN

IAM-токен из команды yc iam create-token, живёт около 12 часов; OAuth-токены Яндекса не подходят

DATALENS_ORG_ID

id вашей организации DataLens

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'DATALENS_IAM_TOKEN=<IAM-токен>' --env 'DATALENS_ORG_ID=<id организации>' --transport stdio datalens-mcp \
  -- node '<путь к datalens-mcp>/dist/index.js'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.datalens-mcp]
command = "node"
args = ["<путь к datalens-mcp>/dist/index.js"]

[mcp_servers.datalens-mcp.env]
DATALENS_IAM_TOKEN = "<IAM-токен>"
DATALENS_ORG_ID = "<id организации>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "datalens-mcp": {
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "datalens-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "datalens-mcp": {
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "datalens-mcp": {
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "datalens-mcp": {
        "type": "local",
        "command": ["node", "<путь к datalens-mcp>/dist/index.js"],
        "environment": {
          "DATALENS_IAM_TOKEN": "<IAM-токен>",
          "DATALENS_ORG_ID": "<id организации>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "datalens-mcp": {
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "datalens-mcp": {
      "command": "node",
      "args": ["<путь к datalens-mcp>/dist/index.js"],
      "env": {
        "DATALENS_IAM_TOKEN": "<IAM-токен>",
        "DATALENS_ORG_ID": "<id организации>"
      }
    }
  }
}

Инструменты сервера

get_entryчитает любой объект с определением типа

clone_entryкопирует дашборд, датасет или чарт

get_workbooks_listперечисляет воркбуки

get_workbook_entriesпоказывает объекты воркбука

get_collection_contentчитает содержимое коллекции

get_dashboardчитает дашборд

create_dashboardсоздаёт дашборд

update_dashboardменяет дашборд

get_wizard_chartчитает чарт визарда

create_wizard_chartсоздаёт чарт визарда

get_ql_chartчитает QL-чарт

create_ql_chartсоздаёт QL-чарт

get_editor_chartчитает чарт редактора

get_datasetчитает датасет

validate_datasetпроверяет датасет

get_connectionчитает подключение

get_entries_relationsпоказывает связи объектов

start_workbook_exportзапускает выгрузку воркбука

list_embedsперечисляет встраивания

get_audit_entries_updatesчитает журнал изменений

Показано 20 из 70.

Для разработки дашбордов: 8 рецептов чартов, сохранение с обратным чтением, публикация отдельным шагом, бэкап и очистка с проверкой зависимостей.

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

Что сделать до подключения

Python 3.11 или новее

В папке репозитория: python3 -m venv .venv и .venv/bin/python -m pip install .

DATALENS_ORG_ID

id вашей организации DataLens

DATALENS_IAM_TOKEN

IAM-токен; можно положить в ~/.config/datalens-dev-mcp/credentials.env вместо конфига клиента

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'DATALENS_ORG_ID=<id организации>' --env 'DATALENS_IAM_TOKEN=<IAM-токен>' --transport stdio datalens-dev-mcp \
  -- datalens-dev-mcp stdio

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.datalens-dev-mcp]
command = "datalens-dev-mcp"
args = ["stdio"]

[mcp_servers.datalens-dev-mcp.env]
DATALENS_ORG_ID = "<id организации>"
DATALENS_IAM_TOKEN = "<IAM-токен>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "type": "stdio",
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "datalens-dev-mcp": {
        "type": "local",
        "command": ["datalens-dev-mcp", "stdio"],
        "environment": {
          "DATALENS_ORG_ID": "<id организации>",
          "DATALENS_IAM_TOKEN": "<IAM-токен>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "datalens-dev-mcp": {
      "command": "datalens-dev-mcp",
      "args": ["stdio"],
      "env": {
        "DATALENS_ORG_ID": "<id организации>",
        "DATALENS_IAM_TOKEN": "<IAM-токен>"
      }
    }
  }
}

Инструменты сервера

dl_auth_checkпроверяет доступ

dl_workbooks_listперечисляет воркбуки

dl_workbook_entriesпоказывает объекты воркбука

dl_object_getчитает объект по id

dl_object_relationsпоказывает связи объекта

dl_object_revisionsчитает историю ревизий

dl_dashboard_snapshotснимает состояние дашборда

dl_dataset_validateпроверяет датасет

dl_dataset_previewпоказывает данные датасета

dl_compile_recipeсобирает чарт по рецепту

dl_editor_validateпроверяет чарт редактора

dl_object_diffсравнивает версии объекта

dl_object_createсоздаёт объект

dl_object_updateменяет объект

dl_object_publishпубликует сохранённую ревизию

dl_operation_reconcileсверяет итог потерянной записи

dl_backup_exportвыгружает резервную копию

dl_cleanup_previewпоказывает, что будет удалено

dl_cleanup_applyудаляет проверенный набор

Показано 19 из 26.

Что попросить агента

«Покажи, какие дашборды и чарты лежат в воркбуке <название>»Агент вызовет list_commands и describe_commands, затем invoke_read_command; в других вариантах get_workbooks_list и get_workbook_entries

«Скопируй дашборд <id> и переключи его на датасет <id>»Агент вызовет clone_entry с параметром replacements

«Собери чарт KPI по датасету <id> и сохрани в воркбук <id>, публиковать не надо»Агент вызовет dl_compile_recipe, dl_dataset_preview и dl_object_create

«Проверь датасет <id> и покажи первые строки данных»Агент вызовет dl_dataset_validate и dl_dataset_preview

«Сделай резервную копию воркбука <id> и найди объекты, которые можно удалить»Агент вызовет dl_backup_export и dl_cleanup_preview, удалит только после вашего ответа через dl_cleanup_apply

Для каких задач

Найти дашборды, чарты и датасеты воркбука и разобрать, на каких данных они построены

Скопировать дашборд или датасет и подменить в копии источник или SQL

Собрать чарт KPI, сравнения периодов или кросс-таблицу по готовому рецепту

Проверить датасет и посмотреть превью его данных

Выгрузить воркбук в резервную копию и убрать неиспользуемые объекты

Ограничения

Публичный API DataLens сейчас отклоняет правку существующих датасетов ошибкой DATASET_REVISION_MISMATCH: изменённый датасет получают через копию

IAM-токен живёт около 12 часов; при статическом токене его надо обновлять вручную и перезапускать сервер

Подтверждение записи и привилегированных команд держит MCP-клиент: метки в описаниях инструментов вызов не блокируют

У всех трёх репозиториев от 4 до 8 звёзд; вариант osipsemyon не обновлялся с 12.06.2026

Если не работает

Вызовы возвращают 401 или 403 с просьбой обновить токен

Истёк IAM-токен. Получите новый командой yc iam create-token и перезапустите сервер или клиент: токен читается один раз при старте.

update_dataset падает с DATASET_REVISION_MISMATCH

Ограничение публичного API для существующих датасетов. Скопируйте датасет через clone_entry с sourceSubsqlOverrides.

Сервер не находит yc

Укажите полный путь к бинарнику в DATALENS_YC_BIN. Если клиент запускает сервер с урезанным PATH, пропишите абсолютные пути к yc и node.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
DataLens MCPразработчик сервиса	DataLens	4	локально	токен	5	9 ноября 2026
datalens-mcp (osipsemyon)	osipsemyon	8	локально	токен	70	12 июня 2026
datalens-dev-mcp	ADIKANT	7	локально	токен	26	2 ноября 2026

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

Какой вариант выбрать?

DataLens MCP делает команда DataLens, он ставится через npx и поддерживает Cloud, внутреннюю и Enterprise-установку. Вариант osipsemyon даёт по инструменту на метод API, datalens-dev-mcp заточен под сборку и публикацию дашбордов.

Агент может удалить мои дашборды?

У osipsemyon методы удаления вырезаны совсем, а DATALENS_READ_ONLY=1 оставляет только чтение. В datalens-dev-mcp очистка идёт в два шага: dl_cleanup_preview и dl_cleanup_apply на неизменившемся наборе.

Как подключить DataLens Enterprise?

В DataLens MCP задайте DATALENS_INSTALLATION=enterprise, DATALENS_API_URL с адресом установки и DATALENS_SERVICE_ACCOUNT_KEY_FILE с JSON-ключом сервисного аккаунта. Версию пакета закрепите ту, что поддерживает ваш релиз Enterprise.

Что агент видит в DataLens?

Ровно то, что доступно вашему аккаунту или сервисному аккаунту: DataLens проверяет права на каждый вызов API.

Есть ли у Yandex DataLens свой MCP-сервер?

Да, команда DataLens ведёт репозиторий datalens-tech/datalens-mcp, пакет в npm называется @datalens-tech/mcp. Он запускается через npx и берёт IAM-токен из yc.

Как подключить DataLens MCP к Claude Code?

Выполните yc init, затем добавьте сервер с командой npx -y --prefer-online @datalens-tech/mcp@latest и переменной DATALENS_ORG_ID. Готовый фрагмент есть во вкладке Claude Code в блоке «Как подключить».

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и обращаются к API DataLens с вашим аккаунтом Yandex Cloud, зарубежные аккаунты не нужны.

Yandex DataLens MCP: дашборды и датасеты через агента в Claude и Cursor

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

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

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

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