К содержанию

Все статьи

Доступ MCP-агента

В Emperor есть MCP-сервер (Model Context Protocol). Через него ИИ-агент, например Cursor или другой MCP-клиент, читает и меняет данные рабочего пространства. Права администратора не нужны: каждый пользователь настраивает доступ в своём Profile.

Создание токена

  1. Меню → Profile → MCP Agent Access.
  2. В блоке Create token введите Name (например Cursor laptop).
  3. Выберите Scopes (см. ниже). По умолчанию — только чтение.
  4. Нажмите Create token.
  5. Скопируйте токен вида emp_<id>.<secret>. Он показывается один раз. Храните его как пароль.

Токен:

  • действует от вашего имени и не даёт больше прав, чем у вашей учётной записи в рабочем пространстве;
  • работает только в рабочем пространстве, активном при создании;
  • истекает через 90 дней (колонка Expires);
  • перестаёт работать после Revoke или потери доступа к рабочему пространству.

Edit scopes меняет scopes существующего токена. Секрет не меняется, клиент продолжает работать.

Scopes

Scopes на чтение включены по умолчанию. Включайте scope на запись, только если агент должен создавать или менять записи.

  • signals:read — маркетинговые сигналы
  • calendar:read / calendar:write — контент-календарь
  • content-marketing:read / content-marketing:write — кампании, планы, задачи, воронки продаж
  • content-optimization:read / content-optimization:write — SEO ключевые слова, Search Console, сканы сайтов, отчёты оптимизации
  • development:read / development:write — проекты, репозитории, бизнес-модели
  • youtrack:read / youtrack:write — YouTrack Gantt
  • crm:read / crm:write — лиды, сделки, контакты, организации
  • crm:delete — безвозвратное удаление CRM (отдельно от crm:write)
  • finance:read / finance:write — бюджеты и транзакции
  • facilities:read / facilities:write — facilities и отчёты безопасности
  • settings:read — чтение настроек (только чтение; scope на запись нет)

Секреты, OAuth-учётные данные, управление токенами и удаление проекта через MCP недоступны никогда.

Подключение клиента

Адрес MCP — сервер Emperor MCP, путь /mcp (порт 4477 на хосте Emperor, если администратор не опубликовал другой адрес). MCP Agent Access показывает адрес для вашей установки.

Передавайте токен в заголовке Bearer. Пример для Cursor (.cursor/mcp.json или глобальные настройки MCP) и других клиентов с форматом mcpServers:

{
  "mcpServers": {
    "emperor": {
      "url": "https://<emperor-host>:4477/mcp",
      "headers": {
        "Authorization": "Bearer emp_<id>.<secret>"
      }
    }
  }
}

Подставьте свой <emperor-host> и токен. Ответ 401 — токен неверный, отозван или истёк. 403 от инструмента — у токена нет нужного scope или ваша роль не разрешает действие.

Удаление записей CRM

Эти инструменты принимают UUID записи в поле id:

  • delete_crm_lead удаляет лида, его контакты, взаимодействия, сделки и позиции сделок. Связанные проекты сохраняются.
  • delete_crm_contact удаляет только контакт, но не его владельца.
  • delete_crm_opportunity удаляет сделку и её позиции, сохраняя лида и связанный проект.
  • delete_crm_person удаляет персону и контакты; связанные идентификаторы пользователей приложений сохраняются без привязки к персоне.
  • delete_crm_organization и delete_crm_counterparty также удаляют контакты (у контрагента — ещё и роли). Нельзя удалить организацию со связанными проектами, контрагентами или оплатой воркспейса. Нельзя удалить контрагента, связанного с лидами или партнёрами бизнес-модели.

Удаление необратимо. Нужен scope crm:delete и право вашей учётной записи удалять данные в этом воркспейсе. Одного crm:write недостаточно: он разрешает только создание и изменение. Новые токены по умолчанию доступны только для чтения; при необходимости включите crm:delete через Edit scopes. При установке этой возможности crm:delete автоматически получают только существующие токены с crm:write. Токены только для чтения и с правом записи лишь в других разделах не меняются. Секрет, срок действия и статус отзыва сохраняются. Затем право можно убрать — повторно оно автоматически не добавляется.

Ответ: success: true, data.id и счётчики data.deleted: contacts, interactions, opportunities, lineItems, roles. Отсутствующая запись (в том числе из другого воркспейса) даёт 404 / not found, блокирующие связи — 409. При ошибке частичное удаление не сохраняется; успешное удаление попадает в аудит.

Статьи