Создание и настройка приложения через User MCP
Что для чего используется
| Источник | Что берёт из него AI |
|---|---|
| Документация Senler | Типы приложений, правила OAuth, launch_code, Bridge, webhook-контракты, шаги и ограничения публикации. |
| Senler.io User MCP | Текущее состояние приложений пользователя и операции создания или изменения. |
| Установленные Senler UI и SDK | Точные TypeScript-типы, exports и сигнатуры методов во время разработки кода. |
| Официальная документация внешнего сервиса | Актуальный контракт amoCRM, платёжной системы или другого подключаемого API. |
Project MCP работает с одним проектом. Для создания и настройки приложений, принадлежащих разработчику, используется прямое личное подключение User MCP.
Сначала AI ищет существующее приложение пользователя и только при отсутствии создаёт новое. Поэтому разговорные запросы «создай приложение через юзер мсп», «настрой моё приложение» и «проверь, есть ли уже такое приложение» относятся к одному процессу ниже.
Порядок работы
- Через
search_documentationиget_documentation_pageAI читает страницы по нужному типу приложения и функциям, которые предстоит настроить. - Через
searchAI находит операцию «получить мои приложения» и проверяет, не создано ли приложение раньше. - Если приложения нет, AI ищет операцию «создать приложение через пользовательский OAuth». Нужна OAuth-операция provision с правом
can_create_apps; одноимённая операция кабинета с session-auth для User MCP недоступна. - Для каждой части приложения AI отдельно находит подходящую операцию: основные настройки, OAuth, встроенная страница, инструменты, действия приложения, вебхуки или шаги автоматизаций. Поля берутся из
describe_method, соседние настройки не перезаписываются. - После изменения AI снова получает приложение или список шагов и проверяет сохранённое состояние.
Методы developer-приложения принимают appId; project_id для них не нужен. В прямом User MCP project_id используется только при работе с данными конкретного проекта или с действиями приложения, уже установленного в этом проекте.
Черновики и публикация
Новый шаг автоматизации сначала создаётся как черновик. Его можно публиковать после реализации и проверки endpoint. Публикация шага и отправка приложения на модерацию меняют доступность приложения, поэтому AI выполняет их только по прямому запросу пользователя.
Что остаётся ручным
User MCP не возвращает секреты, доступные только через session-auth, например единый webhook secret приложения. Разработчик копирует такой секрет в кабинете и сохраняет на backend. AI должен объяснить этот шаг, но не пытаться получить секрет другим методом.
Для внешней интеграции возможностей одного User MCP недостаточно: контракт Senler берётся из этой документации, а контракт внешнего API проверяется по его актуальной официальной документации.