Первый успешный запрос
Получите сведения о защищённом ресурсе OAuth без аккаунта и токена. Запрос возвращает HTTP 200 и не расходует кредиты.
curl --fail https://mcp.cormak.app/.well-known/oauth-protected-resource/mcpВ ответе указан ресурс https://mcp.cormak.app/mcp и список поддерживаемых разрешений.
Аутентификация и доступ
Зарегистрируйте публичный OAuth-клиент с PKCE и SHA-256. Владелец аккаунта проверит разрешения в Cormak. Используйте полученный bearer-токен доступа. Токены доступа действуют до часа. Токены обновления ротируются, поэтому обновляйте их последовательно.
Запросите store:use для Store API или account:read projects:read для примеров чтения через MCP. Владелец может отозвать доступ и изменить лимиты в разделе «Подключения».
Персональные ключи API пока недоступны. Переменная Postman apiKey хранит локальный OAuth-токен доступа. Оставьте её общее значение пустым.
Используйте серверную интеграцию или настольный агент Postman. Store API не поддерживает предварительный запрос браузера (preflight).
Справочник Store API v1
Отправляйте JSON в POST https://mcp.cormak.app/store с bearer-токеном. Укажите действие в теле запроса.
| Действие | Результат | Кредиты |
|---|---|---|
account | Баланс, цены и лимиты подключения | Бесплатно |
fill_text | Описания товаров и выбранные поля карточек | 1 ИИ-кредит |
image_start | Запуск генерации одного фото товара | Текущая цена выбранной модели и качества |
image_status | Статус и временные ссылки на скачивание для восьми запросов | Без новой генерации |
Скачайте полный справочник API, чтобы посмотреть схемы, примеры и ошибки. Store v1 использует существующую точку входа с выбором действия.
Откройте руководство по созданию описаний и фото товаров, чтобы пройти весь процесс от проверки цены до генерации и получения статуса.
Интеграция MCP
Подключите удалённый HTTP-клиент MCP к https://mcp.cormak.app/mcp. Пройдите OAuth-аутентификацию, инициализируйте соединение и вызовите tools/list, чтобы увидеть инструменты, доступные вашему токену и подключению.
Через MCP доступны задачи, сохранённые проекты, агенты, управление ботами Telegram, черновики ИИ-сотрудников, фото, видео, 3D, озвучка, SEO и управление доменами. Генерация сайтов и бизнес-планов, общий доступ к CRM и покупки у регистратора выходят за рамки публичного интерфейса.
Начните с get_account или list_projects. В руководстве по MCP (на английском) описаны настройка и проверка статуса, а в справочнике инструментов (на английском) — параметры и ограничения. Актуальный список инструментов возвращает сам MCP.
Частота запросов и лимиты кредитов
MCP и Store допускают по 120 запросов в минуту на подключение. Владелец отдельно задаёт лимит генераций за скользящие 24 часа. Также учитываются тариф, баланс, согласие на использование ИИ и проверки на злоупотребления.
Купите ИИ-кредиты в аккаунте Cormak. Интеграция использует общий баланс приложения. Для видео предусмотрены отдельные пакеты. Текущие цены доступны в разделе оплаты.
Генерация через Store может сразу списать кредиты. Сначала узнайте текущую цену и передайте ожидаемую стоимость изображения. Операции MCP требуют подтверждения владельца. Для работы с товарами владелец также может делегировать бюджет кредитов.
При повторе используйте тот же UUID и те же параметры. Проверяйте статус уже запущенной операции и выясните её результат перед новой генерацией. Ссылки на скачивание изображений действуют один час.
Коллекции Postman
Импортируйте коллекцию и пустой шаблон окружения, затем запустите Discovery. Платная генерация и настройка OAuth по умолчанию заблокированы и требуют явного локального включения.
- Коллекция Store API
- Примеры чтения через MCP
- Шаблон окружения
- Аутентификация, быстрый старт и ошибки (на английском)
Храните данные доступа в приватном локальном окружении. Проверьте сохранённые ответы перед отправкой коллекции другим людям.