Как подключить MaxStat MCP к Yandex AI Studio
От API-токена до первого аналитического запроса агента. Пошаговое руководство MaxStat MCP.
07 августа 2026 г.5 минут чтения1 999
Содержание:
Краткая карта подключенияЧто понадобитсяШаг 1. Получите API-токен MaxStatШаг 2. Откройте MCP Hub в Yandex AI StudioШаг 3. Выберите внешний MCP-серверШаг 4. Создайте карточку сервераШаг 5. Укажите параметры подключенияШаг 6. Выберите инструменты и подключите агентаДля поиска и анализа каналовДля анализа публикацийПроверка подключенияЕсли подключение не работаетКонтрольный список перед завершениемРекомендации по безопасностиПолезные ссылки
Рисунок 1. MaxStat MCP связывает AI-клиент с каналами, публикациями и метриками MAX.
РЕЗУЛЬТАТ. После настройки в MCP Hub появится сервер maxstat-mcp. Текстовый агент сможет искать каналы и публикации MAX, получать динамику подписчиков, просмотров и реакций.
Актуально для интерфейса Yandex AI Studio на август 2026 года.
Краткая карта подключения
- Получить API-токен MaxStat в личном кабинете.
- Открыть Agent Atelier → MCP-серверы в Yandex AI Studio.
- Выбрать способ «Внешний MCP-сервер».
- Создать карточку сервера с именем maxstat-mcp.
- Указать URL, Streamable HTTP и заголовок X-API-Token.
- Выбрать инструменты, сохранить сервер и подключить его к агенту.
ВАЖНО. Во всех примерах ниже реальный API-токен скрыт. Не добавляйте токен в скриншоты, документы, сообщения или репозитории.
Что понадобится
- Аккаунт MaxStat и действующий API-токен .
- Доступ к нужному каталогу Yandex AI Studio .
- Для создания: роли serverless.mcpGateways.editor и iam.serviceAccounts.user или более высокие.
- Для обращения агента к внешнему серверу: serverless.mcpGateways.invoker и serverless.mcpGateways.anonymousInvoker или более высокие.
Готовые параметры MaxStat
Поле | Значение |
|---|---|
URL | |
Транспорт | Streamable HTTP |
Тип авторизации | Токен доступа |
Заголовок | X-API-Token |
Значение | Ваш API-токен MaxStat, без префикса Bearer |
Шаг 1. Получите API-токен MaxStat
- Войдите в MaxStat.
- Откройте раздел API в личном кабинете: https://maxstat.ru/dashboard/api .
- Скопируйте API-токен и сохраните его в защищённом хранилище.
MaxStat MCP входит во все тарифы API без отдельной доплаты. Запросы через MCP расходуют общий лимит API-кредитов вашего тарифа.
Рисунок 2. MaxStat публикует готовый адрес MCP-сервера и имя заголовка авторизации.
НЕ КОПИРУЙТЕ БУКВАЛЬНО. Текст<API_TOKEN> на изображении — заполнитель. В Yandex AI Studio замените его реальным токеном из личного кабинета MaxStat.
Шаг 2. Откройте MCP Hub в Yandex AI Studio
- Откройте нужный каталог Yandex AI Studio.
- В левом меню разверните Agent Atelier.
- Выберите MCP-серверы.
- Нажмите «Создать MCP-сервер» или «Подключить MCP-сервер».
Рисунок 3. На главной странице AI Studio доступна команда «Подключить MCP-сервер».
Шаг 3. Выберите внешний MCP-сервер
Нажмите карточку «Внешний MCP-сервер». Этот вариант подходит для MaxStat, потому что сервер уже развёрнут вне Yandex AI Studio. Варианты HTTP/HTTPS, Cloud Functions и Workflows предназначены для создания собственных серверов или прокси.
Рисунок 4. Выберите карточку «Внешний MCP-сервер».
Шаг 4. Создайте карточку сервера
- В поле «Имя» укажите maxstat-mcp.
- Описание и метки добавьте по желанию.
- Для базового подключения оставьте выключенными «Добавить подсеть», «Запись логов», «Указать сервисный аккаунт» и «Сделать MCP-сервер публичным».
- Нажмите «Создать».
ТРЕБОВАНИЯ К ИМЕНИ. От 3 до 63 символов; только строчные латинские буквы, цифры и дефисы; первый символ — буква, последний — не дефис.
Рисунок 5. Безопасное имя сервера — maxstat-mcp; дополнительные опции выключены.
Шаг 5. Укажите параметры подключения
В следующем окне заполните поля строго по таблице «Готовые параметры MaxStat»: URL https://maxstat.ru/api/mcp , транспорт Streamable HTTP, тип авторизации «Токен доступа», заголовок X-API-Token и реальное значение токена.
- Передавайте токен как есть — без Bearer, кавычек и лишних пробелов.
- Не выбирайте устаревший транспорт HTTP with SSE.
- Нажмите «Подключиться» и дождитесь загрузки списка инструментов.
Рисунок 6. Официальная инструкция Yandex: URL, Streamable HTTP, токен доступа, подключение и выбор инструментов.
ЛИМИТ. Один MCP-сервер в Yandex AI Studio может содержать до 50 инструментов.
Шаг 6. Выберите инструменты и подключите агента
После успешного соединения откроется блок «Инструменты». Отметьте операции, которые нужны агенту, и нажмите «Сохранить».
Для поиска и анализа каналов
search_channels — поиск каналов по названию, описанию, категории и метрикам.
get_channel — полная карточка канала.
get_categories — список категорий.
get_channel_subscribers — динамика подписчиков.
get_channel_views — просмотры.
get_channel_posts — публикационная активность.
get_channel_likes — реакции.
Для анализа публикаций
search_posts — поиск публикаций.
get_post — карточка публикации.
get_post_views — динамика просмотров.
get_post_likes — реакции на публикацию.
Рисунок 7. Примеры инструментов MaxStat, которые увидит AI-агент.
Подключение к текстовому агенту: откройте Agent Atelier → Текстовые агенты, создайте или выберите агента, добавьте maxstat-mcp в его инструменты и сохраните настройки.
Проверка подключения
ТЕСТОВЫЙ ЗАПРОС. Найди 10 быстрорастущих каналов MAX о технологиях за последние 30 дней. Сравни прирост подписчиков, просмотры и частоту публикаций, затем верни таблицу с краткими выводами.
Ожидаемая цепочка инструментов: search_channels → get_channel_subscribers → get_channel_views → get_channel_posts.
Рисунок 8. Примеры запросов: поиск каналов, сравнение площадок, исследование публикаций и прототипирование.
Если подключение не работает
401 / Unauthorized. Проверьте X-API-Token. Токен передаётся без Bearer, кавычек, переносов и лишних пробелов.
403 в Yandex AI Studio. Проверьте роли каталога. Для создания нужны serverless.mcpGateways.editor и iam.serviceAccounts.user; для вызова — serverless.mcpGateways.invoker и serverless.mcpGateways.anonymousInvoker или более высокие.
Список инструментов пуст. Переподключите сервер, проверьте токен и доступный лимит API-кредитов MaxStat.
Контрольный список перед завершением
- URL сервера указан без опечаток.
- Выбран Streamable HTTP.
- Заголовок называется X-API-Token.
- Токен вставлен без префикса Bearer.
- Публичный доступ не включён без необходимости.
- Выбраны только необходимые инструменты.
- Сервер сохранён и добавлен к текстовому агенту.
- Тестовый запрос завершился вызовом инструментов MaxStat.
Рекомендации по безопасности
- Не публикуйте API-токен в документах, статьях, скриншотах и репозиториях.
- Не включайте публичный доступ к MCP-серверу без явной необходимости.
- Используйте отдельный токен для интеграции, если ваша политика доступа это поддерживает.
- Периодически заменяйте токен и удаляйте неиспользуемые подключения.
- Оставляйте агенту только действительно необходимые инструменты.
Полезные ссылки
Другие материалы по теме:
