Sales Ninja — документация

# MCP — подключение AI-агентов

# Уровни интеграции

Уровень Доступно Где настраивается
Project ✅ Настройки → Интеграции → MCP
ML-сигнал — —
JS-действие — —

# Что это

MCP (Model Context Protocol) — открытый протокол, по которому AI-агенты (Claude Desktop, ChatGPT, Cursor и любые другие совместимые клиенты) могут управлять Sales Ninja через программные инструменты. Через MCP агент получает доступ к тем же операциям, что и Public REST API управления: просматривать списки персонализаций / A/B-тестов / опросов, создавать, редактировать, удалять, запускать аналитические отчёты. Кроме того, MCP даёт ряд интеграционных инструментов (Яндекс.Директ, VK Ads, CallTouch и т.п.).

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

  • AI-клиент, поддерживающий MCP (Claude Desktop, ChatGPT с MCP-плагином, Cursor, и т.п.).
  • Подключённая интеграция MCP в Sales Ninja.

# Как подключить

  1. Sales Ninja → «Настройки → Интеграции → Добавить → MCP».
  2. Sales Ninja сгенерирует OAuth-клиент: clientId (вида snmcp_…) и clientSecret. Сохраните secret сразу — он показывается один раз. Дополнительно генерируется access token, который можно использовать как прямую авторизацию без OAuth-flow.
  3. В вашем MCP-клиенте укажите URL https://api.sales-ninja.me/mcp и пройдите OAuth-авторизацию по этим credentials (или укажите access token напрямую, если клиент это поддерживает).
  4. После подключения клиент увидит доступные инструменты Sales Ninja.

# Что становится доступно

  • Управление сущностями — те же 5 операций (list/get/save/delete/patch) на каждую сущность, что в Public REST API. Подробности структуры контрактов — те же; см. Управление сущностями (REST).
  • Аналитика — get_aggregated_statistics и get_analytics_constructor, описанные в Статистике.
  • Условия показа — get_condition_constructor для построения V2-условий внутри сущностей.
  • Интеграционные инструменты — для подключённых проектных интеграций (Яндекс.Метрика/Директ/AppMetrica, VK Ads, CallTouch, Smartis): чтение кампаний, сегментов, целей, статистики, отправка офлайн-конверсий.

# Ограничения

  • Token-based авторизация. Если вы хотите ротировать токен — нажмите «Перевыпустить токен» в Sales Ninja (старый сразу перестаёт работать).
  • На MCP действует та же политика «один токен — один проект» и «English-only на проводе», что и на Public REST API.
  • Sales Ninja не выставляет на MCP операции, которые не должны делаться вручную внешним владельцем проекта: запуск/остановку ML-обучения, диагностические превью-токены, инфраструктурные триггеры — этого там нет.

# Связанные страницы

← Сигналы для ML →