MCP для ИИ-агентов

MCP (Model Context Protocol) — открытый стандарт, по которому ИИ-агенты подключаются к внешним данным. Подключите MCP-сервер Tapbox Стат — и агент сам подберёт каналы под рекламу, соберёт метрики и найдёт упоминания бренда по вашему запросу на обычном языке.

Адрес: https://beta.stat.tapbox.ru/api/mcp
Транспорт: Streamable HTTP, JSON-RPC 2.0
Авторизация: заголовок Authorization: Bearer tbx_ваш_ключ или OAuth — для коннекторов claude.ai
Плагины: github.com/justtake88/tapbox-mcp

У ключа должен быть включён доступ «MCP-сервер». Вызовы инструментов расходуют ту же месячную квоту, что и REST-API.

claude.ai

В claude.ai сервер подключается как коннектор. Ключ в настройки вводить не нужно — вход идёт через Tapbox Стат:

Откройте Настройки → Коннекторы и нажмите Добавить свой коннектор.
Название — «Tapbox Стат», адрес — https://beta.stat.tapbox.ru/api/mcp. Дополнительные настройки оставьте пустыми.
Нажмите Подключить. Откроется страница Tapbox Стат: войдите через MAX, выберите ключ и нажмите Разрешить доступ.

Claude вернёт вас обратно, и инструменты Tapbox Стат появятся в чате. Коннектор, добавленный в claude.ai, работает и в Claude Desktop, и в мобильном приложении Claude.

Что нужно для подключения

Свои коннекторы в claude.ai можно добавлять только с платной подпиской Claude — это подписка на сам Claude, а не тариф Tapbox. В командной подписке Claude коннектор добавляет владелец организации, а участники потом подключаются к нему сами.
Ключ должен быть привязан к вашему аккаунту MAX — только тогда он появится на странице выбора. Если ключа там нет, пришлите нам свой MAX ID: он есть в профиле, в блоке «Настройки», строка «Мой MAX ID». Мы привяжем ключ, и при следующем подключении он появится в списке.

Приложение получает не сам ключ, а отдельный токен доступа, который обновляется автоматически. Работает он с теми же продуктами, лимитами и квотой, что и ключ. Отключить приложение можно в профиле, в разделе «Подключённые приложения». Если отозвать ключ, отключатся и все приложения, подключённые через него.

Claude Code

Плагин ставится двумя командами. При установке Claude Code спросит ключ и сохранит его как секрет:

claude plugin marketplace add justtake88/tapbox-mcp
claude plugin install tapbox-stat@tapbox

Без интерактивного вопроса ключ передаётся флагом:

claude plugin install tapbox-stat@tapbox --config api_key=tbx_ваш_ключ

Сменить ключ — /plugin configure tapbox-stat, проверить подключение — /mcp. Вместе с сервером плагин ставит навык, который подсказывает агенту, какой инструмент брать под задачу.

Подключиться можно и без плагина:

claude mcp add --transport http tapbox https://beta.stat.tapbox.ru/api/mcp \
  --header "Authorization: Bearer tbx_ваш_ключ"

Codex

Сохраните ключ в переменной окружения до запуска Codex и поставьте плагин:

export TAPBOX_API_TOKEN="tbx_ваш_ключ"
codex plugin marketplace add justtake88/tapbox-mcp
codex plugin add tapbox-stat@tapbox

Или добавьте сервер в ~/.codex/config.toml:

[mcp_servers.tapbox]
url = "https://beta.stat.tapbox.ru/api/mcp"
bearer_token_env_var = "TAPBOX_API_TOKEN"

Gemini CLI

gemini extensions install https://github.com/justtake88/tapbox-mcp

Gemini спросит «Ключ Tapbox Стат» и передаст его в заголовок авторизации. Проверить подключение — /mcp.

Cursor, VS Code и другие клиенты

Добавьте блок в настройки MCP клиента (~/.cursor/mcp.json, .vscode/mcp.json и т. п.):

{
  "mcpServers": {
    "tapbox": {
      "url": "https://beta.stat.tapbox.ru/api/mcp",
      "headers": { "Authorization": "Bearer tbx_ваш_ключ" }
    }
  }
}

Claude Desktop через mcp-remote

Проще всего подключить Claude Desktop как коннектор — так же, как в claude.ai. Если нужен вход именно по ключу, подойдёт мост mcp-remote — добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "tapbox": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://beta.stat.tapbox.ru/api/mcp",
        "--header", "Authorization:Bearer tbx_ваш_ключ"
      ]
    }
  }
}

