Официальный MCP-сервер DataLens
datalens-mcp
Официальный MCP-сервер DataLens от команды разработки: превращает публичный API DataLens в три инструмента-шлюза вместо сотен отдельных MCP-инструментов
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- invoke_command может вызвать любую команду DataLens API, включая изменяющие дашборды и датасеты, в пределах прав IAM-токена
- IAM или OAuth токен дает доступ к организации DataLens под правами пользователя
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/datalens-tech-datalens-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'DATALENS_ORG_ID=<значение DATALENS_ORG_ID>' datalens -- npx -y @datalens-tech/mcp@latestИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"datalens","type":"stdio","command":"npx","args":["-y","@datalens-tech/mcp@latest"],"env":{"DATALENS_ORG_ID":"<значение DATALENS_ORG_ID>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"datalens": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add datalens --env 'DATALENS_ORG_ID=<значение DATALENS_ORG_ID>' -- npx -y @datalens-tech/mcp@latestИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.datalens]
command = "npx"
args = ["-y", "@datalens-tech/mcp@latest"]
env = { DATALENS_ORG_ID = "<значение DATALENS_ORG_ID>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"datalens": {
"type": "local",
"command": [
"npx",
"-y",
"@datalens-tech/mcp@latest"
],
"environment": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": [
"-y",
"@datalens-tech/mcp@latest"
],
"env": {
"DATALENS_ORG_ID": "<значение DATALENS_ORG_ID>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
DATALENS_ORG_IDобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи и настрой yc CLI командой yc init, укажи переменную DATALENS_ORG_ID с id организации, затем добавь сервер через npx -y @datalens-tech/mcp@latest в конфиг MCP-клиента.
Другие способы из описания автора
{
"mcpServers": {
"datalens": {
"command": "npx",
"args": ["-y", "@datalens-tech/mcp@latest"],
"env": {
"DATALENS_ORG_ID": "<org-id>"
}
}
}
}Требует настроенного CLI yc для получения IAM-токена.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
При старте сервер забирает OpenAPI-спецификацию публичного API DataLens и превращает каждый RPC-эндпоинт в вызываемую команду. Вместо регистрации сотен отдельных инструментов, что забило бы контекст модели, он дает шлюз из трех: list_commands перечисляет все команды с кратким описанием, describe_commands возвращает полное описание и схему параметров для нужных команд, invoke_command вызывает команду по имени с параметрами. Авторизация в облаке Yandex Cloud идет через CLI yc: сервер сам получает IAM-токен командой yc iam create-token и обновляет его перед истечением. Для внутренних инсталляций DataLens поддерживается OAuth-токен вместо yc.
Для кого. Для аналитиков и разработчиков на DataLens, которым нужен агентский доступ ко всему публичному API без разбора сотен отдельных методов.
Подходит, если
- Нужен агентский доступ к дашбордам, чартам и датасетам DataLens в Yandex Cloud
- Есть внутренняя инсталляция DataLens и нужен OAuth-доступ вместо yc
- Важно не раздувать контекст модели сотнями отдельных MCP-инструментов
Не подходит, если
- Нет CLI yc и не настроен yc init для облачной установки, и нет OAuth-токена для внутренней
- Нужен готовый набор именованных инструментов по каждой операции, а не шлюз из трех универсальных команд
Пример запроса к агенту
Найди команды DataLens для работы с датасетами и покажи, как вызвать создание нового дашбордаОграничения
IAM-токен через yc живет 12 часов, при статическом токене (DATALENS_YC_STATIC_AUTH) пользователь сам отвечает за его обновление и перезапуск сервера до истечения. Ответы API ограничены по размеру (10 МиБ для вызовов API, 20 МиБ для OpenAPI), а данные, возвращаемые агенту, помечены как untrusted_data и не должны восприниматься как инструкция.
Как отключить. Удалите запись datalens из mcpServers в конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- OAuth
| Переменные окружения | |
|---|---|
| DATALENS_ORG_ID обязательная | Id организации в Yandex Cloud, обязателен для облачной установки |
| DATALENS_INSTALLATION | Тип инсталляции: cloud (по умолчанию) или internal |
| DATALENS_OAUTH_TOKEN секрет | OAuth-токен для внутренней инсталляции DataLens |
| DATALENS_YC_STATIC_AUTH | Использовать статический токен из DATALENS_API_AUTH_HEADER вместо CLI yc |
Проверка безопасности
- invoke_command может вызвать любую команду DataLens API, включая изменяющие дашборды и датасеты, в пределах прав IAM-токена
- IAM или OAuth токен дает доступ к организации DataLens под правами пользователя
Коротко о README
README объясняет схему из трех инструментов-шлюзов, авторизацию через yc CLI и альтернативу статическим токеном, настройку внутренней инсталляции, три способа запуска (npx, глобальная установка, локальная сборка), полную таблицу переменных окружения и подробный раздел про границы безопасности: лимиты размера ответов, отказ от небезопасных редиректов и разметку данных как untrusted_data.
Частые вопросы
Нужен ли отдельный API-ключ?
Нет, для облачной установки достаточно настроенного yc CLI, токен сервер получает сам.
Работает ли с внутренней инсталляцией DataLens?
Да, через DATALENS_INSTALLATION=internal, DATALENS_API_URL и DATALENS_OAUTH_TOKEN вместо yc.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Язык визуализации для агентов и MCP-сервер: из простой семантической спецификации собираются аккуратные графики