MaxStat MCP

Официальный удалённый MCP-сервер MaxStat для поиска, аналитики и мониторинга каналов и публикаций в мессенджере MAX.

Разработчик и оператор: ООО «ФБМ Аналитикс» / FBM Analytics.

Русский · English

Получить бесплатный API-токен · Подключить MaxStat MCP · Посмотреть все 21 инструмент · Инструкция для AI-установщика

MaxStat размещает и обслуживает MCP-сервер. В репозитории опубликованы манифесты, плагины, аналитический skill, клиентские конфигурации и документация. Серверная реализация и данные MaxStat не являются открытым исходным кодом.

Русский

Что именно можно получить через MaxStat MCP

AI-агент подключается к живому индексу каналов и публикаций MAX и получает структурированные данные, а не фрагменты поисковой выдачи или вручную собранные скриншоты.

| Область | Какие данные возвращает MCP | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | Поиск каналов | Название, описание, URL, категория, тип доступа, диапазоны аудитории и числа публикаций, сортировка по релевантности, дате или аудитории | | Карточка канала | ID, название, описание, аватар, URL, публичный или закрытый доступ, подписчики, публикации, категории, даты и статус РКН, когда он доступен | | Динамика аудитории | Дневные значения, минимум, максимум, абсолютный и процентный рост за выбранный период | | Просмотры и реакции | Суммарные, средние и максимальные значения на публикацию и дневная история | | Активность канала | Число публикаций, дневная история и распределение по тексту, фото, видео, файлам и другим форматам | | Поиск публикаций | Полнотекстовый поиск с фильтрами по каналу, формату, датам, просмотрам и реакциям | | Карточка публикации | Текст, URL, тип, вложения, просмотры, сумма и разбивка реакций, даты и источник пересылки | | История публикации | Дневные значения просмотров и реакций | | Пересылки | Найденные репосты, их URL, даты и ID каналов назначения | | Мониторинг | Webhook на новые публикации канала или новые публикации по ключевому слову и категории | | Тариф и расход | Статус тарифа, период, включённые, купленные, использованные и оставшиеся кредиты и история списаний |

Также можно добавить публичный или доступный по приглашению канал MAX в очередь отслеживания MaxStat.

Проверенный масштаб индекса

| Проверено 29 июля 2026 года | Живой индекс | | --------------------------- | -------------: | | Каналы MAX | 408 501 | | Публикации | 86 315 758 | | Категории каналов | 42 | | MCP-инструменты | 21 |

Это показатели production на maxstat.ru, а не staging-окружения. Индекс постоянно растёт. Используйте search_channels, search_posts и get_categories, чтобы получить актуальные результаты.

Быстрый старт

1. Создайте токен в личном кабинете MaxStat API.
2. Не публикуйте токен и не добавляйте его в Git.
3. Выберите платформу ниже.
4. Перезапустите клиент и проверьте, что доступны 21 инструмент MaxStat.

| Параметр | Значение | | -------------------- | ---------------------------- | | Endpoint | https://maxstat.ru/api/mcp | | Транспорт | Streamable HTTP | | Авторизация | API-токен | | Заголовок | X-API-Token: <API_TOKEN> | | Переменная окружения | MAXSTAT_API_TOKEN |

Установка по платформам

| Платформа | Способ | | ----------------------- | ------------------------------------------------------- | | Codex / ChatGPT desktop | Репозиторий-маркетплейс и нативный Codex-плагин | | Claude Code | Claude-compatible marketplace | | VS Code | Agent Plugins marketplace или прямой .vscode/mcp.json | | GitHub Copilot CLI | Общий Claude/Copilot marketplace | | Gemini CLI | Gemini extension с защищённой настройкой токена | | Cursor | Установка по ссылке или ~/.cursor/mcp.json | | Windsurf | ~/.codeium/windsurf/mcp_config.json | | JetBrains AI Assistant | MCP-настройки IDE | | Claude Desktop | Локальный мост mcp-remote | | Cline | Удалённый Streamable HTTP из llms-install.md | | Другие клиенты | Универсальный Streamable HTTP JSON |

Codex

До запуска Codex сохраните токен в окружении:

export MAXSTAT_API_TOKEN="<API_TOKEN>"

Добавьте marketplace и установите плагин:

codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins

Плагин подключает MCP с правильным пользовательским заголовком X-API-Token. Не используйте Bearer-настройку: она отправляет другой заголовок и не подходит для MaxStat.

