Back Market MCP mit Gemini CLI verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → Back Market, füge deine Zugangsdaten ein, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

Back Market + Gemini

Back Market Verkäufer-API für Aufbereiter: Bestellungen mit Annahme und Versand mit Tracking, Angebote mit Preis und Lagerbestand, Backbox- und Wettbewerberpreise, Kategorien, Kundenservice-Ordner und Nachrichten, BackShip-Lieferungen und BuyBack-Bestellungen. API-Token, pro Plattform (Europa, Vereinigte Staaten, Asien-Pazifik).

Voraussetzungen

Siehe die vollständigen Einrichtungsanweisungen, die im Connector integriert sind (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:

BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 3 Minuten.

1. Melde dich im Back Market Backoffice deiner Plattform an: https://www.backmarket.fr/bo-seller (Europa), https://www.backmarket.com/bo-seller (Vereinigte Staaten) oder https://www.backmarket.co.jp/bo-seller (Japan und Australien). Der API-Zugang erfolgt mit einem Verkäuferkonto, das von Back Market validiert wurde.
2. Öffne die Seite Integrationen unter Optionen und erstelle ein API-Token.
3. Füge das Token wie gezeigt in BACK_MARKET_TOKEN ein, ohne das Wort Basic davor: der Connector sendet es als Authorization: Basic gefolgt vom Token.
4. Wähle deine Plattform in BACK_MARKET_HOST und deinen Hauptmarkt in BACK_MARKET_MARKET (zum Beispiel fr-fr für Europa, en-us für die Vereinigten Staaten, ja-jp für Asien-Pazifik). Der Markt muss zur Plattform gehören.

Jeder Aufruf trägt den Markt in Accept-Language und den User-Agent BM-AnythingMCP-Connector, den Back Market benötigt. Tools mit einem market-Argument können für einen Aufruf einen anderen Markt derselben Plattform betrachten.

Wo anfangen: back_market_list_orders mit Status 1 zeigt bezahlte Bestellungen, deren Positionen du annehmen musst, Status 3 die Bestellungen zum Versand. back_market_list_listings zeigt deine Angebote; back_market_list_backbox zeigt, welche davon die Backbox halten.

Bestellworkflow: Eine Bestellung erreicht den Status 1, sobald die Zahlung validiert ist (versende niemals die Status 0, 8 oder 10). Akzeptiere jede Position mit back_market_accept_order_line (Positionsstatus 1 auf 2); die Bestellung wechselt dann zu Status 3. Versende mit back_market_ship_order und einer Tracking-Nummer (alle Positionen gehen in ein Paket, Bestellstatus 9). back_market_get_order zeigt die Positionsstatus. back_market_set_order_line_identifiers speichert die IMEI oder Seriennummer des Geräts; sie kann danach nicht mehr korrigiert werden. back_market_cancel_order_line und back_market_refund_order_line sind standardmäßig deaktiviert: beide erstatten dem Kunden und können nicht rückgängig gemacht werden, und Stornierungen belasten die Backbox.

Angebote: Ein Angebot deckt alle Märkte der Plattform ab. Die Menge ist geteilt; Preis, Kommentar und Garantie sind pro Markt. back_market_get_listing findet ein Angebot nach SKU; back_market_update_listing ändert Preis oder Lagerbestand in Echtzeit (Menge 0 nimmt es offline). back_market_import_listings (deaktiviert) sendet eine CSV für viele Angebote auf einmal und antwortet mit einer Aufgaben-ID für back_market_get_task. back_market_get_competitors zeigt den Preis, der benötigt wird, um die Backbox pro Markt zu gewinnen. back_market_get_category_tree und back_market_get_category_branch geben die Kategorien und die Attribute an, die ein neues Produkt benötigt.

Kundenservice: back_market_list_care_folders und back_market_get_care_folder lesen Nachverkaufsfälle mit ihren Nachrichten; back_market_send_care_message antwortet dem Kunden. back_market_create_care_refund ist standardmäßig deaktiviert.

BackShip und BuyBack: back_market_list_deliveries und back_market_list_returns geben nur Daten für Verkäufer zurück, die die BackShip-Labels von Back Market verwenden. back_market_list_buyback_orders und back_market_get_buyback_order lesen Trade-In-Bestellungen; die Validierung oder Ablehnung einer Bestellung entscheidet, was der Kunde bezahlt und ist nicht enthalten.

Formate: Preise sind Dezimalzahlen mit Steuer, in der Währung des Marktes (160.99). Bestell-IDs und Positions-IDs sind Ganzzahlen; Angebots-IDs sind UUIDs (die numerische listing_id ist veraltet). Daten sind im RFC 3339-Format; die Filter für den Kundenservice verwenden YYYY-MM-DD-hh-mm. Listen antworten mit count, next, previous und results; next ist null auf der letzten Seite.

Limits: Mehr als 200 Aufrufe in 10 Sekunden werden für 10 Sekunden blockiert (Katalogaufrufe: 20 in 10 Sekunden), mit einem 429. Angebotsaktualisierungen sind auf etwa 2.000 SKU-Positionen pro Stunde begrenzt. Kundenservice-Anfragen haben tägliche Limits (Ordnerliste 4.000 pro Tag, Rückerstattungen 500 pro Tag).

403-Antworten: Back Market sitzt hinter Cloudflare. Ein 403 mit einer HTML-Seite oder dem Code bot-need-challenge bedeutet, dass die Firewall den Anrufer blockiert hat, nicht dass das Token falsch ist: sende den Wert cf-ray der Antwort an deinen Kontakt bei Back Market. Ein falsches oder fehlendes Token antwortet ebenfalls mit 403 oder 401, mit einem JSON-Fehler.

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 Gemini 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 Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal) — anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Back Market-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Welche Back Market-Bestellungen haben Positionen, die auf meine Annahme warten?"
• "Welche meiner Angebote haben die Backbox verloren, und welcher Preis würde sie zurückgewinnen?"
• "Setze den Lagerbestand meines aufbereiteten iPhone 13 128 GB-Angebots auf 12."
• "Versende die Bestellung 41234567 mit Colissimo-Tracking 6A12345678901 und der IMEI jeder Position."
• "Welche Kundenservice-Ordner sind offen, und was fragen die Kunden?"

FAQ

Wo bekomme ich das API-Token? Im Back Market Backoffice deiner Plattform, Optionen, Integrationen. Füge das Token wie gezeigt ein, ohne das Wort Basic, und wähle deine Plattform (Europa, Vereinigte Staaten oder Asien-Pazifik) und den Hauptmarkt. Der API-Zugang erfolgt mit einem Verkäuferkonto, das von Back Market validiert wurde.

Welche Märkte deckt es ab? Jeden Markt der Plattform, auf der dein Konto ist: die europäischen Märkte auf backmarket.fr, die Vereinigten Staaten auf backmarket.com und Japan und Australien auf backmarket.co.jp. Tools mit einem Marktargument können einen anderen Markt derselben Plattform betrachten.

Welche Tools sind standardmäßig deaktiviert? back_market_cancel_order_line, back_market_refund_order_line, back_market_create_care_refund und back_market_import_listings, da sie Kunden erstatten oder Angebote in großen Mengen ersetzen. Schalte sie auf der Connector-Seite nur ein, wenn die KI sie verwenden soll.

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden