ABOUT YOU MCP mit Gemini CLI verbinden

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

ABOUT YOU + Gemini

ABOUT YOU Seller Center API für Marktplatzpartner: Bestellungen, Versand mit Sendungsverfolgung, Rechnungen und Lieferscheine, Produkte mit Genehmigungsstatus, Lagerbestand, Preise, Kategorien und Attribute, Marken und Berichte. API-Schlüssel.

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:

ABOUT_YOU_API_KEY

Schritt 1 — Zugangsdaten erhalten

Die Einrichtung dauert etwa 2 Minuten.

1. Melde dich im ABOUT YOU Seller Center als Admin-Benutzer an. Mitgliedsbenutzer können keine API-Schlüssel erstellen.
2. Öffne Einstellungen, dann API-Schlüssel, und klicke auf + Hinzufügen.
3. Gib ein Label ein, optional ein Ablaufdatum, und klicke auf Schlüssel hinzufügen.
4. Kopiere den Schlüssel sofort in ABOUT_YOU_API_KEY: Das Seller Center zeigt ihn nur dieses eine Mal an.

Der Schlüssel wird im Header X-API-Key gesendet. Für Testdaten erstelle eine Sandbox unter Einstellungen, Sandbox, Sandbox erstellen: Sie hat ihren eigenen API-Schlüssel unter derselben Adresse, Produkte gehen dort ohne Genehmigung live, und Testbestellungen kommen über die Schaltfläche Bestellungen empfangen auf der Bestellseite.

Wo anfangen: about_you_list_orders mit order_status open zeigt, was auf den Versand wartet. about_you_list_products zeigt deinen Katalog mit Lagerbestand und Preisen. about_you_list_countries ist der günstige Aufruf, der beweist, dass der Schlüssel funktioniert.

Bestellungen und Versand: about_you_list_orders gibt die Artikel jeder Bestellung mit ihrer id zurück; die Versand-, Stornierungs- und Rücksendetools verwenden diese Artikel-IDs, niemals SKUs. Versende mit about_you_ship_order_items (Carrier-Schlüssel von about_you_list_carriers, Sendungsverfolgungsschlüssel und Rückverfolgungsschlüssel sind alle erforderlich). about_you_get_delivery_document gibt den Lieferschein einer Dropshipping-Bestellung zurück und about_you_get_order_invoices die Kundenrechnungen, beide als Dateien. about_you_cancel_order_items und about_you_return_order_items sind standardmäßig deaktiviert: Ein storniertes Element kann später nicht mehr versendet werden, und das Markieren eines Artikels als zurückgegeben führt dazu, dass ABOUT YOU dem Kunden automatisch das Geld zurückerstattet. Überprüfe eine Rücksendung innerhalb von 24 Stunden nach Erhalt; registriere keine, die du ablehnst.

Asynchrone Schreibvorgänge: Jeder Schreibvorgang antwortet sofort mit einer batchRequestId und wird im Hintergrund verarbeitet. Lies das Ergebnis mit about_you_get_batch_result (wähle den passenden result_type) bis der Status abgeschlossen oder fehlgeschlagen ist; jedes Element enthält Erfolge und Fehler. Ergebnisse werden 7 Tage aufbewahrt. Dasselbe Payload, das innerhalb kurzer Zeit zweimal gesendet wird, gibt die gleiche Batch-ID zurück und wird nicht erneut verarbeitet.

Produkte: Eine Zeile ist eine SKU (eine Größe einer Farbe eines Stils). Erstelle oder ändere sie mit about_you_upsert_products unter Verwendung von IDs aus about_you_list_categories, about_you_list_category_attribute_groups und about_you_list_brands, und sende dann den Stil zur Genehmigung mit about_you_publish_product. Status: Entwurf, ausstehende Genehmigung (gesperrt, während ABOUT YOU überprüft), abgelehnt (Gründe in about_you_list_rejected_products), ausstehend aktiv, aktiv, inaktiv und Problem (ein aktives Produkt, das ungültig wurde; es wird wieder aktiv, sobald es behoben ist). about_you_update_product_status (auch Entwurf und inaktiv) und about_you_delete_product sind standardmäßig deaktiviert.

