Come collegare noon Marketplace a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di noon Marketplace.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse