X·MPДокументация

Руководство по работе с магазином

Личный кабинет: управляйте подключением магазина

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

Зачем это нужно

Кабинет помогает держать под контролем, кто работает с магазином и к чему имеет доступ. Подключение данных, права агента и разрешение на конкретное изменение решают разные задачи.

Пример из работы магазина

«Хочу подключить агента для анализа продаж и дать менеджеру доступ к результатам работы этого магазина».

Как начать

  1. Войдите в X-MP и выберите нужный магазин.
  2. В защищённом разделе подключений добавьте необходимые ключи, затем проверьте состояние данных.
  3. Подключите агента по доступной инструкции и настройте права участников команды.
  4. Открывайте задачи и результаты из рабочих разделов магазина.

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

Один выбранный магазин, понятные участники и подключения, доступ к сохранённой работе.

Что важно учитывать

Сохранённый ключ Wildberries не означает, что сбор завершён или исполнение изменений включено. Необходимые разрешения проверяются отдельно.

Что устанавливает клиент 0.34.0

Комплект содержит один MCP X-MP с 112 методами и 26 skills: отдельные инструкции по аналитике, финансам, мониторингу, отзывам, запасам, ежедневным приоритетам и проверке результата; настройки репрайсера, биддера, контента, уведомлений и отчётов. Skills объясняют методику работы; MCP предоставляет типизированные операции. Право пользоваться методом проверяется сервером отдельно.

Для новой установки нужны Python 3.11+, curl, Bash и установленный авторизованный Codex. Рабочий путь — терминал Linux; macOS/WSL требуют отдельной проверки окружения. Уже установленные совместимые клиенты Python 3.10+ получают managed pack через обновлятор.

Доступы и проверка подключения

РежимНазначение
Только чтениеДанные, аналитика, чтение задач и состояния сервисов.
Настройка и планыДополнительно задачи памяти, конфигурации сервисов, черновики, отчёты и расписания в рамках роли участника.
Изменение WildberriesОтдельная поддержанная операция с точным планом, подтверждением и проверкой исполнения.

Установщик проверяет конфигурацию до замены ключа и выполняет диагностику. xmp.client.doctor разделяет доступность соединения, права и состояние каждого сервиса. Он не включает сервисы и не меняет полномочия. Результат сохраняется в .xmp/diagnostics.json; повторная проверка — ./.xmp/doctor.

Файлы и обновления

AGENTS.md содержит управляемые инструкции, .codex/config.toml — локальный MCP, .agents/skills — ссылки на проверенные инструкции, .xmp/current — текущий пакет, .xmp/previous — предыдущая версия. Ключ находится только в .xmp/secrets/agent.key. Бизнес-контекст хранится в Seller Memory и читается явно, а не копируется в skills.

Запуск — ./.xmp/start. Новые подключения включают совместимые автоматические обновления; --no-auto-update отключает их. Во время активной сессии пакет проверяется примерно раз в пять минут. При новом протоколе агент читает нужные предметные skills перед повтором вызова. Пользовательские правила и .gitignore сохраняются; ошибочный TOML блокирует установку до изменения ключа.

Готовые методики работы

Дополнительно к сервисным инструкциям пакет включает аудит рекламы, планирование пополнения, распределение партии по складам, контроль ФБС, разбор оферты и проверку удержаний. Каждый сценарий готовит отдельный результат и использует общие данные, Memory и проверку эффекта.

Методы и параметры

Параметры ниже относятся к MCP arguments. Идентичность и ключ не передаются в них. Для полного объекта config следуйте руководству домена.

xmp.client.doctor

Check client integrity, account identity, granted access and configured service states. Read-only; never enables grants, schedules or marketplace operations. Returns bounded diagnostics, not business data.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

agent.me

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

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

capabilities.list

Получить эффективные возможности; наличие метода в клиенте не заменяет проверку прав.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

readiness.get

Проверить состояние магазина и свежесть данных.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

xmp.services.list

Получить сервисы и их режимы для текущего подключения.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

xmp.update.check

Проверить доступность совместимого клиентского выпуска.

Параметров нет: передайте {}.

Точная JSON Schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

xmp.update.apply

Применить проверенное обновление после confirm=true; права не расширяются.

ПараметрТипОбязателенНазначение и ограничения
confirmзначениедаЯвное подтверждение обновления клиента; не разрешение на WB write. только: true
auto_updateда/нетнетВыбранная политика обновления устройства.
Точная JSON Schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "confirm"
  ],
  "properties": {
    "confirm": {
      "const": true
    },
    "auto_update": {
      "type": "boolean"
    }
  }
}
Техническая справка для агента и разработчика

Этот раздел предназначен для настройки интеграции. Для обычной работы начните с шагов выше.