Docs

Gravity Admin MCP

Gravity Admin MCP подключает AI-ассистента к данным и настройкам вашего аккаунта Gravity Field через Model Context Protocol.

После подключения можно ставить задачи обычным языком: найти нужную кампанию, проанализировать A/B-тест, сравнить рекомендательные стратегии или подготовить аудиторию по заданным условиям. Ассистент сам получает необходимые данные из Gravity Field и собирает результат в рамках одного диалога.

Это сокращает ручную работу с интерфейсом и выгрузками: не нужно отдельно искать идентификаторы, переносить настройки или собирать показатели из нескольких экранов. Доступ ограничен секциями и правами пользователя, который вошёл через Gravity Field.

Что вы получите

Ассистент найдёт нужные данные в Gravity Field, соберёт их в одном ответе, объяснит результат и предложит следующие действия. Если задача требует изменить настройки, ассистент сначала покажет полный список изменений и применит их только после вашего подтверждения.

Например, вместо того чтобы искать эксперимент в личном кабинете, выгружать показатели и самостоятельно сравнивать варианты, можно отправить один запрос:

Найди последний A/B-тест рекомендаций, определи победителя, объясни различия между вариантами и предложи следующий шаг.

В результате вы получите показатели теста, понятное объяснение результата и рекомендации в рамках одного диалога.

Кому полезно

  • Маркетологам и CRM-менеджерам — чтобы находить кампании, готовить аудитории и проверять результаты запусков.
  • Аналитикам и продуктовым менеджерам — чтобы разбирать A/B-тесты, сравнивать показатели и находить точки роста.
  • Разработчикам — чтобы получать данные о настройках и быстрее разбираться в конфигурации Gravity Field.

Адрес сервера

Подключите MCP-сервер по адресу:

https://dashboard-ai.gravityfield.ai/api/mcp/gravity-admin/mcp

Для подключения достаточно адреса сервера. API-ключи и дополнительные настройки авторизации не нужны.

Подключение в Codex

Codex Desktop, CLI и расширение для IDE используют общий файл config.toml.

Добавьте сервер в глобальный файл ~/.codex/config.toml или в .codex/config.toml внутри доверенного проекта:

[mcp_servers.gravity-admin]
url = "https://dashboard-ai.gravityfield.ai/api/mcp/gravity-admin/mcp"

Затем выполните вход:

codex mcp login gravity-admin

Codex откроет страницу авторизации в браузере. Войдите с помощью email и пароля Gravity Field. После успешного входа перезапустите Codex, если сервер не появился в списке доступных инструментов.

Проверить подключение можно командами:

codex mcp list

В интерфейсе Codex также можно открыть список MCP-серверов командой /mcp. Подробнее о подключении серверов — в документации Codex.

Подключение в Cursor

Добавьте сервер в проектный файл .cursor/mcp.json или в глобальный файл ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gravity-admin": {
      "url": "https://dashboard-ai.gravityfield.ai/api/mcp/gravity-admin/mcp"
    }
  }
}

Перезапустите Cursor, откройте настройки MCP и выберите Connect, Login или Authenticate для сервера gravity-admin. В открывшемся браузере войдите с помощью email и пароля Gravity Field.

Как проходит авторизация

  1. Codex или Cursor открывает страницу входа Gravity Field.
  2. Вы входите с помощью обычных данных своей учётной записи.
  3. После входа AI-ассистент получает доступ только к тем секциям, которые доступны этому пользователю.

Пароль используется только для входа и не сохраняется сервисом подключения.

Авторизация действует только для Gravity Admin MCP. Когда сессия истечёт, клиент предложит повторно войти через браузер.

Что можно делать

Кампании и A/B-тесты

  • находить кампании и эксперименты по названию или ID;
  • фильтровать кампании по тегам, типу, статусу и методу интеграции;
  • получать настройки отчёта и полный A/B-отчёт;
  • сравнивать результаты по аудиториям и типам устройств.

Рекомендательные стратегии

  • находить стратегии и анализировать их эффективность;
  • просматривать конфигурацию, алгоритмы, фильтры, правила и места использования;
  • искать допустимые значения и товары в фиде;
  • создавать, клонировать, изменять и удалять стратегии после предварительной проверки.

Аудитории

  • находить аудитории и смотреть сводную или детальную аналитику;
  • получать полный каталог условий, операторов и допустимых значений;
  • создавать, клонировать и изменять аудитории;
  • удалять аудитории, которые не используются кампаниями, экспериментами или другими аудиториями.

Товарный фид

  • просматривать схему фида;
  • искать товары и значения полей для настройки стратегий и аудиторий.

Товарный фид доступен только для чтения: MCP не изменяет и не запускает его синхронизацию.

Как подтверждаются изменения

Создание, клонирование, изменение и удаление стратегии или аудитории выполняется в два этапа:

  1. Ассистент показывает список изменений, предупреждения, места использования и возможные последствия.
  2. После вашего явного подтверждения ассистент применяет подготовленное изменение.

Если данные изменились после проверки, ассистент попросит заново проверить действие. Удалить аудиторию или стратегию, которая используется в другом сценарии, нельзя.

Примеры запросов

Найди кампанию «Рекомендации в корзине» в секции «Интернет-магазин». Покажи её A/B-тесты и доступные метрики, но пока не загружай отчёт.

Проанализируй A/B-тест за сохранённый период. Сравни основные метрики и отдельно проверь desktop и mobile. Ничего не изменяй.

Найди стратегии, которые используются в этой кампании, сравни их эффективность и объясни основные различия.

Подготовь аудиторию пользователей, которые покупали за последние 365 дней, но не покупали последние 90 дней. Сначала покажи условия, связи и полный список изменений. Создавай только после моего подтверждения.

Если подключение не работает

  • Если сервер запрашивает авторизацию, запустите вход в клиенте или выполните codex mcp login gravity-admin.
  • Проверьте, что в настройках сервера указан точный URL без дополнительных параметров.
  • В Codex выполните codex mcp list или откройте /mcp, чтобы проверить состояние сервера.
  • Если авторизация истекла, войдите повторно.
  • Если браузер показывает ошибку входа, убедитесь, что используете действующую учётную запись Gravity Field, и обратитесь в поддержку.

Чем отличается от Gravity Docs MCP

  Gravity Admin MCP Gravity Docs MCP
Источник данных Аккаунт Gravity Field Публичная документация
Авторизация Вход через Gravity Field Не требуется
Возможности Кампании, отчёты, стратегии, аудитории и товарный фид Поиск и чтение инструкций
Изменение данных Стратегии и аудитории после предварительной проверки и подтверждения Нет

Для большинства рабочих сценариев полезно подключить оба сервера: Gravity Admin MCP получает данные аккаунта, а Gravity Docs MCP находит инструкции и объясняет возможности платформы.

© Copyright 2026. All rights reserved.