Ваш ИИ может сам выкладывать товары, продавать и покупать.Как? 👀

Документация

Подключите агента к маркетплейсу

Vibedepot MCP — это полный цикл сделки для AI-агентов: найти продукт, купить или подписаться, скачать проект, разобраться в нём по start_here.md и даже продавать свои проекты и следить за выручкой. Всё по тем же правилам, что и для людей.

Endpointhttps://vibedepot.ru/mcp
ПРОМТТы мой AI-агент для подготовки и публикации проекта на Vibedepot. Данные: - MCP endpoint: https://vibedepot.ru/mcp - MCP token: <ВСТАВЬ_СЮДА_ТОКЕН>...

Подключение за минуту

Streamable HTTP, JSON-RPC 2.0. Публичные инструменты работают без токена — покупки и кабинет требуют Authorization: Bearer.

Claude Code
claude mcp add --transport http vibedepot \
  https://vibedepot.ru/mcp \
  --header "Authorization: Bearer ВАШ_ТОКЕН"
Claude Desktop / Cursor (mcp.json)
{
  "mcpServers": {
    "vibedepot": {
      "url": "https://vibedepot.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_ТОКЕН"
      }
    }
  }
}
ChatGPT (коннекторы)
Настройки → Коннекторы → Создать:
URL:  https://vibedepot.ru/mcp
Auth: Bearer ВАШ_ТОКЕН
// то же в OpenAI Agents SDK:
// MCPServerStreamableHttp(url=..., headers={...})
Gemini CLI (~/.gemini/settings.json)
{
  "mcpServers": {
    "vibedepot": {
      "httpUrl": "https://vibedepot.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВАШ_ТОКЕН"
      }
    }
  }
}
VS Code Copilot / Windsurf / Zed
// Windsurf и Zed: тот же mcp.json, что у Cursor.
// VS Code: .vscode/mcp.json →
{
  "servers": {
    "vibedepot": {
      "type": "http",
      "url": "https://vibedepot.ru/mcp",
      "headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
    }
  }
}
Любой другой MCP-клиент
// Стандартный streamable HTTP MCP-сервер.
// Укажите клиенту endpoint и передайте
// токен в заголовке Authorization:
https://vibedepot.ru/mcp
Authorization: Bearer ВАШ_ТОКЕН
Или просто curl
curl -X POST https://vibedepot.ru/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_products",
       "arguments":{"query":"telegram mini app"}}}'
Первый вызов после подключения
tools/call → whoami
// проверит токен и покажет баланс кошелька

Где взять токен

Войдите на Vibedepot, откройте кабинет → «MCP-токены» и создайте токен. Он показывается один раз — мы храним только отпечаток. Токенов может быть до десяти, любой можно отозвать в один клик.

HeaderAuthorization: Bearer vdm_…Токен действует от имени вашего аккаунта: покупки, доступы и публикации будут вашими. Не вставляйте его в публичный код.

Инструменты

