Collegare ABOUT YOU MCP a Meta Muse

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → ABOUT YOU, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

ABOUT YOU + Meta Muse

API del Seller Center di ABOUT YOU per i partner del marketplace: ordini, spedizioni con tracciamento, fatture e documenti di imballaggio, prodotti con stato di approvazione, stock, prezzi, categorie e attributi, marchi e report. Chiave API.

Requisiti

Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:

ABOUT_YOU_API_KEY

Passo 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti.

1. Accedi al Seller Center di ABOUT YOU come utente Admin. Gli utenti membri non possono creare chiavi API.
2. Apri Impostazioni, poi Chiavi API, e clicca su + Aggiungi.
3. Inserisci un'etichetta, opzionalmente una data di scadenza, e clicca su Aggiungi Chiave.
4. Copia immediatamente la chiave in ABOUT_YOU_API_KEY: il Seller Center la mostra solo questa volta.

La chiave viene inviata nell'intestazione X-API-Key. Per i dati di test, crea un sandbox sotto Impostazioni, Sandbox, Crea Sandbox: ha la sua chiave API sullo stesso indirizzo, i prodotti vengono pubblicati lì senza approvazione, e gli ordini di test provengono dal pulsante Ricevi Ordini nella pagina Ordini.

Dove iniziare: about_you_list_orders con order_status aperto mostra cosa è in attesa di essere spedito. about_you_list_products mostra il tuo catalogo con stock e prezzi. about_you_list_countries è la chiamata economica che prova che la chiave funziona.

Ordini e spedizioni: about_you_list_orders restituisce gli articoli di ogni ordine con il loro id; gli strumenti di spedizione, cancellazione e restituzione prendono questi id degli articoli, mai gli SKU. Spedisci con about_you_ship_order_items (chiave del corriere da about_you_list_carriers, chiave di tracciamento della spedizione e chiave di tracciamento della restituzione sono tutte richieste). about_you_get_delivery_document restituisce il documento di imballaggio di un ordine dropshipping e about_you_get_order_invoices le fatture dei clienti, entrambi come file. about_you_cancel_order_items e about_you_return_order_items sono installati disattivati: un articolo cancellato non può essere spedito in seguito, e contrassegnare un articolo come restituito fa sì che ABOUT YOU rimborsi automaticamente il cliente. Controlla una restituzione entro 24 ore dalla ricezione; non registrare una restituzione che rifiuti.

Scritture asincrone: ogni scrittura risponde immediatamente con un batchRequestId ed è elaborata in background. Leggi il risultato con about_you_get_batch_result (scegli il result_type corrispondente) fino a quando lo stato è completato o fallito; ogni articolo riporta successi ed errori. I risultati vengono conservati per 7 giorni. Lo stesso payload inviato due volte in breve tempo restituisce lo stesso id batch e non viene elaborato nuovamente.

Prodotti: una riga è un SKU (una taglia di un colore di uno stile). Crea o modifica i prodotti con about_you_upsert_products utilizzando gli id da about_you_list_categories, about_you_list_category_attribute_groups e about_you_list_brands, poi invia lo stile per approvazione con about_you_publish_product. Stati: bozza, in attesa di approvazione (bloccato mentre ABOUT YOU esamina), rifiutato (motivi in about_you_list_rejected_products), in attesa attivo, attivo, inattivo e problema (un prodotto attivo che è diventato non valido; torna attivo una volta risolto). about_you_update_product_status (anche bozza e inattivo) e about_you_delete_product sono installati disattivati.

Stock e prezzi: about_you_update_stock e about_you_update_prices accettano fino a 1000 righe per chiamata e vengono sempre applicati, a differenza dello stock o dei prezzi inviati tramite l'upsert dei prodotti. I prezzi dei prodotti sono numeri decimali nella valuta del paese (49.99), mentre gli importi degli ordini sono interi nella più piccola unità (4999 = 49.99 EUR). Invia currency con ogni prezzo.

Report e webhook: about_you_list_reports e about_you_download_report (report di stock e movimento per beni nei magazzini di ABOUT YOU, DAC7), about_you_list_webhooks (solo lettura).

Paging: le liste restituiscono items e pagination. Gli ordini e i prodotti dovrebbero essere paginati con cursor = pagination.next_cursor; il parametro page funziona ancora lì ma è deprecato. Liste più piccole usano page e per_page (max 100).

Tipi di adempimento: dropshipping significa che tu spedisci; fulfillment_by_marketplace significa che ABOUT YOU spedisce dal proprio magazzino (FbAY), quindi non c'è nulla da spedire e nessun documento di consegna per quegli ordini.

Limiti di frequenza (per endpoint e per chiave): ordini 100 al minuto, spedizione 200, cancellazione e restituzione 50, stock 1000, prezzi 200, lista prodotti 1000, upsert prodotto e stato 100, risultati batch 200, fatture e report 10. Le intestazioni X-RateLimit-Limit e X-RateLimit-Remaining mostrano il budget; un 429 significa attendere il minuto successivo.

Errori: 400 e 401 rispondono con un JSON message. Un 404 su un documento significa che l'ordine non ha tale file. Questa API non ha chiamate di pagamento o di rimborso; l'unica azione che porta a un rimborso è registrare una restituzione, che è disattivata.

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 Muse

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.

Muse aggiunge i server MCP remoti come connettori personalizzati e vi accede con OAuth.

1. In Muse apri Settings → Connectors e scegli Add custom connector.
2. Incolla l'URL del server MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse apre la pagina di accesso di AnythingMCP: accedi e approva l'accesso.
4. In una chat, chiedi a Muse qualcosa che richiede i tool di ABOUT YOU.

Puoi configurarlo anche da una chat, sul web, nelle app per iOS e Android o su WhatsApp. Invia a Muse questo messaggio:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

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

Strumenti disponibili

Esempi di prompt

• "Quali ordini di ABOUT YOU sono aperti e in attesa di essere spediti?"
• "Quali dei miei prodotti sono stati rifiutati da ABOUT YOU, e perché?"
• "Imposta lo stock di SKU AY-TSHIRT-WHT-M a 50."
• "Spedisci gli articoli dell'ordine 123456789 con DHL, tracciamento 003404341612345678 e tracciamento restituzione 003404341698765432."
• "Scarica il report delle vendite del mese scorso."

FAQ

Dove posso ottenere la chiave API? Nel Seller Center di ABOUT YOU, accedendo come utente Admin: Impostazioni, Chiavi API, + Aggiungi. La chiave viene mostrata solo una volta. Un sandbox sotto Impostazioni ha la sua chiave per ordini di test.

Cosa copre? Ordini e i loro articoli, spedizioni con tracciamento, fatture dei clienti e documenti di imballaggio, prodotti con il loro stato di approvazione, stock, prezzi, categorie, attributi, marchi, risultati batch, report e webhook.

Quali strumenti sono installati disattivati? about_you_cancel_order_items, about_you_return_order_items, about_you_update_product_status e about_you_delete_product, perché un articolo cancellato non può essere spedito in seguito e contrassegnare un articolo come restituito fa sì che ABOUT YOU rimborsi automaticamente il cliente. Attivali nella pagina del connettore solo se l'AI deve usarli.

Dove è disponibile Muse? Al momento Meta offre Muse negli Stati Uniti e in Canada, sul web, nelle app per iOS e Android e su WhatsApp.

Meta verifica questo connettore? No. Meta non verifica i connettori personalizzati. Muse vede solo i tool che hai attivato per questo server MCP in AnythingMCP, e puoi scollegarlo in qualsiasi momento da Settings → Connectors.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude