Come collegare noon Marketplace a Claude via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → noon Marketplace, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

noon Marketplace + Claude

Vendi su noon.com (Emirati Arabi Uniti, Arabia Saudita, Egitto) da un agente AI tramite la noon Partner API: magazzini, contenuti del catalogo e gruppi di prodotti, offerte, prezzi, stock, ordini e spedizioni FBPI, ordini di acquisto, ricerca dei resi ed export massivi. Accesso con service account e JWT firmato; le scritture su prezzi, stock, prodotti e ordini sono disattivate all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

NOON_KEY_ID, NOON_PRIVATE_KEY, NOON_PROJECT_CODE

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un account venditore su noon.com (Emirati Arabi Uniti, Arabia Saudita o Egitto) con accesso al portale noon Partner, e una chiave di service account per la noon Partner API.

1. Accedi al portale noon Partner e apri l'Access App (oppure User & Access > User access), poi API Users nella barra laterale sinistra.
2. Clicca Add Service Account, inserisci un nome visualizzato e uno username e scegli un ruolo. Project Viewer basta per i tool di lettura; i tool di scrittura richiedono un ruolo che possa modificare catalogo, prezzi, stock o ordini (Project Owner concede tutto). Puoi limitare la chiave a determinati indirizzi IP e darle una scadenza; senza, funziona da qualsiasi IP e non scade mai. Ogni partner può creare un solo service account con al massimo cinque chiavi.
3. Quando clicchi Add, viene scaricato un file di chiave .json. Viene mostrato una sola volta; se lo perdi, crea una nuova chiave.
4. Copia tre campi di quel file: key_id in NOON_KEY_ID, private_key in NOON_PRIVATE_KEY e project_code in NOON_PROJECT_CODE. La chiave privata è l'intero PEM, da -----BEGIN PRIVATE KEY----- a -----END PRIVATE KEY-----; puoi incollarla su una sola riga, con le sequenze \n esattamente come compaiono nel file.
5. Installa il connettore ed esegui noon_marketplace_whoami: mostra il service account dietro la sessione (user code e username).

Come funziona l'accesso: non esiste una API key statica. A ogni login il connettore firma con la tua chiave privata un nuovo JWT RS256 (l'id della chiave come subject, l'ora attuale, un id casuale del token) e lo invia con il tuo project code all'endpoint di login di noon. noon risponde con cookie di sessione, che accompagnano ogni chiamata. Una sessione dura 30 giorni; il connettore rifà il login prima che scada e ogni volta che una chiamata restituisce 401. Ogni richiesta porta anche l'header X-Project con il tuo project code, richiesto dalla content API di noon.

Identificativi: partner_sku è il tuo SKU, univoco su tutti i tuoi prodotti; prezzi, stock e offerte fanno riferimento a esso. sku_parent (inizia con Z) è l'id noon di un prodotto con tutte le sue varianti, usato per i contenuti e i gruppi di prodotti. Lo SKU noon (sku, inizia con N) e psku_code (inizia con P) identificano una singola variante. warehouse_code arriva da noon_marketplace_list_warehouses; ordini e spedizioni FBPI appartengono a un magazzino di integrazione. country_code è ae, sa o eg in minuscolo, e i prezzi sono per SKU e paese, in AED, SAR o EGP. Ordini e spedizioni si identificano con fbpi_order_nr, mp_item_nr (una riga di un ordine) e il tuo integration_shipment_nr.

Cosa legge: il service account e i tuoi magazzini; tutti i codici di categoria del catalogo noon e gli attributi che una categoria richiede, con le regole di validazione dei valori; il contenuto di un prodotto con completezza, stato QC e i motivi per cui non è online; i gruppi di prodotti (varianti mostrate insieme su una pagina); le offerte di un partner SKU in ogni paese con prezzo, stock, stato online e i problemi che tengono un'offerta offline; prezzi, MSRP (il prezzo di riferimento barrato) e stato attivo per SKU e paese; lo stock per magazzino e SKU; gli ordini FBPI (evasi dal tuo magazzino) con le loro righe, il cliente di un ordine e le sue spedizioni; gli ordini di acquisto; gli articoli resi tramite numero AWB o barcode di reso; e lo stato degli import del catalogo. Diverse letture sono richieste POST con un body JSON, perché l'API di noon funziona così; non modificano nulla.

