In breve
Gestisci il tuo negozio sul marketplace Rue du Commerce tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Francia; accedi con la chiave API del negozio dal tuo back office venditore Rue du Commerce.
Configurazione guidata
Collega Rue du Commerce Marketplace a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Rue du Commerce Marketplace con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Rue du Commerce Marketplace
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Rue du Commerce Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Rue du Commerce Marketplace + Microsoft Copilot
Gestisci il tuo negozio sul marketplace Rue du Commerce tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Francia; accedi con la chiave API del negozio dal tuo back office venditore Rue du Commerce.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
RUE_DU_COMMERCE_API_KEY
Passo 1 — Ottieni le credenziali
Paesi: Francia.
Chi può vendere: Rue du Commerce seleziona i suoi venditori; contattali via e-mail ([email protected]) o tramite il loro modulo per venditori. Il connettore ha bisogno di un account venditore già aperto da Rue du Commerce.
La configurazione richiede circa 5 minuti.
- Accedi al back office venditore di Rue du Commerce:
https://mirakl-web.groupe-rueducommerce.fr/login. - Nel back office apri il tuo indirizzo e-mail (in alto a destra) > Il mio account > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in
RUE_DU_COMMERCE_API_KEY. La chiave viene inviata così com'è nell'intestazioneAuthorization, senzaBearer. Generare una nuova chiave invalida quella vecchia, quindi qualsiasi altro strumento che la utilizza smette di funzionare. - Lascia
RUE_DU_COMMERCE_SHOP_IDvuoto. Solo se il tuo utente gestisce più negozi su Rue du Commerce, impostaRUE_DU_COMMERCE_SHOP_IDall'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato nel dashboard del back office accanto a Identificatore o Shop ID, e restituito comeshop_iddarue_du_commerce_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito. - Installa ed esegui
rue_du_commerce_get_account: restituisce il negozio a cui appartiene la chiave.
Da dove iniziare: rue_du_commerce_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza rue_du_commerce_list_orders con order_state_codes=WAITING_ACCEPTANCE, rue_du_commerce_list_offers per prezzi e stock e rue_du_commerce_list_threads per messaggi in attesa di risposta.
Prodotti e offerte concorrenti: rue_du_commerce_get_products cerca i prodotti nel catalogo di Rue du Commerce per EAN o un altro riferimento e restituisce il SKU del prodotto del marketplace; rue_du_commerce_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, partendo dal miglior prezzo, con circa 5 chiamate al minuto.
Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. rue_du_commerce_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi rue_du_commerce_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da rue_du_commerce_list_carriers) e rue_du_commerce_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa rue_du_commerce_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiana e has_incident=true per incidenti aperti; rue_du_commerce_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (bolle di consegna, etichette, fatture clienti) sono elencati da rue_du_commerce_list_order_documents.
Scritture: conferma prima. rue_du_commerce_accept_order, rue_du_commerce_update_tracking, rue_du_commerce_ship_order, rue_du_commerce_resolve_incident, rue_du_commerce_accept_return, rue_du_commerce_receive_return, rue_du_commerce_update_offers, rue_du_commerce_reply_thread, rue_du_commerce_create_order_thread e rue_du_commerce_import_products agiscono sul marketplace live. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e nuovo prezzo o stock, il testo del messaggio e i destinatari) e aspetta un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessun strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. rue_du_commerce_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.
Aggiornamento delle offerte (prezzi e stock): rue_du_commerce_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, un discount o description mancante viene eliminato. Leggi sempre prima l'offerta (rue_du_commerce_get_offer o rue_du_commerce_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e qualsiasi offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con rue_du_commerce_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da rue_du_commerce_list_offer_conditions, i codici di classe logistica da rue_du_commerce_list_logistic_classes.
Importazioni di file: rue_du_commerce_import_products (P41) e rue_du_commerce_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato richiesto da Rue du Commerce; il connettore lo scarica e lo carica su Rue du Commerce. Tracciali con rue_du_commerce_list_product_imports / rue_du_commerce_get_product_import e rue_du_commerce_list_offer_imports / rue_du_commerce_get_offer_import.
Resi: rue_du_commerce_list_returns (RT11) elenca le richieste di reso. Dove Rue du Commerce lascia decidere al negozio, rue_du_commerce_accept_return accetta o rifiuta una richiesta in WAITING_ACCEPTANCE e rue_du_commerce_receive_return conferma l'arrivo della merce. I rimborsi rimangono nel back office.
Messaggi: rue_du_commerce_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), rue_du_commerce_get_thread legge una conversazione con i suoi messaggi, rue_du_commerce_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Rue du Commerce) e rue_du_commerce_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da rue_du_commerce_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).
Denaro: rue_du_commerce_list_invoices (IV01) elenca i documenti contabili che Rue du Commerce emette al negozio e rue_du_commerce_list_transactions (TL02) le righe delle transazioni (vendite, commissioni, rimborsi, pagamenti). Se Rue du Commerce utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; utilizza rue_du_commerce_list_document_requests (DR11) e le transazioni in seguito.
Liste di riferimento: rue_du_commerce_list_channels (siti nazionali), rue_du_commerce_list_carriers, rue_du_commerce_list_shipping_zones, rue_du_commerce_list_shipping_methods e rue_du_commerce_list_logistic_classes cambiano raramente; leggili una volta per conversazione.
Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.
Date sono ISO 8601, ad esempio 2026-10-01T00:00:00Z; le risposte sono in UTC.
Limiti di frequenza: Ogni API ha il proprio limite e Rue du Commerce può stringerli. L'elenco di offerte e ordini è destinato all'uso interattivo, le importazioni di prodotti e offerte al massimo ogni 15 minuti, rue_du_commerce_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un ciclo.
Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio, 400 un parametro errato o un ordine in uno stato errato (il messaggio lo indica, ad esempio ORDER_INVALID_STATE).
Passo 2 — Installa l'adattatore
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
Passo 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 mostraYOUR_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.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - 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.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Rue du Commerce Marketplace. - 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.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
rue_du_commerce_get_account | Legge il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto… |
rue_du_commerce_list_orders | Elenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad esempio WAITING_ACCEPTANCE per… |
rue_du_commerce_list_offers | Elenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in stock, condizione, tempo di consegna e se… |
rue_du_commerce_get_offer | Legge un'offerta intera per il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personalizzato… |
rue_du_commerce_list_offer_conditions | Elenca le condizioni delle offerte (OF61) accettate dal marketplace, ad esempio nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte |
rue_du_commerce_list_offer_imports | Elenca le importazioni e aggiornamenti delle offerte (OF04), da file e da rue_du_commerce_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED)… |
rue_du_commerce_get_offer_import | Legge lo stato di un'importazione di offerta o aggiornamento offerta (OF02) per il suo import_id, come restituito da rue_du_commerce_update_offers o… |
rue_du_commerce_export_offers | Avvia un'esportazione di tutte le offerte del negozio come file (OF52), il modo per leggere l'intero catalogo (ogni SKU con prezzo e stock) invece di scorrere rue_du_commerce_list_offers pagina per pagina |
rue_du_commerce_get_offer_export_status | Stato di un'esportazione di offerte avviata con rue_du_commerce_export_offers (OF53): PENDING, COMPLETED o FAILED e, una volta completata, gli URL dei file |
rue_du_commerce_get_offer_export_file | Leggi un file di un'esportazione di offerte completata (OF54): le offerte con SKU, prodotto, quantità, prezzi e gli altri campi esportati, in JSON o CSV |
rue_du_commerce_list_product_imports | Elenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi di trasformazione e i… |
rue_du_commerce_get_product_import | Legge lo stato di un'importazione di prodotto (P42) per il suo import_id: stato di importazione, motivo, conteggi di trasformazione e dettagli di integrazione… |
rue_du_commerce_get_products | Cerca prodotti nel catalogo del marketplace per i loro identificatori (P31), ad esempio EAN, e ottieni il SKU del prodotto del marketplace, titolo e categoria.… |
rue_du_commerce_list_product_offers | Elenca le offerte di ogni negozio per i prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids… |
rue_du_commerce_list_threads | Elenca i thread di messaggi (M11) con clienti e Rue du Commerce: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando… |
rue_du_commerce_get_thread | Legge un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o l'offerta collegata |
rue_du_commerce_list_returns | Elenca le richieste di reso (RT11) con il loro stato, righe di reso, motivo, RMA, tracciamento e l'ordine collegato. Filtra per stato, ordine o data.… |
rue_du_commerce_list_reasons | Elenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può… |
rue_du_commerce_list_carriers | Elenca i corrieri conosciuti dal marketplace (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in… |
rue_du_commerce_list_invoices | Elenca i documenti contabili che Rue du Commerce emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza… |
rue_du_commerce_list_transactions | Elenca le righe delle transazioni del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo… |
rue_du_commerce_list_document_requests | Elenca le richieste di documenti contabili (DR11), utilizzate quando Rue du Commerce esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Rue du… |
rue_du_commerce_list_order_documents | Elenca i documenti allegati a uno o più ordini (OR72): bolle di consegna, etichette di spedizione, fatture clienti e altri file, con id, file… |
rue_du_commerce_list_channels | Elenca i canali di vendita del marketplace (CH11), di solito uno per sito nazionale, con codice ed etichetta. Usa i codici come channel_codes in… |
rue_du_commerce_list_shipping_zones | Elenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad esempio Francia continentale o Corsica. Cambiano raramente: chiamalo… |
rue_du_commerce_list_shipping_methods | Elenca i metodi di spedizione attivi del marketplace (SH12), ad esempio standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento… |
rue_du_commerce_list_logistic_classes | Elenca le classi logistiche del marketplace (SH31), le fasce di dimensione o peso che decidono i prezzi di spedizione, con codice ed etichetta. Usa il codice come… |
rue_du_commerce_accept_order | Accetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla… |
rue_du_commerce_update_tracking | Imposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da rue_du_commerce_list_carriers, o carrier_name con… |
rue_du_commerce_ship_order | Conferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene avvisato. Imposta prima il tracciamento con… |
rue_du_commerce_update_offers | Crea o aggiorna offerte, inclusi prezzo e stock (OF24). Sostituisce completamente ogni offerta: ogni campo lasciato fuori viene ripristinato (una mancante… |
rue_du_commerce_reply_thread | Rispondi in un thread di messaggi (M12) al cliente o a Rue du Commerce. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra il… |
rue_du_commerce_create_order_thread | Avvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Rue du Commerce o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente… |
rue_du_commerce_resolve_incident | Segna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta risolto il problema del cliente. reason_code deve essere un INCIDENT_CLOSE… |
rue_du_commerce_accept_return | Accetta o rifiuta una richiesta di reso in WAITING_ACCEPTANCE (RT21). Solo quando Rue du Commerce gestisce i resi nel back office venditore e… |
rue_du_commerce_receive_return | Conferma che la merce di un reso accettato è arrivata nel tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace live… |
rue_du_commerce_import_products | Invia un file di prodotto al marketplace (P41) per creare o arricchire prodotti nel suo catalogo. file_url è l'indirizzo di un CSV, XLSX o XML… |
rue_du_commerce_import_offers | Importa un file di offerte (OF01) per creare, aggiornare o eliminare offerte in blocco. La modalità REPLACE elimina ogni offerta che non è nel file, e… |
Esempi di prompt
- "Quali ordini di Rue du Commerce sono in attesa della mia accettazione?"
- "Chi ha il miglior prezzo per l'SSD con EAN 8806094215038 su Rue du Commerce, e dove si colloca il mio?"
- "Imposta lo stock del mio mouse da gioco SKU GM-RGB-16K a 40."
- "Mostra le fatture che Rue du Commerce mi ha emesso a ottobre."
- "Aggiungi il tracciamento Chronopost XY123456789FR all'ordine 7712004-A e segnalo come spedito."
FAQ
Dove posso ottenere la chiave API di Rue du Commerce? Nel back office venditore di Rue du Commerce: il tuo indirizzo e-mail (in alto a destra), Il mio account, Chiave API, poi Genera una nuova chiave (o copia la chiave esistente). Generare una nuova chiave invalida quella vecchia. Se il tuo utente ha più di un negozio, imposta RUE_DU_COMMERCE_SHOP_ID; altrimenti viene utilizzato il tuo negozio predefinito.
Chi può vendere su Rue du Commerce e quali paesi copre? Rue du Commerce seleziona i suoi venditori; contattali via e-mail ([email protected]) o tramite il loro modulo per venditori. Il connettore copre la Francia.
Può annullare ordini, rimborsare o eliminare offerte? Nessuno strumento rimborsa o annulla un ordine; fallo nel back office di Rue du Commerce. Rifiutare una riga durante l'accettazione di un ordine la annulla definitivamente, quindi l'AI ti mostra ogni scrittura e aspetta un sì. rue_du_commerce_import_offers è installato spento, perché la sua modalità REPLACE elimina ogni offerta mancante dal file; accendilo nella pagina del connettore solo se l'AI dovrebbe usarlo.
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
Questa guida ti è stata utile?