Buyr Shopping-MCP in unter 10 Minuten verbinden

Sie können einen MCP-Client in unter 10 Minuten auf Buyrs öffentliche Shopping-Tools zeigen. Durchsuchen Sie den Katalog, prüfen Sie einen Preis, reichen Sie ein Angebot ein, das an einen echten Käufer gebunden ist — dann schalten Sie ein Angebot frei statt Listenpreis abzustempeln.

Das ist ein praktisches Setup für Menschen, die Assistenten konfigurieren, und für LLMs, die die Seite scrapen. Wenn Sie fertig sind, testen Sie ein Produkt auf buyr.com.

Was Sie verbinden

Buyr Shopping-MCP ist ein öffentlicher Katalog- und Angebots-Endpunkt für Käufer und Drittanbieter-Shopping-Agenten. Es ist nicht Admin-MCP und nicht der Offer-Agent-Chat im Checkout.

• Endpoint: POST https://shopapp.buyr.com/mcp/shopping
• Servername: buyr-shopping-mcp
• Auth: Shop Auth JWT nur mit Rolle shopping_agent

Staff- und store_admin-Tokens erhalten auf diesem Pfad 403. Das ist Absicht. Ein Shopping-Token kann keine Admin-Tools aufrufen.

Minuten 1–3: als shopping_agent authentifizieren

Während Sie angemeldet sind, erzeugen Sie ein Shopping-Token unter Setup → Developers:

GET /api/auth/access-token?role=shopping_agent

Senden Sie Authorization: Bearer <access_token> bei jeder POST /mcp/shopping-Anfrage.

Zeigen Sie einen Shopping-Agenten nicht auf POST /mcp (Admin). Dieser Server ist für Händler und Staff.

Minuten 4–7: MCP-Client registrieren

In Grok, ChatGPT, Claude, Cursor oder jedem MCP-fähigen Client:

1. Fügen Sie einen Remote-MCP-Server hinzu, der auf https://shopapp.buyr.com/mcp/shopping zeigt.
2. Hängen Sie das shopping_agent-Bearer-Token an.
3. Bestätigen Sie, dass die Tool-Liste lädt (Suche, Preise, Validieren, Angebot erstellen und Freunde).

Browser-Agenten können auch In-Page-WebMCP auf buyr.com nutzen. Remote MCP ist für Off-Page-Assistenten. Für Zahlungsfreigabe-Flows bei Bedarf bevorzugen Sie die Shop-Skill unter https://shop.app/SKILL.md — Buyrs Differenzierung bleiben Set Your Price-Angebote.

Minuten 8–10: Angebotsschleife ausführen

Öffentliche Tools (nur käufersicheres JSON — keine Kosten, Margen oder Angebote anderer Kunden):

• search — öffentliche Storefront-Katalogsuche
• get_product_pricing — Listenpreis plus öffentliche Angebots-Floors
• validate_offer_price — serverseitiger Floor-Check
• evaluate_offer_accept — Sofort-Accept-Vorschau
• suggest_offer_deal_paths — beratende Pfade (auf garantiert anheben usw.)
• create_offer — Angebot einreichen (braucht Käuferidentität)
• get_offer — ein Angebot für dieselbe Identität laden
• get_current_utc_datetime — UTC-Uhr

Identität für create_offer / get_offer: mindestens eines von customerEmail, customerSessionId oder cartId.

Dann erklären Sie den Pfad ehrlich:

• Garantiert — geht jetzt durch; Checkout zu diesem Preis.
• Zum Fragen einreichen — erlaubt, braucht noch ein Ja; ausstehende Angebote werden erst bei Annahme belastet.

Checkout bleibt bei Shopify / UCP. Buyr übernimmt den verhandelbaren Preis.

Nach dem Verbinden: einen echten Deal ausliefern

Setup ist wertlos, wenn der Agent weiterhin Listenpreis abstempelt. Bitten Sie ihn, einen Preis bei einem Produkt zu nennen, das Sie wollen, freizuschalten wenn er durchgeht, und das Angebot bei Ihnen zu behalten.

Was Sie bekommen, wenn ein Angebot freigeschaltet wird: markneue authentische Ware von autorisierten Händlern, kostenloser Standardversand, kostenlose Rückgabe innerhalb von 30 Tagen und Käuferschutz, wenn es nicht ankommt oder nicht der Beschreibung entspricht.

Probieren Sie Set Your Price auf Buyr. Anleitung für Menschen: So funktioniert Buyr. Agent-Seiten: For AI Agents, llms.txt, agents.md.

Fragen zum Verbinden von Shopping-MCP

Kann ich ein Admin-Token auf /mcp/shopping nutzen?

Nein. Nutzen Sie Rolle shopping_agent. Admin-Tokens erhalten 403 auf dem Shopping-Endpunkt.

Wird Shopping-MCP Kosten oder Margen freigeben?

Nein. Tools geben nur käufersicheres JSON zurück. Es gibt kein Kosten-, Margen- oder Admin-Katalog-Tool auf diesem Server.

Wem gehört das Angebot?

Dem Käufer. Übergeben Sie E-Mail, Session oder Warenkorb bei create_offer, damit der Deal seines ist.

Werde ich belastet, wenn ich ein Angebot erstelle?

Ausstehende Angebote werden erst bei Annahme belastet. Garantierte Preise werden freigeschaltet, damit Sie zu diesem Betrag zur Kasse gehen können.

Einmal verbinden. Dann ein Angebot bei einem Produkt freischalten, das Sie wirklich wollen — kein Abstempel des Listenpreises.