Что агент делает в DataLens
Часть инструментов выпустила сама команда DataLens. Остальные написали независимые разработчики, и все работают без VPN.
- Официальный MCP-сервер DataLens при старте забирает OpenAPI-спецификацию и открывает весь публичный API через три инструмента: list_commands, describe_commands и invoke_command. Контекст модели не забивают сотни отдельных методов.
- Скиллы DataLens от того же вендора дают четыре навыка для Claude Code, Codex и OpenCode. datalens-sdk ведет разработку на Python, а datalens-html-pages публикует HTML-отчеты. Скилл datalens-yc-rls-resolve переводит пользователей Yandex Cloud в субъекты RLSv2.
- datalens-mcp оборачивает API в 70 инструментов без удаления. Режим DATALENS_READ_ONLY=1 оставляет агенту только чтение, а clone_entry копирует объекты на стороне сервера.
- DataLens Dev MCP собирает черновики дашбордов по восьми рецептам визуализаций и публикует их отдельным шагом из свежей сохраненной ревизии.
- Сервер на Rust держит каталог из 60 методов на снимке от 18 февраля 2026 года и вызывает новые методы универсальным datalens_rpc.
- MCP для self-hosted DataLens OSS переводит вызовы облачного API во внутренние запросы открытой версии 2.9.0.
Токен и заголовки DataLens API
Публичный API отвечает по адресу api.datalens.tech. Каждый запрос несет IAM-токен в заголовке Authorization, идентификатор организации в x-dl-org-id и версию в x-dl-api-version со значением 1. Идентификатор организации показан в настройках сервиса.
IAM-токен выдает команда yc iam create-token. По документации Yandex Cloud он живет не больше 12 часов, и запрашивать новый советуют каждый час. Официальный сервер вызывает yc сам и обновляет токен до истечения. datalens-mcp читает токен один раз при старте, и после обновления его придется перезапустить. OAuth-токены Яндекса он не принимает. Официальный сервер берет OAuth только для внутренних инсталляций.
Сервер на Rust требует роль datalens.editor или datalens.admin, а остальные работают в пределах прав токена. Официальный сервер добавляется в агента через npx skillfoxx add mcp/datalens-tech-datalens-mcp. Перед записью конфигурации CLI выводит уровень риска.
Как выбрать между официальным и сторонними серверами
Для доступа ко всему API с короткой выдачей инструментов берите официальный сервер с расширенным уровнем доступа. Он хорош, когда задачи разные и заранее неизвестно, какой метод понадобится.
Если агенту нужно только смотреть отчеты, надежнее datalens-mcp с DATALENS_READ_ONLY=1. Его автор пишет, что политика подтверждений носит рекомендательный характер, а жесткую защиту дает только этот режим.
Для сборки дашбордов с публикацией подходит DataLens Dev MCP, но у него широкий доступ: он создает, публикует и удаляет объекты в рабочей организации. Python-разработчику, который пишет код на SDK, полезнее официальные скиллы. Инструмент под свою задачу подберет Foxx AI.
Что может сломаться в рабочей организации
invoke_command вызывает любую команду API, включая изменяющие дашборды и датасеты. Границу задает только роль владельца токена. Создание и правка дашбордов и чартов через API DataLens помечает как экспериментальные. Правка существующих датасетов упирается в ошибку DATASET_REVISION_MISMATCH, и datalens-mcp обходит ее копированием через clone_entry.
Скилл datalens-yc-rls-resolve работает с правами на уровне строк, и ошибка в нем откроет данные не тем людям. Официальный сервер ограничивает ответы 10 МиБ и помечает данные для агента как untrusted_data, чтобы модель не исполняла текст из отчетов как инструкцию.
Начните с чтения на копии воркбука.