Документация
AI-агент как стратег команды через MCP
Подключите Claude, ChatGPT, Cursor или Claude Code — и в команде появляется стратег с прямым доступом ко всей картине мониторинга. Гайд по подключению + примеры работы: разбор причин пробелов, ТЗ статей, отчёты — всё прямо в чате
Открыть в дашбордеAI-агент как стратег вашей команды
Через MCP вы добавляете в команду стратега, который работает с данными мониторинга на глубине, недоступной через интерфейс. Он читает ответы AI целиком, прорабатывает каждый источник цитирования, сравнивает с конкурентами, итерирует на гипотезах, собирает стратегию и ТЗ. Спрашиваете «почему AI отвечает именно так», «как должна выглядеть статья, чтобы попасть в этот промпт», «соберём content roadmap на квартал» — и получаете полноценный аналитический разбор, не пересказ цифр из дашборда. Этим стратегом может быть Claude, ChatGPT, Cursor или любой другой MCP-совместимый AI. Технически MCP (Model Context Protocol) — это стандарт, который и обеспечивает агенту такой доступ.
- В роли стратега — Claude Desktop, ChatGPT (через Custom Connectors), Cursor, Claude Code, Codex или любой другой MCP-совместимый клиент
- Подключение через OAuth (выбор бренда на экране согласия GEO Scout) или через личный токен (PAT) для скриптов и self-hosted клиентов
- Read-only — стратег читает данные и анализирует их, но ничего не меняет в системе
- На руках у стратега — всё, что есть в дашборде, плюс полные тексты ответов AI: метрики, источники, конкуренты, промпты, цитаты, действия и контент-планы
AI-стратег не «лёгкая альтернатива дашборду». Это слой глубокой работы поверх данных: то, чем обычно занят senior-маркетолог или внешний консультант, выполняется в диалоге за один вечер. Дашборд показывает срезы, Командный центр расставляет приоритеты, AI-стратег делает аналитику и стратегию.
Claude Desktop
Claude Desktop работает по stdio-протоколу, поэтому подключается к HTTP MCP через мост mcp-remote (npm-пакет). npx устанавливает его автоматически — нужен только Node.js 18+ на машине.
- Откройте файл `claude_desktop_config.json` (на macOS: `~/Library/Application Support/Claude/`, на Windows: `%APPDATA%\Claude\`). Если файла нет — создайте его
- Добавьте блок `mcpServers` с командой `npx -y mcp-remote https://geoscout.pro/api/mcp` (точный JSON есть на странице /mcp в дашборде, в разделе Claude Desktop)
- Сохраните файл и полностью перезапустите Claude Desktop. При первом запуске npx скачает mcp-remote и откроет браузер для OAuth-авторизации
- На экране согласия GEO Scout выберите бренд, к которому даёте доступ агенту, и подтвердите. Можно подключить несколько брендов через отдельные MCP-серверы в одном конфиге
- В Claude Desktop появится индикатор подключённого MCP-сервера в нижней части окна чата — значит подключение готово
Для подключения по личному токену (PAT) добавьте к args флаг `--header "Authorization: Bearer gs_<ваш-токен>"`. На Windows из-за бага с экранированием пробелов лучше задать токен через переменную окружения `AUTH_HEADER` (значение `Bearer gs_...`) и подставить её в args как `Authorization:$AUTH_HEADER` — точные сниппеты есть на странице /mcp.
ChatGPT (Custom Connectors)
ChatGPT поддерживает remote MCP-серверы через Custom Connectors в платных тарифах (Plus, Pro, Team, Enterprise). Подключение полностью через UI — никаких файлов конфигурации.
- Откройте chatgpt.com → Settings → Connectors → «Add custom connector»
- Вставьте URL `https://geoscout.pro/api/mcp` и нажмите «Add»
- ChatGPT автоматически найдёт OAuth-метаданные и откроет экран согласия GEO Scout — выберите бренд и подтвердите
- Connector активируется сразу. В новом чате прикрепите его через скрепку (paperclip) и спрашивайте о бренде естественным языком
Cursor
Cursor подключает MCP-серверы через UI-форму «Connect to a custom MCP» — никакие JSON-файлы редактировать не нужно. Подходит как глобальное подключение, так и project-only.
- Откройте Cursor → Settings → MCP servers → «+ Add server»
- В диалоге заполните: Name = `geoscout`, Transport = `Streamable HTTP`, URL = `https://geoscout.pro/api/mcp`
- Сохраните — Cursor откроет браузер для OAuth-авторизации, выберите бренд на экране согласия GEO Scout
- Для PAT-подключения вместо OAuth: в блоке Headers нажмите «+ Add header», Key = `Authorization`, Value = `Bearer gs_<ваш-токен>`
- После сохранения сервер появится в списке MCP servers — иконка инструментов будет доступна в Composer и Chat
Чтобы подключить сервер только для одного проекта, создайте файл `.cursor/mcp.json` в корне репозитория с тем же конфигом — Cursor подхватит его автоматически и подключение не «утечёт» в другие проекты.
Claude Code CLI
Claude Code — однострочное подключение через `claude mcp add`. OAuth flow проходит автоматически в браузере, конфиг сохраняется в проекте.
- В терминале в корне проекта выполните: `claude mcp add --transport http geoscout https://geoscout.pro/api/mcp`
- Claude Code автоматически откроет браузер для OAuth-подтверждения. Флаг `--transport http` обязателен для streamable HTTP MCP
- На экране согласия GEO Scout выберите бренд и подтвердите доступ
- Подключение сохранится в `.claude/` папке проекта. Для PAT добавьте `--header "Authorization: Bearer gs_<токен>"`
Первый запрос — с чего начать
После подключения попробуйте лёгкий запрос — агент сам разберётся, какие из доступных инструментов использовать. Спрашивайте обычным языком, не нужно знать имена API-методов.
- «Дай brief по бренду за неделю» — агент вернёт coverage, Share of Voice, Citation Share, главные пробелы и quick-win действия
- «Покажи топ-10 источников, которые AI цитирует про мой бренд» — карта референтных доменов с категориями (медиа, маркетплейсы, форумы, конкуренты)
- «Какие промпты мы проигрываем конкурентам сильнее всего?» — список gap-промптов с разрывами и топ-конкурентами по каждому
- «Перечисли топ-3 негативных ответа за неделю» — ответы AI с отрицательной тональностью + контекст и провайдер
Не пытайтесь угадать имена инструментов — пишите задачу. Агент сам выберет нужные методы из 24 доступных и скомбинирует их. Если уточняющий вопрос непонятен агенту, переформулируйте: «На основе данных мониторинга за месяц…»
Пример: разбор пробела до уровня причин
Реальный workflow для e-commerce-бренда: от выявления пробела до понимания, почему именно AI цитирует конкурентов. Каждый шаг — обычный вопрос в чате, всё в одном диалоге.
- Шаг 1: «Где конкуренты обходят нас сильнее всего?» — агент находит топ-5 промптов с максимальным разрывом
- Шаг 2: «Возьми промпт #1 и расскажи, кого AI цитирует и почему» — детальный разбор источников и упомянутых конкурентов
- Шаг 3: агент возвращает: какие домены процитированы (например, retail.ru через кейс конкурента), какие конкуренты названы текстом, какой контент они используют
- Шаг 4: «Почему наш бренд там не появляется?» — агент сравнит ваши данные с конкурентом и укажет на отсутствующие сигналы (нет страницы категории, нет упоминания в топ-СМИ ниши, нет JSON-LD разметки)
- Шаг 5: всё это — за один диалог в чате. Не нужно открывать дашборд, переключать фильтры или собирать выводы вручную
Сила MCP именно в этом — задавать «почему» и «что если». Дашборд показывает «как сейчас», MCP позволяет копать в причины и искать неочевидные связи. Один разговор с агентом обычно заменяет 1–2 часа ручного анализа в дашборде.
Пример: подготовка ТЗ статьи
Когда пробел понят — попросите агента сразу подготовить бриф для статьи. У него есть всё нужное: gap-промпт, цитируемые источники конкурентов, ключевые сущности из ответов AI, ваши факты и сертификаты.
- Запрос: «На основе разобранного пробела подготовь ТЗ для статьи: заголовок, URL, целевые ключевые сущности, schema-разметка»
- Агент возьмёт: текст gap-промпта, список цитируемых конкурентами доменов, тематические сущности из 50+ ответов AI, ваш бренд-профиль
- На выходе: заголовок и URL для размещения, целевые ключевые сущности (что обязательно упомянуть), JSON-LD блоки (Article + FAQPage), референсные форматы из retail.ru / vc.ru / Habr
- Бриф можно сразу сохранить в Notion/Linear/Jira через интеграции вашего AI (в Claude — через Tool Use, в ChatGPT — через connectors, в Cursor — копи-паст)
- После публикации статьи — попросите агента отслеживать её эффект через 30 дней: «Через месяц посмотри, попадает ли URL в ответы AI и как изменилось Citation Share по теме»
Качество ТЗ зависит от того, как вы попросите. Хорошие шаблоны: «дай 5 ключевых сущностей», «предложи schema-блоки», «найди 3 факта про мой бренд из мониторинга, которые усилят цитируемость». Чем конкретнее запрос — тем плотнее результат.
Пример: месячный/еженедельный отчёт
Замените ручную сборку отчёта одной командой агенту. Он соберёт цифры, динамику, главные сдвиги и сформирует текст, который можно сразу отправить руководителю или в общий чат команды.
- Запрос: «Подготовь месячный отчёт по бренду — динамика метрик, топ-провайдеры, главные сдвиги, рекомендации на следующий месяц»
- Агент вызовет get_brand_metrics, get_brand_metrics_timeseries, list_competitors, get_competitive_gaps и сравнит периоды (месяц-к-месяцу или неделя-к-неделе)
- На выходе: структурированный текстовый отчёт с цифрами, разбором по провайдерам, объяснением сдвигов и предложениями приоритетов
- Дополните уточняющими: «найди 3 главных гипотезы, что вызвало падение SoV в Perplexity», «составь список 5 действий для следующего месяца на основе текущих пробелов»
Какие данные доступны агенту
Через MCP агент получает 24 read-only инструмента, перекрывающих все срезы дашборда. Не нужно их запоминать — агент сам выбирает нужный под каждый ваш вопрос.
- Метрики: coverage, Share of Voice, Citation Share, URL Mention Rate — за период, по провайдерам, по кластерам промптов, с дельтами период-к-периоду
- Источники: цитируемые домены с категориями (медиа, каталоги, маркетплейсы, форумы), отдельные URL, сравнение с конкурентами, неупомянутые страницы вашего сайта
- Конкуренты: список активных конкурентов, head-to-head сравнение по любым метрикам, конкурентные пробелы по кластерам, динамика упоминаний
- Промпты и ответы: топ-промпты с пробелами, детали по каждому промпту с ответами AI целиком, sentiment, scores, citations, mentioned competitors
- Действия и контент-планы: задачи Командного центра, контент-планы со структурой статей, опубликованные материалы и их эффект
Полный список доступных инструментов с описанием — на странице /mcp в дашборде. Если нужен инструмент или срез данных, которых сейчас нет — напишите в поддержку, MCP-набор активно расширяется.