MaxStat MCP: как подключить данные MAX к Codex, Claude и Cursor
Пошагово подключаем данные из «МАКСА» через MaxStat MCP к популярным AI-инструментам: Codex, Claude и Cursor. Проверяем соединение и начинаем искать каналы, публикации и метрики MAX обычными запросами.
27 июля 2026 г.11 минут чтения757
MaxStat MCP позволяет подключить данные о каналах и публикациях MAX прямо к AI-агенту. Вместо отдельного API-клиента, ручной сборки запросов и обработки каждого ответа вы описываете задачу обычным языком — агент сам выбирает подходящий инструмент MaxStat, передаёт параметры и возвращает результат в рабочий контекст.
В этой инструкции разберём весь путь: от получения API-токена до первого запроса в Codex CLI, Claude Code, Cursor, Claude Desktop или другом MCP-клиенте. В конце приведём готовые сценарии, рекомендации по безопасности и решения типовых проблем.
Что такое MaxStat MCP
MCP, или Model Context Protocol, — это протокол, через который AI-клиенты подключают внешние данные и инструменты. В случае MaxStat агент получает понятный набор операций для работы с каналами, публикациями и их динамикой.
Обычная интеграция с API состоит из нескольких этапов: нужно изучить документацию, написать клиент, собрать запрос, обработать пагинацию и преобразовать ответ. MCP оставляет эту техническую работу агенту. Пользователь формулирует цель, а AI-клиент подбирает необходимые операции и последовательно вызывает их.
Например, запрос:
Найди 20 быстрорастущих каналов MAX о технологиях за последние 30 дней и сравни их по приросту подписчиков и средним просмотрам.
может привести к последовательному вызову поиска каналов, получения динамики подписчиков и статистики просмотров. Результаты остаются в контексте агента: их можно сразу превратить в таблицу, выводы, график, отчёт или прототип интерфейса.
Что понадобится
Перед подключением подготовьте:
- Учётную запись MaxStat.
- Активный тариф MaxStat API . MCP включён во все API-тарифы без отдельной доплаты.
- Действующий API-токен.
- MCP-клиент: Codex CLI, Claude Code, Cursor, Claude Desktop или другой клиент с поддержкой remote Streamable HTTP.
Сервер MaxStat MCP доступен по адресу:
textcode
Запросы через MCP и прямой API используют единый лимит операций вашего тарифа. Если один и тот же аккаунт одновременно работает через API и MCP, расход операций суммируется.
Как получить API-токен
Откройте страницу управления API:
textcode
Если API-доступ ещё не активирован, выберите подходящий тариф. После активации скопируйте API-токен из кабинета и сохраните его в менеджере секретов либо в переменной окружения.
API-токен даёт доступ к операциям вашего аккаунта. Поэтому:
не публикуйте его в статье, чате, скриншотах и задачах;
не добавляйте токен в Git и файлы, которые синхронизируются с общим репозиторием;
не вставляйте его в URL;
используйте переменные окружения или встроенное хранилище секретов клиента;
если токен попал в публичный доступ, сразу отзовите его и выпустите новый.
Во всех примерах ниже
<API_TOKEN> означает ваш реальный токен. Сам плейсхолдер нужно заменить, но публиковать получившуюся конфигурацию нельзя.Подключение MaxStat MCP к Codex CLI
Для Codex CLI удобно хранить токен в переменной окружения. В терминале выполните:
bashcode
Первая команда записывает токен в окружение текущего терминала. Вторая добавляет сервер с именем
maxstat в конфигурацию Codex.Проверьте регистрацию сервера:
bashcode
После добавления запустите новую сессию Codex из того же окружения. Это важно: процесс должен видеть переменную
MAXSTAT_API_TOKEN . Если Codex уже был открыт, перезапустите его.Для первой проверки попросите агента:
Покажи доступные инструменты MaxStat, затем найди пять каналов MAX о разработке программного обеспечения.
Если подключение выполнено правильно, агент увидит сервер
maxstat , выберет инструмент поиска каналов и вернёт структурированный результат.Подключение к Claude Code
На промо-странице MaxStat доступна готовая команда для Claude Code:
bashcode
Команда создаёт HTTP-подключение с именем
maxstat и передаёт токен в заголовке X-API-Token .После выполнения перезапустите сессию Claude Code и проверьте подключение запросом:
Используй MaxStat и найди десять каналов с похожей аудиторией и тематикой на канал о технологиях.
Если команда не распознаётся, сначала проверьте установленную версию Claude Code и доступность подкоманды
mcp . Если сервер добавлен, но инструменты не появились, полностью перезапустите клиент.Подключение к Cursor
В проекте Cursor создайте или откройте файл
.cursor/mcp.json и добавьте сервер:
jsoncode
До запуска Cursor задайте переменную окружения:
bashcode
После изменения конфигурации перезапустите Cursor или перезагрузите MCP-сервер в настройках клиента. Убедитесь, что Cursor действительно получает переменную окружения. На macOS приложение, запущенное из Dock, может не наследовать переменные текущего терминала; в этом случае используйте поддерживаемое Cursor хранилище секретов или запускайте приложение из окружения, где задан токен.
Не коммитьте
.cursor/mcp.json , если вместо переменной окружения в нём записано реальное значение токена.Подключение к Claude Desktop
Для Claude Desktop remote MCP-сервер можно подключить через пакет
mcp-remote . Добавьте в claude_desktop_config.json :
jsoncode
Для такого варианта на компьютере должны быть доступны Node.js,
npm и команда npx . Переменная MAXSTAT_API_TOKEN должна быть видна процессу Claude Desktop.После сохранения файла полностью закройте и заново откройте Claude Desktop. Затем создайте новый диалог и попросите показать инструменты MaxStat либо выполнить простой поиск каналов.
💡 Если клиент не подхватывает переменную окружения, используйте рекомендованный для вашей версии Claude Desktop способ хранения секретов. Не публикуйте конфигурацию с подставленным токеном.
Универсальная конфигурация для MCP-клиента
Если ваш клиент поддерживает remote Streamable HTTP, базовая запись сервера выглядит так:
jsoncode
Некоторые клиенты ожидают эту запись внутри объекта
mcpServers , другие используют отдельный экран добавления сервера. В интерфейсе укажите:имя сервера —
maxstat ;транспорт —
Streamable HTTP ;URL —
https://maxstat.ru/api/mcp ;заголовок —
X-API-Token ;значение заголовка — ваш API-токен, желательно из хранилища секретов.
Не выбирайте локальный
stdio -транспорт для прямого подключения к endpoint MaxStat. Исключение — клиенты вроде Claude Desktop, где локальная команда mcp-remote выступает промежуточным адаптером.Как проверить подключение
Начните не со сложного отчёта, а с короткой диагностической задачи:
Покажи список доступных инструментов MaxStat и кратко объясни назначение каждого.
Затем выполните запрос с понятным результатом:
Найди пять каналов MAX, в названии или описании которых встречается слово «технологии». Верни название, ссылку и число подписчиков.
Успешное подключение выглядит так:
- AI-клиент видит сервер
maxstat.
- Агент показывает или выбирает инструмент MaxStat.
- Перед вызовом отображаются параметры поиска.
- Сервер возвращает структурированные данные.
- Агент преобразует ответ в таблицу или краткое резюме.
💡 В зависимости от настроек клиента перед вызовом инструмента может потребоваться подтверждение пользователя. Это нормальный механизм контроля.
Что можно делать через MaxStat MCP
MCP особенно полезен, когда задача состоит из нескольких исследовательских шагов и заранее неизвестно, какие именно запросы понадобятся.
Искать подходящие каналы
Агент может искать каналы по названию, описанию, ссылке, категории, размеру аудитории и числу публикаций.
Пример:
Найди 20 каналов MAX о финансах с аудиторией от 10 000 подписчиков. Отсортируй по числу подписчиков и верни ссылки.
Анализировать динамику
Можно изучать изменение подписчиков, просмотров, реакций и публикационной активности за период.
Пример:
Для этих пяти каналов сравни прирост подписчиков за последние 30 дней, средние просмотры и количество публикаций. Отметь лидеров по каждому показателю.
Искать публикации
Поиск доступен по тексту, каналу, типу публикации, датам, просмотрам и лайкам.
Пример:
Найди публикации про ипотеку за июнь. Верни канал, дату, ссылку, просмотры и реакции. Отдельно выдели десять самых просматриваемых постов.
Сравнивать площадки
Агент может последовательно получить карточки нескольких каналов и подготовить единое сравнение.
Пример:
Сравни эти каналы по аудитории, динамике подписчиков, средним просмотрам и частоте публикаций. Итог оформи в таблицу и добавь три вывода.
Создавать прототипы и отчёты
Данные можно использовать в процессе разработки: попросить агента собрать таблицу, график, внутренний дашборд или демонстрационный интерфейс.
Пример:
Создай в проекте страницу рейтинга каналов MAX. Получи данные через MaxStat MCP, покажи прирост за 30 дней и добавь фильтр по категории.
Основные инструменты MaxStat MCP
Агент получает актуальные публичные операции MaxStat как MCP-инструменты. В текущем наборе представлены:
search_channels — поиск каналов по названию, описанию, ссылке, категории, аудитории и числу публикаций;get_channel — полная карточка канала по ID;get_categories — категории и количество каналов в каждой из них;add_channel — добавление публичного или пригласительного канала в очередь на отслеживание;get_channel_subscribers — минимум, максимум и прирост подписчиков за период;get_channel_views — суммарные, средние и максимальные просмотры публикаций;get_channel_likes — статистика лайков публикаций канала;get_channel_posts — количество публикаций, распределение по типам и дневная история;search_posts — поиск публикаций по тексту, каналу, формату, датам и метрикам;get_post — текст, вложения, ссылка и текущие метрики публикации;get_post_views — текущие просмотры и дневная история;get_post_likes — реакции и дневная история лайков.Набор инструментов может расширяться вместе с публичными операциями MaxStat. Чтобы не зависеть от устаревшего списка, в начале сложной задачи можно попросить агента показать доступные инструменты и их параметры.
Обратите внимание на
add_channel : этот инструмент не просто читает данные, а добавляет канал в очередь на отслеживание. Используйте его осознанно и проверяйте параметры перед подтверждением вызова.MCP или прямой API: что выбрать
Выбирайте MaxStat MCP, если:
пользователь работает через AI-агента;
задача формулируется естественным языком;
нужен исследовательский поиск и несколько последовательных операций;
вы собираете отчёт, аналитику, прототип или внутренний инструмент;
важна скорость перехода от вопроса к результату.
Выбирайте прямой MaxStat API, если:
строится стабильная backend-интеграция;
требуется production-нагрузка;
выполняется массовая обработка данных;
нужен полный контроль запросов, повторов и обработки ошибок;
процесс запускается автоматически без AI-агента;
используются webhook-уведомления.
MCP не заменяет API: это дополнительный способ использовать тот же доступ. Для прототипа можно начать с MCP, проверить сценарий, а затем перенести устойчивый процесс на прямую интеграцию.
Лимиты операций
MCP входит во все тарифы MaxStat API без дополнительной оплаты. При этом вызовы MCP-инструментов расходуют тот же лимит операций, что и прямые API-запросы.
Одна пользовательская задача может вызвать несколько инструментов. Например, поиск каналов, получение карточек и анализ динамики — это отдельные операции. Поэтому:
формулируйте фильтры и период сразу;
ограничивайте число результатов;
не просите повторно получать данные, которые уже находятся в контексте;
для регулярной массовой обработки используйте прямой API;
контролируйте остаток операций в кабинете.
Типовые проблемы и решения
Клиент не видит сервер MaxStat
Проверьте имя и расположение конфигурационного файла, затем полностью перезапустите клиент. Убедитесь, что JSON корректен и сервер находится в ожидаемом объекте
mcpServers .Ошибка авторизации
Проверьте, что токен активен, в нём нет лишних пробелов и он передаётся именно тем способом, который указан для клиента. Для универсального подключения нужен заголовок
X-API-Token . Для Codex CLI используйте готовую конфигурацию с --bearer-token-env-var .Переменная окружения не найдена
Запустите клиент из окружения, где задана
MAXSTAT_API_TOKEN , либо используйте встроенное хранилище секретов. После изменения переменной перезапустите приложение.Инструменты не появились после добавления сервера
Создайте новую сессию агента. Некоторые клиенты загружают перечень MCP-инструментов только при старте сессии.
Сервер подключён, но запрос слишком широкий
Уточните категорию, период, минимальную аудиторию, метрику сортировки и максимальное число результатов. Попросите агента сначала показать план вызовов, если задача может потратить много операций.
Исчерпан лимит
Проверьте использование API в кабинете MaxStat. Поскольку MCP и API используют общий лимит, учитывайте оба источника расхода.
Чек-лист безопасного подключения
Перед началом работы убедитесь:
endpoint указан как
https://maxstat.ru/api/mcp ;соединение использует HTTPS;
токен хранится локально и не попадает в репозиторий;
в конфигурации по возможности используется переменная окружения;
скриншоты и логи не содержат реального токена;
клиент запрашивает подтверждение для изменяющих операций;
широкие аналитические задачи ограничены периодом и числом результатов.
Начните с первого запроса
MaxStat MCP сокращает путь от вопроса о данных MAX до готового результата. Разработчику не нужно писать отдельный клиент для каждой гипотезы, аналитику — вручную собирать цепочку запросов, а продуктовой команде — откладывать проверку идеи до готовности backend-интеграции.
Получите доступ к MaxStat API, подключите MCP-сервер к своему AI-клиенту и начните с простого запроса:
Найди десять быстрорастущих каналов MAX в моей тематике за последние 30 дней и объясни, какие метрики использовались для сравнения.
Страница MaxStat MCP с готовыми конфигурациями:
textcode
Управление API-доступом:
textcode
