Войти

Внешний MCP и OpenClaw

Подключение роботизированных агентов — OpenClaw и других — к MAG Master через External Agent Gateway и External MCP.

Внешний MCP — контур для роботизированных агентов, которые работают вне вашего браузера и IDE: OpenClaw на отдельном сервере, боты в мессенджерах, автоматизация приёма лидов с сайта. MAG Master остаётся единым ядром — задачи, CRM, база знаний и Social Content; агент обращается к нему по защищённому API.

Зачем внешний агент

Типичные сценарии:

  • Цифровая копия пользователя — отвечает в email, VK, Telegram от вашего имени с учётом правил и контекста проекта.
  • Приём лидов — входящее сообщение с сайта или мессенджера превращается в карточку лида в CRM.
  • Фоновая автоматизация — статусы задач, отчёты, мастер-посты, тренды — без постоянного участия человека в Cursor.
  • Отдельный сервер (например magtask.ru) — агент живёт на своём VPS; не нужно разворачивать второй экземпляр MAG Master.

Преимущества

ПреимуществоЧто это даёт
Один контур данныхЛиды, задачи и KB — в MAG Master, без дублирования в «второй CRM»
Политики и scopesАгент видит только разрешённые проекты и действия (лиды, задачи, контент)
Идентичность и trustСистема проверяет, кто пишет (сотрудник, клиент, неизвестный) — агент не доверяет «самоназванному» имени
IdempotencyПовторный запрос не создаёт дубликат лида или записи
Rate limitЗащита от злоупотреблений с внешней стороны
Журнал действийВсе вызовы агента логируются — вкладка External MCP в настройках
Без MCP на сервереОсновной путь — External Agent Gateway (REST), MCP-адаптер опционален

Как агент начинает взаимодействовать с MAG Master

Цепочка взаимодействия:

  1. Регистрация агента — в приложении: Мои настройки → External MCP → создать агента и Agent API key.
  2. Старт сессии — агент вызывает Gateway: POST /session/start с projectId, каналом и контактом.
  3. Контекст — GET /context — профиль, разрешённые проекты, каналы, участники, политика идентичности (identityPolicy).
  4. Память — GET /memory — история диалогов и лиды (в рамках scopes).
  5. Действия — POST /actions/execute — например create_lead, get_tasks, create_master_post (по политике action).
  6. События — POST /events/inbound / outbound-log — входящие и исходящие сообщения в журнал.

Gateway URL (хостинг): https://app.magaicrm.ru/api/external-agents
Заголовок авторизации агента: X-Agent-Key.

Альтернатива для MCP-клиентов: пакет magmaster-mcp-external (npx или mcp-external.cjs) — те же политики, тот же REST API.

Настройка в MAG Master

Пользователь

  • Мои настройки → External MCP — агент, ключ, политика действий, инструкция для OpenClaw.
  • Мои настройки → Цифровая копия — как представляться, тон, эскалация, список проектов.
  • Мои настройки → Контактные идентификаторы — email, телефон, мессенджеры для сопоставления личности.

Проект

  • Настройки проекта → Агент / каналы — email, VK, Telegram и др.; участники и доступ агента (scopes для сотрудников, клиентов, групповых чатов).

OpenClaw на отдельном сервере

Подключать только External MCP или Gateway — не Business MCP и не Developer MCP с внешнего VPS (иначе обходятся allowlist и idempotency).

OpenClaw

OpenClaw — пример внешнего агента (цифровая копия на отдельном сервере). Модель:

  • Пользователь — профиль копии и контактные идентификаторы.
  • Проект — каналы и права агента на участников.
  • Компания — база знаний компании как общий контекст.
  • OpenClaw — один инстанс на пользователя, переключение проектов по projectId.

Агент получает входящие из подключённых каналов, запрашивает контекст у MAG Master, создаёт лиды или обновляет задачи, отвечает по правилам эскалации.

Подробности релиза: новость OpenClaw.

Безопасность

  • MAG Master — source of truth для идентичности; агент не доверяет самообъявленным именам.
  • Уровни trust: verified, known, lead, unknown — от этого зависят scopes.
  • Неизвестный контакт — только публичный intake и эскалация; без доступа к внутренним данным проекта.
  • Запись в CRM требует idempotencyKey.

См. также