Lagerbestand und Preise: about_you_update_stock und about_you_update_prices akzeptieren bis zu 1000 Zeilen pro Aufruf und werden immer angewendet, im Gegensatz zu Lagerbestand oder Preisen, die über das Produkt-Update gesendet werden. Produktpreise sind Dezimalzahlen in der Währung des Landes (49,99), während Bestellbeträge ganze Zahlen in der kleinsten Einheit sind (4999 = 49,99 EUR). Sende currency mit jedem Preis.

Berichte und Webhooks: about_you_list_reports und about_you_download_report (Lager- und Bewegungsberichte für Waren in ABOUT YOU-Lagern, DAC7), about_you_list_webhooks (nur lesend).

Paging: Listen geben items und pagination zurück. Bestellungen und Produkte sollten mit cursor = pagination.next_cursor paginiert werden; der Seitenparameter funktioniert dort weiterhin, ist aber veraltet. Kleinere Listen verwenden Seite und per_page (maximal 100).

Erfüllungstypen: dropshipping bedeutet, dass du versendest; fulfillment_by_marketplace bedeutet, dass ABOUT YOU aus seinem eigenen Lager versendet (FbAY), sodass es nichts zu versenden gibt und kein Lieferdokument für diese Bestellungen vorhanden ist.

Rate Limits (pro Endpunkt und pro Schlüssel): Bestellungen 100 pro Minute, Versand 200, Stornierung und Rücksendung 50, Lagerbestand 1000, Preise 200, Produktliste 1000, Produkt-Update und Status 100, Batch-Ergebnisse 200, Rechnungen und Berichte 10. Die Header X-RateLimit-Limit und X-RateLimit-Remaining zeigen das Budget an; ein 429 bedeutet, dass du bis zur nächsten Minute warten musst.

Fehler: 400 und 401 antworten mit einer JSON message. Ein 404 bei einem Dokument bedeutet, dass die Bestellung keine solche Datei hat. Diese API hat keinen Auszahlungs- oder Zahlungsaufruf; die einzige Aktion, die zu einer Rückerstattung führt, ist die Registrierung einer Rücksendung, die deaktiviert ist.

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 ABOUT YOU-Tools aufrufen.

Verfügbare Tools

Beispielaufforderungen

• "Welche ABOUT YOU-Bestellungen sind offen und warten auf den Versand?"
• "Welche meiner Produkte wurden von ABOUT YOU abgelehnt und warum?"
• "Setze den Lagerbestand von SKU AY-TSHIRT-WHT-M auf 50."
• "Versende die Artikel der Bestellung 123456789 mit DHL, Sendungsverfolgung 003404341612345678 und Rückverfolgung 003404341698765432."
• "Lade den Verkaufsbericht des letzten Monats herunter."

FAQ

Wo bekomme ich den API-Schlüssel? Im ABOUT YOU Seller Center, angemeldet als Admin-Benutzer: Einstellungen, API-Schlüssel, + Hinzufügen. Der Schlüssel wird nur einmal angezeigt. Eine Sandbox unter Einstellungen hat ihren eigenen Schlüssel für Testbestellungen.

Was deckt es ab? Bestellungen und deren Artikel, Versand mit Sendungsverfolgung, Kundenrechnungen und Lieferscheine, Produkte mit ihrem Genehmigungsstatus, Lagerbestand, Preise, Kategorien, Attribute, Marken, Batch-Ergebnisse, Berichte und Webhooks.

Welche Tools sind standardmäßig deaktiviert? about_you_cancel_order_items, about_you_return_order_items, about_you_update_product_status und about_you_delete_product, da ein storniertes Element später nicht mehr versendet werden kann und das Markieren eines Artikels als zurückgegeben dazu führt, dass ABOUT YOU dem Kunden automatisch das Geld zurückerstattet. 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