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

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

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

Endpointhttps://vibedepot.ru/mcp

ПРОМТ

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

Бесплатные проекты

Для поиска бесплатных проектов передайте price: free в search_products. get_free_product с id или slug товара выдаёт временную ссылку на ZIP и сохраняет доступ в кабинете. Оплата, баланс и подтверждение покупки не требуются. После выдачи файла можно оставить отзыв на сайте.

Чтобы опубликовать бесплатный товар или сделать существующий бесплатным, передайте is_free: true и ZIP проекта. Не указывайте price_rub и subscription_rub. Фото, лимиты полей и модерация остаются обязательными. Для перехода обратно на платный режим передайте is_free: false и положительную цену. Полученный ранее доступ сохраняется.

Бесплатное скачивание

{"name":"get_free_product","arguments":{"product":"free-project"}}

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

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_…Токен действует от имени вашего аккаунта: покупки, доступы и публикации будут вашими. Не вставляйте его в публичный код.

Инструменты

17 штук · схемы приходят в tools/list

search_productspublic

Поиск продуктов: Найти опубликованные продукты по запросу и фильтрам. Возвращает цены, рейтинг и ссылки. Сортировка: popular (по продажам), new, price.
Пример аргументов: {"query": "трекер привычек", "sort": "popular", "limit": 5}

list_categoriespublic

Категории каталога: Список активных категорий каталога со slug, названием и эмодзи.

get_productpublic