Export massivi e AWB: noon_marketplace_list_export_categories elenca i tipi di report che puoi esportare, noon_marketplace_create_export ne avvia uno e noon_marketplace_get_export_status mostra quando il file è pronto, con il suo download_url. noon_marketplace_generate_awbs genera numeri AWB (lettere di vettura aerea) per i pacchi affidati al corriere di noon. Nessuno dei due modifica dati, quindi restano attivi.

Disattivati all'installazione: 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 e noon_marketplace_cancel_shipment. Le scritture su prezzi, stock, prodotti, ordini e spedizioni cambiano ciò che i clienti vedono e comprano (prezzi online, quantità vendibile, contenuti pubblicati) o agiscono su ordini reali, e alcune non si possono annullare: segnare articoli come non disponibili li annulla per il cliente, e annullare una spedizione annulla ogni articolo che contiene. Un amministratore attiva quelli che servono a un workspace nelle impostazioni dei tool del connettore. Dopo aver creato una spedizione, il manifest per il ritiro da parte di noon si completa in Seller Lab.

Risultati batch: le chiamate su prezzi, stock e prodotti rispondono 200 anche quando alcuni elementi non sono andati a buon fine, quindi controlla lo stato di ogni elemento restituito e reinvia solo quelli falliti. noon_marketplace_update_stock imposta una quantità assoluta, non la somma a quella attuale. In noon_marketplace_upsert_prices, un campo omesso o inviato come null mantiene il suo valore. Un prodotto salvato con status_id 3 ha problemi di contenuto, che noon_marketplace_get_content elenca.

Limiti: i tool di elenco restituiscono un next_token, e l'AI richiama con quel token e gli stessi filtri finché è vuoto. I rate limit valgono per progetto ed endpoint, con una finestra principale e una finestra di burst più breve: la maggior parte degli endpoint consente 1500 richieste ogni 60 secondi, noon_marketplace_list_warehouses 30 ogni 60 secondi con un burst di 15 ogni 30 secondi. Un 429 significa attendere i secondi indicati nell'header X-Ratelimit-Retry-After; una chiamata batch è meglio di tante chiamate su singoli elementi.

Errori comuni: 401 significa che il login o la sessione non sono riusciti: id della chiave e chiave privata presi da file di chiave diversi, una chiave disattivata o scaduta, oppure un orologio del server sfasato di più di cinque minuti rispetto a quello di noon, che quindi rifiuta il token firmato. 403 PERMISSION_DENIED significa che il service account non ha un ruolo per quella chiamata; aggiungine uno in User Access > Manage Role nel portale Partner. 400 INVALID_ARGUMENT indica il campo e il motivo. NOT_FOUND su un elemento di prezzo significa che lo SKU non ha ancora un record di prezzo in quel paese, quindi imposta prima un prezzo.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Claude

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Percorso consigliato: funziona su claude.ai web senza toccare alcun file di configurazione.

1. In Claude apri Customize → Connectors.
2. Clicca + e poi Add custom connector.
3. Inserisci un nome, ad esempio noon Marketplace, e l'URL del server MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, poi clicca Add.
4. Clicca Connect e accedi ad AnythingMCP (OAuth) per consentire l'accesso.

Tutti i tool sotto compaiono nella tua chat: inizia a scrivere prompt.

Tool disponibili

Esempi di prompt

• "Controlla lo stock dei partner SKU TS-100-BLK, TS-100-WHT e TS-100-RED nel nostro magazzino di Dubai e segnalami quelli sotto le 10 unità."
• "Rivedi i miei prezzi per lo SKU TS-100-BLK negli Emirati e in Arabia Saudita: prezzo, MSRP, se ogni offerta è online e cosa tiene offline un'offerta."
• "Elenca gli ordini FBPI di oggi nel nostro magazzino di integrazione con righe e stato, e dimmi quali non sono ancora stati spediti."
• "Mostrami quali tipi di report posso esportare, avvia quello che scelgo e controllane lo stato finché il link di download è pronto."
• "Prima di mettere in vendita una nuova cover per smartphone, trova il codice di categoria giusto e mostrami gli attributi obbligatori e quali richiedono valori in inglese e in arabo."

FAQ

Funziona con Claude Code come con Claude Desktop? Sì, punta entrambi a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Prossimi passi

• Landing del connettore
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot