# MCP — AI-агенты снаружи кабинета
В меню: Настройки → Интеграции → MCP.
MCP (Model Context Protocol) позволяет внешним AI-клиентам (Claude Desktop / Web / Code, Cursor, Codex, Windsurf и совместимым) работать с проектом Sales Ninja через инструменты протокола. Доступен всем проектам, где вы создали интеграцию.
Токен наследует права пользователя, от имени которого выпущен. Пишите осторожно: агент с write-доступом может менять сущности проекта.
# Как подключить
- Настройки → Интеграции → Добавить → MCP, задайте название.
- Сохраните и сразу скопируйте доступы из блока формы:
- OAuth Client ID / Secret — для клиентов с OAuth (в т.ч. Claude Web);
- Bearer-токен — для ручной HTTP-настройки и клиентов без OAuth.
- Secret и полный набор доступов при редактировании могут больше не показываться — используйте перегенерацию в том же окне (старые доступы перестанут работать).
- В форме интеграции откройте «Как подключить» — там готовые шаги и фрагменты конфигов для Claude Desktop, Claude Web, Claude Code, Cursor, Codex, Windsurf, endpoint и транспорт (HTTP + SSE).
- При желании скопируйте промпт для AI-агента из той же формы — он помогает клиенту корректно вызывать инструменты.
Точные JSON/TOML-вставки всегда берите из UI — они актуальнее любой копии в docs.
# Что становится доступно
- Управление сущностями проекта в духе Public REST manage API (списки, сохранение, удаление — в пределах инструментов MCP).
- Аналитические запросы и конструкторы, которые отдаёт MCP-поверхность.
- Инструменты по подключённым интеграциям проекта (Директ, Метрика и др. — как видно агенту в списке tools).
Не выставляются операции, которые нельзя безопасно отдавать внешнему владельцу «вручную» (массовые внутренние джобы обучения и т.п.).
# Ограничения и безопасность
- Один набор доступов привязан к проекту; ротация = перегенерация.
- Следите за ролью пользователя, от которого выпущен токен (роли).
- На проводе — стабильные машинные контракты; UI-тексты локализуются в кабинете, не в ответах tools для агента.
- Для работы внутри кабинета без внешнего MCP смотрите Kohai.