Карточка продукта: Полные данные продукта: описание, цены, условия подписки, includes (зелёные пункты «Что входит»), рейтинг, свежие отзывы, автор, verified-статус, стек и AI-модели. archive_scan для выдаваемого ZIP: null до готового результата; затем объект со status clean | warning | danger и findings без значений секретов, фрагментов кода и сырых логов. ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу. Повторная проверка только при замене ZIP, не при правке текста. clean означает, что нет существенных замечаний. Политика findingPolicyVersion=2 учитывает high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: true означает неполную проверку, только warning/danger, никогда clean.
Пример аргументов: {"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» для подписки. Баланс единый — платить можно любым способом, лишь бы хватало.

get_free_productbearer

Скачать бесплатный проект: Получить бесплатный ZIP и сохранить доступ в кабинете. Возвращает временную ссылку (600 секунд). Не создаёт платёж, не списывает баланс. После выдачи файла доступен отзыв через сайт.
Пример аргументов: {"product":"free-project"}

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-архив или ключ подписки. В ответе FILE поле archive_scan относится именно к выдаваемой версии ZIP: null, если результат недоступен, либо объект со status clean | warning | danger и findings без значений секретов, фрагментов кода и сырых логов. ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу. Повторная проверка только при замене ZIP, не при правке текста. clean означает, что нет существенных замечаний. Политика findingPolicyVersion=2 учитывает high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: true означает неполную проверку, только warning/danger, никогда clean. После скачивания сначала читайте start_here.md/README.md.

my_salesbearer

Мои продажи: Панель продавца: баланс кошелька, продукты со статистикой (продажи, просмотры, рейтинг), последние начисления и статус заявок на вывод. products[].candidate_archive_scan относится к загруженной продавцом версии ZIP: null до готового результата, затем объект со status clean | warning | danger и findings без значений секретов, фрагментов кода и сырых логов. ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу. Повторная проверка только при замене ZIP, не при правке текста. clean означает, что нет существенных замечаний. Политика findingPolicyVersion=2 учитывает high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: true означает неполную проверку, только warning/danger, никогда clean.

list_product_subscribersbearer

Подписчики продукта: Для автора продукта: подписчики с персональными ключами, статусами (активна / ждёт продления / истекла) и датами оплаченного периода. Истёкшие ключи гаснут автоматически — сверяйте их через verify_subscription_key.

update_productbearer

Редактировать продукт: Изменить свой продукт: передаются только те поля, которые нужно поменять. name до 60 символов, tagline до 80, stack до 10 технологий, includes до 15 пунктов; превышение возвращает ошибку до загрузки файлов. Неизменённые старые длинные name/tagline можно оставить: не передавайте их. Новый набор photos (base64) полностью заменяет текущие фото; новый zip начнёт выдаваться покупателям только после модерации. Контентные изменения опубликованного продукта отправляют карточку на повторную модерацию. ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу. Повторная проверка только при замене ZIP, не при правке текста. clean означает, что нет существенных замечаний. Политика findingPolicyVersion=2 учитывает high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: true означает неполную проверку, только warning/danger, никогда clean.
Пример аргументов: {"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

Опубликовать продукт: Создать карточку продукта целиком из аргументов: name до 60 символов, tagline до 80, описание, опциональный preview_url, категория, stack до 10 технологий, includes до 15 зелёных пунктов «Что входит», models, setup_help, фото (base64, до 6) и ZIP-архив проекта (base64, до 100 МБ) — полная карточка уходит на модерацию сразу, без веб-кабинета. Превышение лимитов возвращает ошибку до загрузки файлов, без обрезки текста. Персональные ключи подписчикам выдаёт Vibedepot. ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу. Повторная проверка только при замене ZIP, не при правке текста. clean означает, что нет существенных замечаний. Политика findingPolicyVersion=2 учитывает high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: true означает неполную проверку, только warning/danger, никогда clean.
Пример аргументов: {"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 — передаются только изменяемые поля. Контентные изменения опубликованной карточки отправляют её на повторную модерацию: из каталога она исчезает до одобрения, покупатели с доступами ничего не теряют.

Описание, название, цены, ссылка на живое превью, категория, стек, зелёные пункты «Что входит», AI-модели и флаг помощи с запуском — через update_product, с ремодерацией для опубликованных
Описание ограничено 10 000 символами, включая пробелы и переносы строк. Для переносов используйте \n. Лимит действует при создании и редактировании; длинный текст отклоняется, а не обрезается автоматически.
Остальные лимиты: name до 60 символов Unicode, tagline до 80, preview_url до 2048; stack до 10 непустых технологий, includes до 15 непустых пунктов. Запятые в stack и переносы строк в includes разделяют пункты, в том числе внутри элементов массива. Пробелы по краям названия и короткого описания удаляются, внутренние пробелы считаются. Лимиты одинаковы в веб-форме и MCP и проверяются до загрузки файлов.
При редактировании старое название или короткое описание сверх лимита можно оставить без изменений. Новые значения должны укладываться в лимиты. В update_product не передавайте поля, которые не меняете.
Ключи подписчиков выдаёт и гасит Vibedepot — вручную их менять не нужно
Фото и ZIP проекта передаются прямо в publish_product/update_product: фото base64, до 6 штук, каждое до 1 МБ, первое — обложка; ZIP base64 до 100 МБ до кодирования
Для обложки рекомендуем горизонтальное изображение 1280x800 (8:5). Превью каталога обрезает края по-разному на разных экранах, поэтому важные детали размещайте ближе к центру. Вертикальные скриншоты добавляйте после обложки. Новые фото уменьшаются пропорционально без обрезки; в галерее товара и полном просмотре они видны целиком.
Новый ZIP начнёт выдаваться прежним покупателям только после одобрения модератором
Загруженный ZIP проверяется в фоне. Проверка и её результат не блокируют покупку и выдачу; повторная проверка запускается только при замене ZIP, не при правке текста. Пройденная проверка означает, что нет существенных замечаний: low/medium, находки ключей, токенов и других секретов (включая DS-0031) и исключённые контекстные эвристики не влияют на публичный статус, findings и findingCount. Результат не гарантирует безопасность.
Отклонённая карточка после правок автоматически возвращается на проверку

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

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

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

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

Перед публикацией прогоните архив через project_readiness_check — покупатель не должен получить хаос без инструкции. Затем публикуйте полную карточку через publish_product: категорию, стек, зелёные пункты includes, id AI-моделей, флаг помощи с запуском, фото и ZIP проекта агент может передать сам. Заполняйте includes короткими преимуществами для покупателя: исходники, README/start_here, .env.example, лицензия, обновления, помощь с запуском. Следите за выручкой через my_sales, а статусы подписчиков смотрите в list_product_subscribers: истёкшим можно отключать доступ на своей стороне. Комиссия площадки — 20%, выручка приходит на кошелёк сразу после оплаты. get_product.archive_scan относится к выдаваемому архиву, my_sales.products[].candidate_archive_scan — к загруженной продавцом версии. Оба поля равны null, пока для этого файла нет готового результата, затем содержат объект со status: clean (нет существенных замечаний), warning (существенные замечания для проверки) или danger (признаки вредоносного ПО), и findings без значений секретов, фрагментов кода и сырых логов. findingPolicyVersion=2 обозначает версию политики отбора замечаний: учитываются high/critical, кроме исключённых контекстных эвристик. Low/medium и находки ключей, токенов и других секретов, включая DS-0031, не влияют на публичный status, findings и findingCount. Результат clean не гарантирует безопасность. Найденные существенные замечания видны даже при частичном сбое: partial: trueозначает неполную проверку, только warning/danger, никогда clean.

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

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

initializehandshake: версии 2024-11-05 … 2025-06-18, в ответе instructions для агента

isError: trueошибка инструмента приходит результатом с текстом-подсказкой, а не кодом

-32601 / -32700неизвестный метод / битый JSON — ошибки протокола

rate limit120 запросов в минуту на IP и на токен

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