Collegare ABOUT YOU MCP a ChatGPT

💡 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 + ChatGPT

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 ChatGPT

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.

ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.

1. Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
2. Inserisci un nome, ad esempio Name: ABOUT YOU.
3. In Connection inserisci come Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID e lascia Authentication su OAuth.
4. Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
5. Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.

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.

Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.

Prossimi passi

• Pagina di atterraggio del connettore
• Collegati a Claude