Доступ MCP-агента
В Emperor есть MCP-сервер (Model Context Protocol). Через него ИИ-агент, например Cursor или другой MCP-клиент, читает и меняет данные рабочего пространства. Права администратора не нужны: каждый пользователь настраивает доступ в своём Profile.
Создание токена
- Меню → Profile → MCP Agent Access.
- В блоке Create token введите Name (например
Cursor laptop). - Выберите Scopes (см. ниже). По умолчанию — только чтение.
- Нажмите Create token.
- Скопируйте токен вида
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 Ganttcrm: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. При ошибке частичное удаление не сохраняется; успешное удаление попадает в аудит.