noon Marketplace über MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → noon Marketplace klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

noon Marketplace + Cursor

Verkaufe auf noon.com (VAE, Saudi-Arabien, Ägypten) aus einem KI-Agent über die noon Partner API: Lager, Katalog-Content und Produktgruppen, Angebote, Preise, Bestand, FBPI-Bestellungen und Sendungen, Purchase Orders, Retourenabfragen und Massenexporte. Anmeldung per Service Account mit signiertem JWT; Schreibzugriffe auf Preise, Bestand, Produkte und Bestellungen sind bei der Installation ausgeschaltet.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

NOON_KEY_ID, NOON_PRIVATE_KEY, NOON_PROJECT_CODE

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein Verkäuferkonto auf noon.com (VAE, Saudi-Arabien oder Ägypten) mit Zugang zum noon Partner-Portal und einen Service-Account-Schlüssel für die noon Partner API.

1. Melde dich im noon Partner-Portal an und öffne die Access App (oder User & Access > User access), dann API Users in der linken Seitenleiste.
2. Klicke auf Add Service Account, gib einen Anzeigenamen und einen Benutzernamen ein und wähle eine Rolle. Project Viewer reicht für die Lese-Tools; die Schreib-Tools brauchen eine Rolle, die Katalog, Preise, Bestand oder Bestellungen ändern darf (Project Owner erlaubt alles). Du kannst den Schlüssel auf IP-Adressen beschränken und ihm ein Ablaufdatum geben; ohne beides funktioniert er von jeder IP und läuft nie ab. Jeder Partner kann einen Service Account mit bis zu fünf Schlüsseln anlegen.
3. Wenn du auf Add klickst, wird eine .json-Schlüsseldatei heruntergeladen. Sie wird nur einmal angezeigt; geht sie verloren, legst du einen neuen Schlüssel an.
4. Kopiere drei Felder dieser Datei: key_id in NOON_KEY_ID, private_key in NOON_PRIVATE_KEY und project_code in NOON_PROJECT_CODE. Der private Schlüssel ist das ganze PEM, von -----BEGIN PRIVATE KEY----- bis -----END PRIVATE KEY-----; du kannst ihn in einer Zeile einfügen, mit den \n-Sequenzen genau so, wie sie in der Datei stehen.
5. Installiere den Connector und rufe noon_marketplace_whoami auf: Es zeigt den Service Account hinter der Sitzung (User-Code und Benutzername).

So funktioniert die Anmeldung: Es gibt keinen festen API-Key. Für jede Anmeldung signiert der Connector mit deinem privaten Schlüssel ein frisches RS256-JWT (die Key-ID als Subject, die aktuelle Zeit, eine zufällige Token-ID) und schickt es mit deinem Projektcode an den Login-Endpunkt von noon. noon antwortet mit Session-Cookies, die bei jedem Aufruf mitgehen. Eine Sitzung hält 30 Tage; der Connector meldet sich vor ihrem Ende neu an und immer dann, wenn ein Aufruf 401 zurückgibt. Jede Anfrage trägt außerdem den Header X-Project mit deinem Projektcode, den die Content-API von noon verlangt.

Kennungen: partner_sku ist deine eigene SKU, eindeutig über alle deine Produkte; Preise, Bestand und Angebote hängen an ihr. sku_parent (beginnt mit Z) ist die ID, die noon einem Produkt mit all seinen Varianten gibt, und wird für Content und Produktgruppen verwendet. Die noon-SKU (sku, beginnt mit N) und psku_code (beginnt mit P) bezeichnen eine einzelne Variante. warehouse_code liefert noon_marketplace_list_warehouses; FBPI-Bestellungen und Sendungen gehören zu einem Integrationslager. country_code ist ae, sa oder eg in Kleinbuchstaben, und Preise gelten pro SKU und Land, in AED, SAR oder EGP. Bestellungen und Sendungen erkennt man an fbpi_order_nr, mp_item_nr (eine Position einer Bestellung) und deiner eigenen integration_shipment_nr.

Was er liest: den Service Account und deine Lager; jeden Kategoriecode des noon-Katalogs und die Attribute, die eine Kategorie verlangt, samt den Prüfregeln für ihre Werte; den Content eines Produkts mit Vollständigkeit, QC-Status und den Gründen, warum es nicht live ist; Produktgruppen (Varianten, die gemeinsam auf einer Seite erscheinen); die Angebote einer Partner-SKU in jedem Land mit Preis, Bestand, Live-Status und den Problemen, die ein Angebot offline halten; Preise, MSRP (den durchgestrichenen Vergleichspreis) und Aktiv-Status pro SKU und Land; Bestand pro Lager und SKU; FBPI-Bestellungen (aus deinem eigenen Lager erfüllt) mit ihren Positionen, dem Kunden einer Bestellung und ihren Sendungen; Purchase Orders (Einkaufsbestellungen); retournierte Artikel per AWB-Nummer oder Retouren-Barcode; und den Status von Katalog-Importen. Mehrere Lesezugriffe sind POST-Anfragen mit JSON-Body, so ist die API von noon gebaut; sie ändern nichts.

