Документация
Подключите агента к маркетплейсу
Vibedepot MCP — это полный цикл сделки для AI-агентов: найти продукт, купить или подписаться, скачать проект, разобраться в нём по start_here.md и даже продавать свои проекты и следить за выручкой. Всё по тем же правилам, что и для людей.
Подключение за минуту
Streamable HTTP, JSON-RPC 2.0. Публичные инструменты работают без токена — покупки и кабинет требуют Authorization: Bearer.
claude mcp add --transport http vibedepot \
https://vibedepot.ru/mcp \
--header "Authorization: Bearer ВАШ_ТОКЕН"{
"mcpServers": {
"vibedepot": {
"url": "https://vibedepot.ru/mcp",
"headers": {
"Authorization": "Bearer ВАШ_ТОКЕН"
}
}
}
}Настройки → Коннекторы → Создать:
URL: https://vibedepot.ru/mcp
Auth: Bearer ВАШ_ТОКЕН
// то же в OpenAI Agents SDK:
// MCPServerStreamableHttp(url=..., headers={...}){
"mcpServers": {
"vibedepot": {
"httpUrl": "https://vibedepot.ru/mcp",
"headers": {
"Authorization": "Bearer ВАШ_ТОКЕН"
}
}
}
}// Windsurf и Zed: тот же mcp.json, что у Cursor.
// VS Code: .vscode/mcp.json →
{
"servers": {
"vibedepot": {
"type": "http",
"url": "https://vibedepot.ru/mcp",
"headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
}
}
}// Стандартный streamable HTTP MCP-сервер.
// Укажите клиенту endpoint и передайте
// токен в заголовке Authorization:
https://vibedepot.ru/mcp
Authorization: Bearer ВАШ_ТОКЕН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-токены» и создайте токен. Он показывается один раз — мы храним только отпечаток. Токенов может быть до десяти, любой можно отозвать в один клик.
Authorization: Bearer vdm_…Токен действует от имени вашего аккаунта: покупки, доступы и публикации будут вашими. Не вставляйте его в публичный код.Инструменты
16 штук · схемы приходят в tools/listsearch_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}-<ваш мемо>»: доступ откроется автоматически. Баланс единый — платить можно любым способом, лишь бы хватало.
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>"}]}
Покупки и деньги
Создаёт заказ. card возвращает payment_url для оплаты человеком.
Человек платит банковской картой по payment_url. Или balance + confirm: true — мгновенно с кошелька Vibedepot.
Доступ выдаётся только после подтверждённого платёжного уведомления.
Покупка — временная ссылка на ZIP. Подписка — персональный ключ на 30 дней.
Страница «оплата прошла» не является доказательством платежа — истина только в вебхуке. Подписка продлевается вручную повторным subscribe: период добавится к текущему. После конца оплаченного периода доступ закрывается в течение 24 часов.
payment_method: "balance") требует confirm: true. Всегда сначала спрашивайте владельца — сумма списывается сразу и без страницы оплаты.Подписки: как это устроено
Подписка действует 30 дней. Продление — повторный subscribe: период добавится к текущему.
Подписчику приходят письма за 3 дня и за 1 день до конца периода.
После конца периода даём сутки на продление, затем доступ к ключу закрывается.
Каждая новая подписка и каждое продление — отдельное письмо с суммой начисления.
Каждый подписчик получает персональный ключ от 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, с ремодерацией для опубликованных
- Ключи подписчиков выдаёт и гасит Vibedepot — вручную их менять не нужно
- Фото и ZIP проекта передаются прямо в publish_product/update_product: фото base64, до 6 штук, каждое до 1 МБ, первое — обложка; ZIP base64 до 100 МБ до кодирования
- Отклонённая карточка после правок автоматически возвращается на проверку
Агенту покупателя
При сравнении товаров учитывайте 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%, выручка приходит на кошелёк сразу после оплаты.
- 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.