Инструменты

Инструмент	Что делает	Продукт
`list_categories`	Тематики каналов с числом каналов	API Stat
`list_regions`	Регионы с числом каналов	API Stat
`search_channels`	Подбор каналов и чатов: поиск по названию и описанию, фильтры, рейтинг по охвату за 7 и 30 дней	API Stat
`get_channel_overview`	Карточка канала: подписчики, охват за 7 и 30 дней, ERR, индекс цитирования, прирост	API Stat
`get_channel_metrics`	Динамика подписчиков, ERR, число постов, охват за период, скорость набора просмотров	API Stat
`compare_channels`	Сравнение 2–6 каналов	API Stat
`list_channel_posts`	Посты канала за период со сводкой: сумма, средний и медианный охват	API Stat
`get_post_overview`	Разбор поста: кривая просмотров и цитирования	API Stat
`get_citation_index`	Индекс цитирования и его разбор	API Stat
`get_market_overview`	Сводка по всей базе MAX	API Stat
`list_bot_categories`	Категории каталога ботов	API Stat
`search_bots`	Поиск ботов по названию, описанию и категории	API Stat
`get_bot_overview`	Карточка бота, лайки и похожие боты	API Stat
`search_posts`	Полнотекстовый поиск по публикациям	API Search
`analyze_mentions`	Кто упоминает и репостит канал	API Search
`get_account_usage`	Подключённые продукты и остаток лимитов	Не расходует квоту

Все инструменты только читают данные. Ответы сервера сжаты: пустые поля и флаги со значением false опущены, длинные тексты обрезаны до 200 знаков (полностью — full_text: true), время указано по Москве.

avg_reach — средний охват поста за всю историю канала, reach_7d и reach_30d — за последние 7 и 30 полных дней. Рейтинги за период агент строит одним вызовом search_channels с sort=reach_7d — перебирать посты каналов для этого не нужно.

Приветствие и готовые сценарии

После подключения наберите в Claude Code /tapbox-stat:start — агент поздоровается, покажет подключённые продукты и остаток квоты и предложит готовые запросы. В других клиентах достаточно спросить «что ты умеешь?».

Сервер отдаёт готовые сценарии — MCP-промпты. Клиенты, которые их поддерживают, показывают их как команды: в Claude Code — в списке слеш-команд сервера tapbox. Промпты квоту не расходуют, тратятся только вызовы инструментов внутри сценария.

Сценарий	Что делает	Что указать
Старт	Приветствие, подключённые продукты, остаток квоты, примеры запросов	—
Подбор каналов под рекламу	Кандидаты по теме, таблица метрик, отметка подозрительного роста, рекомендация	тема, регион, минимум подписчиков
Разбор канала для рекламодателя	Аудитория и рост, вовлечённость, контент, цитируемость, красные флаги, вывод	канал
Проверка на накрутку	Скачки подписчиков, рост без охвата, связанное цитирование, оценка риска	канал
Мониторинг бренда	Динамика упоминаний, каналы, самые просматриваемые посты. Нужен API Search	бренд, за сколько дней
Сравнение каналов	Таблица метрик, сильные и слабые стороны, вывод для рекламы	2–6 каналов
Что растёт в MAX	Сводка рынка, быстрорастущие тематики и каналы, идеи для контента	тематика
Подбор ботов	Боты под задачу с категорией, лайками и возможностями	задача
Топ каналов региона или города	Рейтинг по охвату за 7 или 30 дней без госорганизаций — одним вызовом	регион или город, период

Что спросить

«Дай топ-20 каналов Барнаула по охвату за последнюю неделю без госорганизаций».
«Подбери 10 каналов MAX про финансы от 20 тысяч подписчиков с ERR выше 15%, покажи таблицей».
«Сравни каналы newmedia и mash по подписчикам, охвату, ERR и индексу цитирования. Кого выгоднее взять под рекламу?»
«Найди посты за последний месяц, где упоминается наш бренд, и сгруппируй по каналам».
«Кто вырос сильнее всех за неделю? У кого рост не сходится с числом постов и цитированием?»

claude.ai​

Claude Code​

Codex​

Gemini CLI​

Cursor, VS Code и другие клиенты​

Claude Desktop через mcp-remote​

Инструменты​

Приветствие и готовые сценарии​

Что спросить​