Massenexporte und AWBs: noon_marketplace_list_export_categories listet die Berichtstypen, die du exportieren kannst, noon_marketplace_create_export startet einen Export, und noon_marketplace_get_export_status zeigt, wann die Datei bereitsteht, samt ihrer download_url. noon_marketplace_generate_awbs erzeugt AWB-Nummern (Luftfrachtbriefe) für Pakete, die an den Kurier von noon gehen. Beide ändern keine Daten und bleiben deshalb eingeschaltet.

Bei der Installation ausgeschaltet: noon_marketplace_upsert_product, noon_marketplace_upsert_product_group, noon_marketplace_upsert_prices, noon_marketplace_update_stock, noon_marketplace_mark_items_unavailable, noon_marketplace_create_shipment und noon_marketplace_cancel_shipment. Schreibzugriffe auf Preise, Bestand, Produkte, Bestellungen und Sendungen ändern, was Kunden sehen und kaufen (Live-Preise, verkaufbare Menge, veröffentlichter Content), oder greifen in echte Bestellungen ein, und manche lassen sich nicht rückgängig machen: Als nicht verfügbar markierte Positionen werden für den Kunden storniert, und wer eine Sendung storniert, storniert jede Position darin. Ein Administrator schaltet die ein, die ein Workspace braucht, und zwar in den Tool-Einstellungen des Connectors. Nachdem eine Sendung angelegt ist, wird das Manifest für die Abholung durch noon in Seller Lab abgeschlossen.

Batch-Ergebnisse: Preis-, Bestands- und Produktaufrufe antworten mit 200, auch wenn einzelne Positionen fehlgeschlagen sind. Prüfe deshalb den Status jeder zurückgegebenen Position und schick nur die fehlgeschlagenen erneut. noon_marketplace_update_stock setzt eine absolute Menge und addiert nicht zur aktuellen. In noon_marketplace_upsert_prices behält ein weggelassenes oder als null gesendetes Feld seinen Wert. Ein Produkt, das mit status_id 3 gespeichert wurde, hat Content-Probleme, die noon_marketplace_get_content auflistet.

Limits: Listen-Tools liefern ein next_token, und die KI ruft mit ihm und denselben Filtern erneut auf, bis es leer ist. Rate Limits gelten pro Projekt und Endpunkt, mit einem Hauptfenster und einem kürzeren Burst-Fenster: Die meisten Endpunkte erlauben 1500 Anfragen pro 60 Sekunden, noon_marketplace_list_warehouses 30 pro 60 Sekunden mit einem Burst von 15 pro 30 Sekunden. Ein 429 heißt: so viele Sekunden warten, wie der Header X-Ratelimit-Retry-After angibt. Ein Batch-Aufruf ist besser als viele Einzelaufrufe.

Häufige Fehler: 401 bedeutet, dass Anmeldung oder Sitzung fehlgeschlagen sind: Key-ID und privater Schlüssel aus verschiedenen Schlüsseldateien, ein deaktivierter oder abgelaufener Schlüssel oder eine Serveruhr, die mehr als fünf Minuten von der Uhr von noon abweicht, sodass noon das signierte Token ablehnt. 403 PERMISSION_DENIED bedeutet, dass der Service Account keine Rolle für diesen Aufruf hat; füge im Partner-Portal unter User Access > Manage Role eine hinzu. 400 INVALID_ARGUMENT nennt das Feld und den Grund. NOT_FOUND bei einer Preisposition heißt, dass die SKU in diesem Land noch keinen Preisdatensatz hat; setze also zuerst einen Preis.

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 Cursor 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.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die noon Marketplace-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Prüf den Bestand der Partner-SKUs TS-100-BLK, TS-100-WHT und TS-100-RED in unserem Lager in Dubai und markiere alles unter 10 Stück.“
• „Prüf meine Preise für die SKU TS-100-BLK in den VAE und in Saudi-Arabien: Preis, MSRP, ob jedes Angebot live ist und was ein Angebot offline hält.“
• „Liste die FBPI-Bestellungen von heute in unserem Integrationslager mit Positionen und Status auf und sag mir, welche noch nicht versandt sind.“
• „Zeig mir, welche Berichtstypen ich exportieren kann, starte den, den ich auswähle, und prüf den Status, bis der Download-Link bereitsteht.“
• „Bevor ich eine neue Handyhülle einstelle: Finde den passenden Kategoriecode und zeig mir die Pflichtattribute und welche Attribute Werte auf Englisch und Arabisch brauchen.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja, MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden