К содержанию
Начать бесплатно

API и MCP

Магазин, которым управляет код

REST API и MCP — те же возможности, что в кабинете: товары, принты, бланки, заказы, промокоды, оформление витрины и тариф.

Получить ключ AGENTS.md

REST и MCP. Ключ — в кабинете.

Тёмный редактор кода рядом с витриной мерча
Код REST-запроса рядом с карточкой товара

REST API

/api/v1 — то же, что в кабинете

REST API /api/v1 закрывает те же действия, что кабинет: товары, принты, бланки каталога, заказы, промокоды, оформление витрины, тариф, OBS-виджет и самозаказ.

Схема подключения ИИ-агента к серверу и витрине магазина

MCP для ИИ-агентов

/mcp — те же действия агенту

MCP-сервер по адресу /mcp (Streamable HTTP) даёт агенту те же возможности, что и REST API. Подключается к ИИ-агентам с поддержкой MCP — Claude, ChatGPT и другим.

Список ключей API в кабинете с кнопкой отзыва

Ключи под контролем

Ключ показывается один раз

Ключ выпускает автор в кабинете (Настройки → Ключи API) и может отозвать его в любой момент. На каждый вызов — лимиты частоты и журнал вызовов. Публикует товары и витрину только человек — агент сам не публикует.

Выпустите ключ и подключитесь

Выпускается в кабинете за минуту. Дальше — REST или MCP, на ваш выбор.

Получить ключ

От ключа до автоматизации — три шага

  1. Разработчик выпускает ключ API за ноутбуком 01

    Выпустите ключ

    В кабинете: Настройки → Ключи API. Ключ показывается один раз — сохраните его сразу.

  2. Разработчик подключает REST или MCP на двух экранах 02

    Подключите REST или MCP

    REST API /api/v1 и MCP-сервер /mcp дают агенту одни и те же возможности.

  3. Телефон с приборной панелью автоматизации магазина 03

    Автоматизируйте

    Товары, заказы, промокоды и тариф — через код или через агента. Публикует всегда человек.

Частые вопросы

Где документация для агента?
Публичные AGENTS.md, llms.txt и llms-full.txt на mercher.pro описывают сервис для агентов.
Может ли агент опубликовать товар или витрину сам?
Нет. Публикация — только человеком, робот не публикует.
Как отозвать ключ API?
В кабинете, Настройки → Ключи API — ключ можно отозвать в любой момент.
Какие агенты поддерживаются?
ИИ-агенты с поддержкой MCP — например Claude, ChatGPT и другие.
Чем MCP отличается от REST?
MCP-сервер на /mcp даёт агенту те же возможности, что REST API /api/v1 — выбирайте протокол под способ подключения.
Что если вызовов слишком много?
На каждый вызов действуют лимиты частоты, и все вызовы попадают в журнал.
Ключ показывается ещё раз после выпуска?
Нет, ключ показывается только один раз при выпуске — сохраните его сразу.