Для прямой установки без плагина объедините configs/codex.toml со своим ~/.codex/config.toml:

[mcp_servers.maxstat]
url = "https://maxstat.ru/api/mcp"
env_http_headers = { "X-API-Token" = "MAXS…[redacted]" }

Claude Code

export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins

Прямая конфигурация находится в configs/claude-code.json.

Visual Studio Code

Добавьте marketplace в settings.json:

{
  "chat.plugins.marketplaces": ["fbmdata/maxstat-mcp"]
}

Откройте Extensions, найдите @agentPlugins, выберите MaxStat MCP и нажмите Install. Для прямого подключения скопируйте configs/vscode.json в .vscode/mcp.json: VS Code безопасно запросит токен через password input.

GitHub Copilot CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins

Claude Code, VS Code и GitHub Copilot CLI используют один совместимый плагин, skill и MCP-конфигурацию.

Gemini CLI

gemini extensions install https://github.com/fbmdata/maxstat-mcp

Расширение запросит MAXSTAT_API_TOKEN как чувствительную настройку и подключит его к заголовку X-API-Token. Инструкции Gemini находятся в GEMINI.md.

Cursor

Перед запуском Cursor задайте MAXSTAT_API_TOKEN, затем нажмите кнопку выше. Альтернатива: объедините configs/cursor.json с ~/.cursor/mcp.json.

Cline

Задайте MAXSTAT_API_TOKEN до запуска Cline и передайте агенту llms-install.md. Файл содержит конфигурацию удалённого Streamable HTTP-сервера и проверку подключения. Локальный npm-пакет не нужен: MaxStat размещает и обслуживает сервер на https://maxstat.ru/api/mcp.

Windsurf

Задайте MAXSTAT_API_TOKEN до запуска Windsurf и объедините configs/windsurf.json с ~/.codeium/windsurf/mcp_config.json. Конфигурация использует нативную подстановку ${env:MAXSTAT_API_TOKEN}.

JetBrains AI Assistant

Откройте Settings → Tools → AI Assistant → Model Context Protocol (MCP), добавьте HTTP-конфигурацию из configs/jetbrains.json и замените <API_TOKEN> локально в IDE. JetBrains пока не документирует подстановку переменной окружения в MCP headers, поэтому placeholder оставлен намеренно.

Claude Desktop

Облачный custom connector Claude не принимает произвольный пользовательский X-API-Token. До внедрения OAuth 2.1 используйте локальный мост из configs/claude-desktop.json. Требуются Node.js и npm; токен сохраняется только в локальной конфигурации Claude Desktop.

Универсальная конфигурация

Используйте configs/generic-mcp.json:

{
  "mcpServers": {
    "maxstat": {
      "type": "streamable-http",
      "url": "https://maxstat.ru/api/mcp",
      "headers": {
        "X-API-Token": "<API_TOKEN>"
      }
    }
  }
}

Все 21 инструмент

Поиск и каталог

| Инструмент | Что возвращает или делает | Кредиты | | ----------------- | ---------------------------------------------------------------- | --------: | | get_categories | Категории и актуальное количество каналов в каждой категории | Бесплатно | | search_channels | Отфильтрованные, отсортированные и постраничные карточки каналов | 3 | | get_channel | Полная карточка одного канала по идентификатору | 1 | | add_channel | Добавляет публичный или invite-only канал в очередь | Бесплатно | | search_posts | Отфильтрованные, отсортированные и постраничные публикации | 3 |

Аналитика каналов

| Инструмент | Что возвращает | Кредиты | | ------------------------- | ----------------------------------------------------------------- | ------: | | get_channel_subscribers | Минимум, максимум, абсолютный и процентный рост и дневную историю | 5 | | get_channel_views | Суммарные, средние и максимальные просмотры и дневную историю | 5 | | get_channel_likes | Суммарные, средние и максимальные реакции и дневную историю | 5 | | get_channel_posts | Число публикаций, форматы и дневную историю активности | 5 |

Аналитика публикаций

| Инструмент | Что возвращает | Кредиты | | ---------------- | ------------------------------------------------------------------ | ------: | | get_post | Контент, вложения, метрики, источник пересылки и найденные репосты | 1 | | get_post_views | Текущее число просмотров и дневную историю | 5 | | get_post_likes | Общее число реакций, разбивку по типам и дневную историю | 5 |

W