РазработчикамOAuth · MCP

Подключите Cormak к своим рабочим процессам

Генерируйте контент для товаров через Store API. Подключайте свои ИИ-инструменты к задачам, проектам, агентам и творческим процессам через MCP.

Скачать OpenAPI 3.1

Начните с бесплатного запроса обнаружения. Выберите разрешения и лимиты кредитов для интеграции.

Первый успешный запрос

Получите сведения о защищённом ресурсе 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-токеном. Укажите действие в теле запроса.

Доступные действия Store API
ДействиеРезультатКредиты
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 по умолчанию заблокированы и требуют явного локального включения.

Храните данные доступа в приватном локальном окружении. Проверьте сохранённые ответы перед отправкой коллекции другим людям.