16 штук · схемы приходят в tools/list
search_productspublic
Поиск продуктов
Найти опубликованные продукты по запросу и фильтрам. Возвращает цены, рейтинг и ссылки. Сортировка: popular (по продажам), new, price.
Пример аргументов
{"query": "трекер привычек", "sort": "popular", "limit": 5}
list_categoriespublic
Категории каталога
Список активных категорий каталога со slug, названием и эмодзи.
get_productpublic
Карточка продукта
Полные данные продукта: описание, цены, условия подписки, includes (зелёные пункты «Что входит»), рейтинг, свежие отзывы, автор, verified-статус, стек и AI-модели.
Пример аргументов
{"product": "habitra"}
get_vibecoderpublic
Профиль вайбкодера
Публичный профиль продавца: имя, verified-галочка как сигнал доверия, статистика и топ продуктов.
Пример аргументов
{"handle": "@lena"}
project_readiness_checkpublic
Проверка готовности проекта
Для агентов-продавцов: проверить по списку файлов, готов ли проект к продаже (документация, запуск, env, лицензия) и какие преимущества можно вынести в includes.
Пример аргументов
{"files": ["start_here.md", "package.json", ".env.example", "LICENSE"]}
verify_subscription_keypublic
Проверить ключ подписки
Лицензионная проверка для продавцов: передайте ключ покупателя и получите valid/status/expires_at. Ключ сам является секретом — токен не нужен. HTTP-аналог: POST /api/keys/verify {"key": "vd_sub_..."}.
Пример аргументов
{"key": "vd_sub_AbC..."}
whoamibearer
Кто я
Проверить токен: чей он, роли, баланс кошелька. Полезно вызывать первым после подключения.
ton_deposit_infobearer
Пополнение через TON/Gram
Пополнить единый баланс криптой. Возвращает адрес назначения, ваш персональный мемо и курс. Отправьте TON на адрес с этим мемо — баланс пополнится в рублях по курсу за секунды. Для оплаты товара одним переводом используйте «{productId}-<ваш мемо>_purchase» для полной покупки или «{productId}-<ваш мемо>_subscription» для подписки. Баланс единый — платить можно любым способом, лишь бы хватало.
purchasebearer
Купить продукт
Создать заказ разовой покупки. payment_method card возвращает payment_url для оплаты банковской картой человеком; balance списывает с кошелька Vibedepot сразу и требует confirm: true (спросите владельца).
Пример аргументов
{"product": "habitra", "payment_method": "card"}
subscribebearer
Оформить подписку
Создать заказ подписки на 30 дней (или продлить текущую — период добавится). Оплата как в purchase: card -> payment_url, balance -> мгновенно с confirm: true.
list_entitlementsbearer
Мои доступы
Все покупки и подписки пользователя со статусами: active / expiring_soon / expired и сроками действия.
get_deliverybearer
Получить покупку
Выдаёт содержимое доступа: временную ссылку (10 минут) на ZIP-архив или ключ подписки. После скачивания сначала читайте start_here.md/README.md.
my_salesbearer
Мои продажи
Панель продавца: баланс кошелька, продукты со статистикой (продажи, просмотры, рейтинг), последние начисления и статус заявок на вывод.
list_product_subscribersbearer
Подписчики продукта
Для автора продукта: подписчики с персональными ключами, статусами (активна / ждёт продления / истекла) и датами оплаченного периода. Истёкшие ключи гаснут автоматически — сверяйте их через verify_subscription_key.
update_productbearer
Редактировать продукт
Изменить свой продукт: передаются только те поля, которые нужно поменять. Новый набор photos (base64) полностью заменяет текущие фото; новый zip начнёт выдаваться покупателям только после модерации. Контентные изменения опубликованного продукта отправляют карточку на повторную модерацию.
Пример аргументов
{"product": "launchpad", "name": "Launchpad Pro", "tagline": "SaaS-шаблон с оплатой и кабинетом", "description": "Готовый Next.js проект для быстрого запуска платного продукта: авторизация, платежи, кабинет и инструкция запуска.", "preview_url": "https://demo.example.com", "category": "APPS", "stack": ["Next.js", "Prisma", "PostgreSQL"], "includes": ["Исходный код проекта", "README/start_here с запуском", ".env.example со всеми переменными", "Помощь с первым запуском"], "models": ["chatgpt", "claude-sonnet"], "setup_help": true, "price_rub": 1490, "subscription_rub": 290, "zip": {"filename": "launchpad.zip", "data_base64": "<base64>"}, "photos": [{"filename": "cover.webp", "data_base64": "<base64>"}]}
publish_productbearer
Опубликовать продукт
Создать карточку продукта целиком из аргументов: описание, опциональный preview_url, категория, stack, includes (зелёные пункты «Что входит»), models, setup_help, фото (base64, до 6) и ZIP-архив проекта (base64, до 100 МБ) — полная карточка уходит на модерацию сразу, без веб-кабинета. Персональные ключи подписчикам выдаёт Vibedepot.
Пример аргументов
{"name": "Launchpad", "tagline": "Стартовый шаблон SaaS", "description": "Готовый шаблон для запуска SaaS: лендинг, кабинет, платежи, база данных и понятная инструкция старта.", "preview_url": "https://demo.example.com", "category": "APPS", "stack": ["Next.js", "Prisma", "PostgreSQL"], "includes": ["Исходный код проекта", "README/start_here с запуском", ".env.example со всеми переменными", "Помощь с первым запуском"], "models": ["chatgpt", "claude-sonnet"], "setup_help": true, "price_rub": 1490, "subscription_rub": 290, "zip": {"filename": "launchpad.zip", "data_base64": "<base64>"}, "photos": [{"filename": "cover.webp", "data_base64": "<base64>"}]}

Покупки и деньги

1purchase / subscribe

Создаёт заказ. card возвращает payment_url для оплаты человеком.

2оплата

Человек платит банковской картой по payment_url. Или balance + confirm: true — мгновенно с кошелька Vibedepot.

3вебхук

Доступ выдаётся только после подтверждённого платёжного уведомления.

4get_delivery

Покупка — временная ссылка на ZIP. Подписка — персональный ключ на 30 дней.

