Zusammenfassung
Reverb API für Verkäufer von Musikinstrumenten: eigene Angebote mit Entwurf, Aktualisierung und Veröffentlichung, Bestellungen und Versand mit Sendungsverfolgung, Käufernachrichten, Angebote, Rückerstattungsanfragen, Auszahlungen und Shop-Daten. Persönlicher Zugriffstoken.
Geführte Einrichtung
Reverb in 2 Minuten mit Microsoft Copilot verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Reverb in der geführten Einrichtung und trag deine MCP-URL in Microsoft Copilot ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Reverb
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Reverb, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein
git clone, kein lokaler Server.
Reverb + Microsoft Copilot
Reverb API für Verkäufer von Musikinstrumenten: eigene Angebote mit Entwurf, Aktualisierung und Veröffentlichung, Bestellungen und Versand mit Sendungsverfolgung, Käufernachrichten, Angebote, Rückerstattungsanfragen, Auszahlungen und Shop-Daten. Persönlicher Zugriffstoken.
Voraussetzungen
Siehe die vollständigen Einrichtungsanweisungen, die im Connector enthalten sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
REVERB_TOKEN
Schritt 1 — Zugangsdaten erhalten
Die Einrichtung dauert etwa 3 Minuten.
- Melde dich bei reverb.com an, öffne dein Benutzermenü und gehe zu Mein Profil.
- Klicke auf den Tab API & Integrationen, dann auf Neuen Token generieren.
- Gib einen Namen ein und aktiviere die Berechtigungen:
public,read_listings,write_listings,read_orders,write_orders,read_messages,write_messages,read_offers,write_offers,read_payoutsundread_profile. Ein Tool, dessen Berechtigung fehlt, wird abgelehnt. - Kopiere den Token in
REVERB_TOKEN. Persönliche Zugriffstoken laufen nicht ab.
Reverb fordert jeden Verkäufer auf, die Abrechnung einzurichten und mindestens ein manuell erstelltes Angebot auf reverb.com zu haben, bevor die API verwendet werden kann.
Wo du anfangen kannst: reverb_list_orders_awaiting_shipment zeigt, was versendet werden muss. reverb_list_my_listings zeigt deine aktiven Angebote (alle Entwürfe und beendeten); reverb_get_shop zeigt den Shop und seine Versandprofile.
Angebote: Erstelle einen Entwurf mit reverb_create_listing (Kategorie-UUID von reverb_list_categories, Zustand-UUID von reverb_list_listing_conditions, Versandprofil-ID von reverb_get_shop), ändere ihn mit reverb_update_listing und stelle ihn mit reverb_publish_listing zum Verkauf. reverb_list_my_drafts listet unveröffentlichte Entwürfe und reverb_get_listing liest ein Angebot. Finde ein Angebot über deine SKU mit reverb_list_my_listings und sku. Nur die Bedingungen Neu, B-Ware und Mint mit Lagerbestand können mehr als eine Einheit halten; ein gebrauchter Artikel ist ein Einzelstück und kann nach dem Verkauf nicht erneut gelistet werden. Den Lagerbestand auf 0 zu setzen beendet das Angebot. reverb_end_listing ist installiert, aber deaktiviert.
Bestellungen: reverb_list_orders (alle, gefiltert nach letzter Änderung), reverb_list_orders_awaiting_shipment, reverb_get_order. Versende nur, wenn der Status bezahlt ist, mit reverb_ship_order (Anbieter von reverb_list_shipping_providers und die Sendungsverfolgungsnummer); lokale Abholungen werden mit reverb_mark_order_picked_up geschlossen. Versandetiketten werden nicht über diesen Connector gekauft.
Nachrichten und Angebote: reverb_list_conversations, reverb_get_conversation und reverb_send_message verwalten Käufernachrichten. reverb_list_offers und reverb_get_offer lesen Angebote zu deinen Listings; reverb_decline_offer lehnt eines ab. reverb_accept_offer und reverb_counter_offer sind installiert, aber deaktiviert, da beide dich an einen Preis binden.
Rückerstattungen und Auszahlungen: reverb_list_refund_requests liest Rückerstattungsanfragen. reverb_respond_to_refund_request und reverb_create_refund_request sind installiert, aber deaktiviert: Eine Genehmigung einer Rückerstattung gutschreibt dem Käufer und belastet dich sofort. reverb_list_payouts und reverb_list_payout_line_items lesen, was Reverb an deine Bank gezahlt hat und die Gebühren pro Bestellung.
Formate: Geld ist ein Objekt mit amount (dezimaler String wie 95.00), amount_cents, currency und display; sende Betrag und Währung. Daten sind im ISO 8601-Format mit einem Offset. IDs: Bestellungen verwenden die Bestellnummer, Angebote die numerische Angebots-ID, Kategorien und Bedingungen eine UUID.
Paging und Links: Reverb antwortet im HAL JSON-Format. Listen tragen _links.next und _links.prev; wenn next fehlt, bist du auf der letzten Seite. Verwende page und per_page, um zu navigieren. Jedes Objekt listet auch die Aktionen, die ihm unter _links offenstehen.
Fehler: 401 bedeutet, dass der Token falsch ist oder die Berechtigung fehlt; 404 nicht gefunden; 406 die Aktion würde eine Regel des aktuellen Zustands verletzen; 412 ein Validierungsfehler mit message und errors pro Feld; 429 zu viele Aufrufe.
Rate Limits: Lese 2.000 pro Minute oder 10.000 pro 10 Minuten; schreibe 600 pro Minute oder 3.000 pro 10 Minuten. Vermeide es, den gesamten Shop auf einmal zu synchronisieren.
Sandbox: sandbox.reverb.com ist eine separate Seite mit eigenen Konten und Tokens; dieser Connector ruft die Produktions-API auf.
Schritt 2 — Adapter installieren
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
Schritt 3 — Connector in Microsoft Copilot hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
Reverb-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
reverb_list_my_listings | Listet deine eigenen Angebote mit ihrer ID, Titel, Marke, Modell, SKU, Zustand, Preis (Betrag und Währung), Lagerbestand und _links (das Angebot… |
reverb_list_my_drafts | Listet deine Entwurfsangebote (erstellt, aber noch nicht veröffentlicht) mit denselben Feldern wie reverb_list_my_listings: ID, Titel, Marke, Modell, SKU… |
reverb_get_listing | Liest ein Angebot nach ID mit den Feldern, aus denen ein Angebot erstellt wird: Titel, Marke, Modell, Finish, Jahr, Beschreibung, Zustand, Kategorien… |
reverb_create_listing | Erstellt ein Angebot als Entwurf in deinem Reverb-Shop. Es ist für Käufer nicht sichtbar, bis reverb_publish_listing aufgerufen wird. Gib mindestens einen Titel… |
reverb_update_listing | Aktualisiert eines deiner Angebote (Entwurf oder aktiv): nur die angegebenen Felder ändern sich. Typische Verwendungen: Preis, Lagerbestand, Beschreibung, Fotos, Versand… |
reverb_publish_listing | Veröffentlicht ein Entwurfsangebot, damit Käufer es sehen und kaufen können. Der Entwurf muss vollständig sein (Marke und Modell bekannt, Kategorie, Zustand, Preis, Fotos… |
reverb_end_listing | Beendet ein aktives Angebot, sodass es nicht mehr gekauft werden kann. Grund not_sold entfernt es einfach. Grund reverb_sale sagt, dass du den Käufer auf… |
reverb_list_orders | Listet die Bestellungen, die du verkauft hast, alle Status: Bestellnummer, Status (unbezahlt, Zahlung ausstehend, zur Überprüfung ausstehend, blockiert, bezahlt, versendet, abgeholt… |
reverb_list_orders_awaiting_shipment | Listet bezahlte Bestellungen, die noch versendet werden müssen, mit denselben Feldern wie reverb_list_orders (Bestellnummer, Titel, Menge, Käufername… |
reverb_get_order | Liest eine verkaufte Bestellung nach ihrer Bestellnummer: Bestellnummer, Status (unbezahlt, Zahlung ausstehend, zur Überprüfung ausstehend, blockiert, bezahlt, versendet, abgeholt… |
reverb_ship_order | Markiert eine bezahlte Bestellung als versendet mit dem Anbieter und der Sendungsverfolgungsnummer. Mit send_notification true informiert Reverb den Käufer per E-Mail, dass der Artikel… |
reverb_mark_order_picked_up | Markiert eine lokale Abholbestellung als vom Käufer abgeholt (Bestellungen mit Versandmethode lokal). Der Bestellstatus wird auf abgeholt gesetzt. Verwende es nur… |
reverb_list_shipping_providers | Listet die Versanddienstleister (Carrier), die Reverb akzeptiert, wenn eine Bestellung als versendet markiert wird. Verwende den Anbieternamen genau wie aufgeführt in… |
reverb_list_conversations | Listet deine Nachrichtenunterhaltungen auf Reverb, jede mit ihrer ID (benötigt, um sie zu lesen oder zu beantworten) und _links. Mit unread_only true nur… |
reverb_get_conversation | Liest eine Unterhaltung im Detail, mit ihren Nachrichten in chronologischer Reihenfolge (älteste zuerst), sodass der gesamte Austausch mit dem Käufer… |
reverb_send_message | Antwortet in einer bestehenden Unterhaltung. Die andere Partei erhält die Nachricht sofort auf Reverb und sie kann nicht zurückgenommen werden, also schreibe sie so, wie… |
reverb_list_offers | Listet die aktiven Angebote (Reverb nennt sie Verhandlungen), die Käufer auf deinen Angeboten gemacht haben, jedes mit seiner ID für reverb_get_offer und der Antwort… |
reverb_get_offer | Liest die Details eines Angebots (Verhandlung) nach ID: das Angebot, auf dem es sich befindet, die bisher angebotenen Preise und seinen aktuellen Zustand, mit _links zu… |
reverb_decline_offer | Lehne ein Angebot eines Käufers für eines deiner Angebote ab. Die Verhandlung endet ohne Verkauf und die Ablehnung kann nicht zurückgenommen werden; kein Preis wird… |
reverb_accept_offer | Akzeptiere ein Angebot eines Käufers. Dies ist verbindlich: Du stimmst zu, den Artikel zum angebotenen Preis und Versandpreis zu verkaufen, und der Käufer kann sofort bezahlen.… |
reverb_counter_offer | Antworte auf das Angebot eines Käufers mit einem Gegenangebot: deinem Preis und, falls gewünscht, einem Versandpreis. Ein Gegenangebot ist verbindlich, wenn der Käufer es akzeptiert… |
reverb_list_refund_requests | Listet Rückerstattungsanfragen zu deinen Verkäufen, standardmäßig die aktiven (pending_seller_response und conditionally_approved): ID, Zustand, Betrag… |
reverb_respond_to_refund_request | Beantworte eine Rückerstattungsanfrage: conditionally_approved (du wirst zurückerstatten, sobald der Artikel zurück ist; die Anfrage bleibt offen), approved (Rückerstattung jetzt… |
reverb_create_refund_request | Starte eine Rückerstattung für eine deiner verkauften Bestellungen als Verkäufer, vollständig oder teilweise. Sie wird als bedingt genehmigt erstellt; das Geld bewegt sich, wenn die… |
reverb_list_payouts | Listet die Auszahlungen, die Reverb an dein Bankkonto gesendet hat: pro Auszahlung insgesamt (Betrag und Währung), created_at, updated_at und _links.line_items… |
reverb_list_payout_line_items | Listet die Zeilen einer Auszahlung, eine pro Bestellung: order_id, sale_date, sale_price, payout_currency und die abgezogenen Gebühren (selling_fee… |
reverb_get_shop | Liest deinen Shop: ID, Name, Beschreibung und shipping_profiles[] (ID und Name), deren IDs in shipping_profile_id eines Angebots eingehen. Versand… |
reverb_list_categories | Listet alle Reverb-Kategorien als eine flache Liste mit ihrer UUID und ihrem Namen. Die UUID ist das, was die Kategorien eines Angebots annehmen. Eine lange Liste; einige… |
reverb_list_listing_conditions | Listet die Bedingungen, die dein Shop für Angebote verwenden kann (Nicht funktionsfähig, Schlecht, Fair, Gut, Sehr Gut, Exzellent, Mint, B-Ware, Neu): UUID… |
Beispielaufforderungen
- "Welche Reverb-Bestellungen warten auf den Versand?"
- "Entwerfe ein Angebot für meine 2019 Gibson Les Paul Standard in ausgezeichnetem Zustand für 2.200 USD."
- "Welche Angebote von Käufern sind auf meinen Angeboten offen?"
- "Versende die Bestellung 12345678 mit UPS Sendungsverfolgung 1Z999AA10123456784."
- "Zeige meine Auszahlungen aus dem letzten Monat und deren Zeilen."
FAQ
Wo bekomme ich den Token? Auf reverb.com: Benutzermenü, Mein Profil, API & Integrationen, Neuen Token generieren, mit den Berechtigungen für Angebote, Bestellungen, Nachrichten, Angebote, Auszahlungen und Profil. Persönliche Zugriffstoken laufen nicht ab. Reverb fordert die Abrechnung und ein manuell erstelltes Angebot an, bevor die API funktioniert.
Was deckt es ab? Deinen eigenen Shop: Angebote vom Entwurf bis zur Veröffentlichung, Bestellungen und Versand, Käuferunterhaltungen, Angebote, Rückerstattungsanfragen, Auszahlungen und Shop-Daten. Die gesamte Marktplatzsuche ohne Token ist der Reverb Listings Connector.
Welche Tools sind standardmäßig deaktiviert? reverb_end_listing, reverb_accept_offer, reverb_counter_offer, reverb_respond_to_refund_request und reverb_create_refund_request, da sie verkaufen, Rückerstattungen bearbeiten oder ein Angebot beenden. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
War dieser Guide hilfreich?