# Gravity Admin MCP

Gravity Admin MCP подключает AI-ассистента к данным и настройкам вашего аккаунта Gravity Field через [Model Context Protocol](https://modelcontextprotocol.io/).

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

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

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

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

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

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

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

## Кому полезно

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

!!!warning Важно
Некоторые инструменты Gravity Admin MCP могут изменять стратегии и аудитории. Перед применением проверяйте список изменений и подтверждайте действие только после проверки.
!!!

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

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

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

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

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

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

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

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

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

```shell
codex mcp login gravity-admin
```

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

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

```shell
codex mcp list
```

В интерфейсе Codex также можно открыть список MCP-серверов командой `/mcp`. Подробнее о подключении серверов — в [документации Codex](https://developers.openai.com/codex/mcp).

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

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

```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. После вашего явного подтверждения ассистент применяет подготовленное изменение.

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

!!!primary Рекомендуемый запрос
Всегда показывай полный список изменений и возможные последствия. Не изменяй данные, пока я явно не подтвержу действие.
!!!

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

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

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

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

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

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

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

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

| | Gravity Admin MCP | [Gravity Docs MCP](./gravity_docs_mcp.md) |
| :--- | :--- | :--- |
| Источник данных | Аккаунт Gravity Field | Публичная документация |
| Авторизация | Вход через Gravity Field | Не требуется |
| Возможности | Кампании, отчёты, стратегии, аудитории и товарный фид | Поиск и чтение инструкций |
| Изменение данных | Стратегии и аудитории после предварительной проверки и подтверждения | Нет |

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