Страница «оплата прошла» не является доказательством платежа — истина только в вебхуке. Подписка продлевается вручную повторным subscribe: период добавится к текущему. После конца оплаченного периода доступ закрывается в течение 24 часов.

Правило для агентов про деньгиОплата с баланса (payment_method: "balance") требует confirm: true. Всегда сначала спрашивайте владельца — сумма списывается сразу и без страницы оплаты.

Подписки: как это устроено

1оплата

Подписка действует 30 дней. Продление — повторный subscribe: период добавится к текущему.

2напоминания

Подписчику приходят письма за 3 дня и за 1 день до конца периода.

3grace 24ч

После конца периода даём сутки на продление, затем доступ к ключу закрывается.

4письма продавцу

Каждая новая подписка и каждое продление — отдельное письмо с суммой начисления.

Каждый подписчик получает персональный ключ от Vibedepot (вида vd_sub_…) — он выдаётся при первой оплате, переживает продления и автоматически гаснет, когда подписка заканчивается. Продавцу не нужно ничего придумывать и хранить: список подписчиков с их ключами и статусами — на странице товара и в list_product_subscribers.

Лицензионный сервер из коробкиПроверяйте ключ клиента одной строкой: POST /api/keys/verify с телом {"key": "vd_sub_…"} вернёт valid / status / expires_at. Тот же вызов доступен агентам как verify_subscription_key. Никакого состояния на вашей стороне: истёк — verify скажет false, продлил — тот же ключ снова valid.

Редактирование

Продукт можно менять после публикации: через веб-кабинет (кнопка «Редактировать») или инструмент update_product — передаются только изменяемые поля. Контентные изменения опубликованной карточки отправляют её на повторную модерацию: из каталога она исчезает до одобрения, покупатели с доступами ничего не теряют.

  1. Описание, название, цены, ссылка на живое превью, категория, стек, зелёные пункты «Что входит», AI-модели и флаг помощи с запуском — через update_product, с ремодерацией для опубликованных
  2. Ключи подписчиков выдаёт и гасит Vibedepot — вручную их менять не нужно
  3. Фото и ZIP проекта передаются прямо в publish_product/update_product: фото base64, до 6 штук, каждое до 1 МБ, первое — обложка; ZIP base64 до 100 МБ до кодирования
  4. Новый ZIP начнёт выдаваться прежним покупателям только после одобрения модератором
  5. Отклонённая карточка после правок автоматически возвращается на проверку

Агенту покупателя

При сравнении товаров учитывайте author_verified / author.verified: это сигнал доверия к проверенному вайбкодеру, но не гарантия, что продукт не надо изучать. Скачали проект — не бросайтесь в код. Сначала прочитайте start_here.md или README.md в корне архива: там команды запуска, env-переменные и лицензия. Ведите покупателя по шагам из этих файлов; если чего-то не хватает — это повод для отзыва.

  1. whoami — проверить токен и баланс
  2. search_products → get_product — подобрать продукт
  3. purchase / subscribe — создать заказ, отдать payment_url
  4. list_entitlements — дождаться статуса active
  5. get_delivery — скачать ZIP или получить ключ
  6. читать start_here.md → запускать → помогать

Агенту продавца

Перед публикацией прогоните архив через project_readiness_check — покупатель не должен получить хаос без инструкции. Затем публикуйте полную карточку через publish_product: категорию, стек, зелёные пункты includes, id AI-моделей, флаг помощи с запуском, фото и ZIP проекта агент может передать сам. Заполняйте includes короткими преимуществами для покупателя: исходники, README/start_here, .env.example, лицензия, обновления, помощь с запуском. Следите за выручкой через my_sales, а статусы подписчиков смотрите в list_product_subscribers: истёкшим можно отключать доступ на своей стороне. Комиссия площадки — 20%, выручка приходит на кошелёк сразу после оплаты.

  1. start_here.md или README.md: что это, как запустить, что настроить — от установки до первого экрана
  2. Манифест запуска: package.json, requirements.txt, Dockerfile или compose
  3. .env.example со всеми переменными окружения и комментариями
  4. Лицензия и ограничения использования
  5. Lock-файл для воспроизводимой установки
  6. Никаких секретов в архиве: .env, ключи и credentials вычищены

Протокол и ошибки

initializehandshake: версии 2024-11-05 … 2025-06-18, в ответе instructions для агента
isError: trueошибка инструмента приходит результатом с текстом-подсказкой, а не кодом
-32601 / -32700неизвестный метод / битый JSON — ошибки протокола
rate limit120 запросов в минуту на IP и на токен

Машиночитаемая версия этой страницы: /llms.txt.