Кратко
API Reverb для продавцов музыкального оборудования: собственные объявления с черновиками, обновлениями и публикациями, заказы и доставка с отслеживанием, сообщения от покупателей, предложения, запросы на возврат, выплаты и данные магазина. Личный токен доступа.
Пошаговая настройка
Подключи Reverb к Microsoft Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи Reverb в пошаговой настройке и добавь свой MCP URL в Microsoft Copilot. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для Reverb
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → Reverb, вставь свои учетные данные, создай ключ API MCP, и всё готово. Никакого Docker, никакого
git clone, никакого локального сервера.
Reverb + Microsoft Copilot
API Reverb для продавцов музыкального оборудования: собственные объявления с черновиками, обновлениями и публикациями, заказы и доставка с отслеживанием, сообщения от покупателей, предложения, запросы на возврат, выплаты и данные магазина. Личный токен доступа.
Предварительные требования
Смотри полные инструкции по настройке, встроенные в коннектор (видны в магазине приложения, когда ты выбираешь коннектор). Необходимые переменные окружения для этого коннектора:
REVERB_TOKEN
Шаг 1 — Получи учетные данные
Настройка занимает около 3 минут.
- Войди на reverb.com, открой меню пользователя и перейди в Мой профиль.
- Нажми на вкладку API & Integrations, затем Создать новый токен.
- Введи имя и отметь области:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutsиread_profile. Инструмент, у которого отсутствует область, будет отклонён. - Скопируй токен в
REVERB_TOKEN. Личные токены доступа не истекают.
Reverb просит каждого продавца настроить биллинг и создать хотя бы одно объявление вручную на reverb.com перед использованием API.
С чего начать: reverb_list_orders_awaiting_shipment показывает, что нужно отправить. reverb_list_my_listings показывает твои активные объявления (состояние всех добавленных черновиков и завершённых); reverb_get_shop показывает магазин и его профили доставки.
Объявления: создай черновик с помощью reverb_create_listing (uuid категории из reverb_list_categories, uuid состояния из reverb_list_listing_conditions, id профиля доставки из reverb_get_shop), измени его с помощью reverb_update_listing и выстави на продажу с помощью reverb_publish_listing. reverb_list_my_drafts перечисляет неопубликованные черновики, а reverb_get_listing читает одно объявление. Найди объявление по своему SKU с помощью reverb_list_my_listings и sku. Только состояния Brand New, B-Stock и Mint с наличием могут содержать более одной единицы; использованный товар — это одна единица и не может быть повторно выставлен на продажу после продажи. Установка наличия на 0 завершает объявление. reverb_end_listing установлен выключенным.
Заказы: reverb_list_orders (все, фильтруя по последнему изменению), reverb_list_orders_awaiting_shipment, reverb_get_order. Отправляй только когда статус оплачен, с помощью reverb_ship_order (поставщик из reverb_list_shipping_providers и номер отслеживания); локальные самовывозы закрываются с помощью reverb_mark_order_picked_up. Этикетки для доставки не покупаются через этот коннектор.
Сообщения и предложения: reverb_list_conversations, reverb_get_conversation и reverb_send_message обрабатывают сообщения от покупателей. reverb_list_offers и reverb_get_offer читают предложения по твоим объявлениям; reverb_decline_offer отклоняет одно из них. reverb_accept_offer и reverb_counter_offer установлены выключенными, так как оба обязывают тебя к цене.
Возвраты и выплаты: reverb_list_refund_requests читает запросы на возврат. reverb_respond_to_refund_request и reverb_create_refund_request установлены выключенными: одобрение возврата зачисляет деньги покупателю и списывает с тебя сразу. reverb_list_payouts и reverb_list_payout_line_items читают, что Reverb выплатил твоему банку и комиссии за заказ.
Форматы: деньги — это объект с amount (десятичная строка, такая как 95.00), amount_cents, currency и display; отправляй сумму и валюту. Даты — ISO 8601 с смещением. Идентификаторы: заказы используют номер заказа, объявления — числовой id объявления, категории и состояния — uuid.
Пагинация и ссылки: Reverb отвечает в формате HAL JSON. Списки содержат _links.next и _links.prev; когда следующая ссылка отсутствует, ты на последней странице. Используй page и per_page для перемещения. Каждый объект также перечисляет доступные действия под _links.
Ошибки: 401 означает, что токен неверен или не имеет области; 404 не найдено; 406 действие нарушит правило текущего состояния; 412 ошибка валидации с message и errors для каждого поля; 429 слишком много вызовов.
Лимиты скорости: чтения 2,000 в минуту или 10,000 за 10 минут; записи 600 в минуту или 3,000 за 10 минут. Избегай синхронизации всего магазина сразу.
Песочница: sandbox.reverb.com — это отдельный сайт с собственными учетными записями и токенами; этот коннектор вызывает производственный API.
Шаг 2 — Установи адаптер
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Шаг 3 — Добавь коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
Reverb. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
reverb_list_my_listings | Перечисляет твои собственные объявления с их id, названием, маркой, моделью, sku, состоянием, ценой (сумма и валюта), наличием и _links (объявление… |
reverb_list_my_drafts | Перечисляет твои черновики объявлений (созданные, но еще не опубликованные) с теми же полями, что и reverb_list_my_listings: id, название, марка, модель, sku… |
reverb_get_listing | Читает одно объявление по id с полями, из которых создаётся объявление: название, марка, модель, отделка, год, описание, состояние, категории… |
reverb_create_listing | Создаёт объявление как черновик в твоем магазине Reverb. Оно не будет видно покупателям, пока не будет вызван reverb_publish_listing. Укажи хотя бы название… |
reverb_update_listing | Обновляет одно из твоих объявлений (черновик или активное): изменяются только указанные поля. Типичные случаи: цена, наличие, описание, фотографии, доставка… |
reverb_publish_listing | Публикует черновик объявления, чтобы покупатели могли его видеть и покупать. Черновик должен быть полным (известны марка и модель, категория, состояние, цена, фотографии… |
reverb_end_listing | Завершает активное объявление, чтобы его больше нельзя было купить. Причина not_sold просто снимает его. Причина reverb_sale говорит, что ты нашел покупателя на… |
reverb_list_orders | Перечисляет заказы, которые ты продал, все статусы: order_number, статус (неоплаченный, ожидание оплаты, на рассмотрении, заблокирован, оплачен, отправлен, забран… |
reverb_list_orders_awaiting_shipment | Перечисляет оплаченные заказы, которые еще нужно отправить, с теми же полями, что и reverb_list_orders (order_number, название, количество, имя покупателя… |
reverb_get_order | Читает один проданный заказ по его номеру заказа: order_number, статус (неоплаченный, ожидание оплаты, на рассмотрении, заблокирован, оплачен, отправлен, забран… |
reverb_ship_order | Отмечает оплаченный заказ как отправленный с перевозчиком и номером отслеживания. С параметром send_notification true Reverb отправляет покупателю электронное письмо о том, что товар… |
reverb_mark_order_picked_up | Отмечает заказ на самовывоз как забранный покупателем (заказы с методом доставки local). Статус заказа становится picked_up. Используй это только… |
reverb_list_shipping_providers | Перечисляет перевозчиков, которых Reverb принимает, когда заказ отмечен как отправленный. Используй имя поставщика точно так, как указано в… |
reverb_list_conversations | Перечисляет твои сообщения в Reverb, каждое с его id (необходимым для чтения или ответа) и _links. С параметром unread_only true только… |
reverb_get_conversation | Читает одно сообщение в деталях, с его сообщениями в хронологическом порядке (сначала старые), чтобы весь обмен с покупателем можно было… |
reverb_send_message | Отвечает в существующем разговоре. Другая сторона получает сообщение в Reverb сразу, и его нельзя отменить, поэтому пиши его так, как… |
reverb_list_offers | Перечисляет активные предложения (Reverb называет их переговорами), которые покупатели сделали по твоим объявлениям, каждое с его id для reverb_get_offer и ответом… |
reverb_get_offer | Читает детали одного предложения (переговоров) по id: объявление, на котором оно находится, цены, предложенные до сих пор, и его текущее состояние, с _links к… |
reverb_decline_offer | Отклоняет предложение покупателя по одному из твоих объявлений. Переговоры заканчиваются без продажи, и отклонение нельзя отменить; цена не… |
reverb_accept_offer | Принимает предложение покупателя. Это обязывающе: ты соглашаешься продать товар по предложенной цене и цене доставки, и покупатель может заплатить сразу.… |
reverb_counter_offer | Отвечает на предложение покупателя встречным предложением: твоя цена и, при необходимости, цена доставки. Встречное предложение является обязывающим, если покупатель принимает… |
reverb_list_refund_requests | Перечисляет запросы на возврат по твоим продажам, по умолчанию активные (pending_seller_response и conditionally_approved): id, состояние, сумма… |
reverb_respond_to_refund_request | Отвечает на запрос на возврат: conditionally_approved (ты вернёшь деньги, как только товар вернётся; запрос остаётся открытым), approved (возврат сейчас… |
reverb_create_refund_request | Начинает возврат по одному из твоих проданных заказов как продавец, полный или частичный. Он создаётся как условно одобренный; деньги перемещаются, когда… |
reverb_list_payouts | Перечисляет выплаты, которые Reverb отправил на твой банковский счёт: по каждой выплате общая сумма (сумма и валюта), created_at, updated_at и _links.line_items… |
reverb_list_payout_line_items | Перечисляет строки одной выплаты, по одной на заказ: order_id, sale_date, sale_price, payout_currency и взимаемые комиссии (selling_fee… |
reverb_get_shop | Читает твой магазин: id, название, описание и shipping_profiles[] (id и название), чьи id идут в shipping_profile_id объявления. Доставка… |
reverb_list_categories | Перечисляет все категории Reverb в одном плоском списке с их uuid и названием. UUID — это то, что берут категории объявления. Длинный список; некоторые… |
reverb_list_listing_conditions | Перечисляет состояния, которые твой магазин может использовать в объявлениях (Не функционирует, Плохое, Удовлетворительное, Хорошее, Очень хорошее, Отличное, Mint, B-Stock, Brand New): uuid… |
Примеры подсказок
- "Какие заказы Reverb ожидают отправки?"
- "Создай черновик объявления для моего Gibson Les Paul Standard 2019 года в отличном состоянии за 2,200 USD."
- "Какие предложения от покупателей открыты по моим объявлениям?"
- "Отправь заказ 12345678 с отслеживанием UPS 1Z999AA10123456784."
- "Покажи мои выплаты за последний месяц и их строки."
Часто задаваемые вопросы
Где я могу получить токен? На reverb.com: меню пользователя, Мой профиль, API & Integrations, Создать новый токен, с областями для объявления, заказа, сообщения, предложения, выплаты и профиля. Личные токены доступа не истекают. Reverb требует настройки биллинга и одно объявление, созданное вручную, прежде чем API заработает.
Что это охватывает? Твой собственный магазин: объявления от черновика до публикации, заказы и доставка, разговоры с покупателями, предложения, запросы на возврат, выплаты и данные магазина. Поиск по всему рынку без токена — это коннектор Reverb Listings.
Какие инструменты установлены выключенными? reverb_end_listing, reverb_accept_offer, reverb_counter_offer, reverb_respond_to_refund_request и reverb_create_refund_request, потому что они продают, возвращают или завершают объявление. Включай их на странице коннектора только если ИИ должен их использовать.
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
Это руководство помогло?