In breve
Gestisci un account venditore Trendyol da un agente AI: prodotti (elenco Product v2, creazione, contenuti, archivio), stock e prezzi, buybox, risultati dei batch, pacchi di spedizione con stato, tracking, corriere e link della fattura, resi, domande e risposte dei clienti, categorie, attributi e marchi, indirizzi e regolamenti finanziari. Basic auth con API key e secret.
Configurazione guidata
Collega Trendyol a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Trendyol 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 Trendyol
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.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Trendyol, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Trendyol + Microsoft Copilot
Gestisci un account venditore Trendyol da un agente AI: prodotti (elenco Product v2, creazione, contenuti, archivio), stock e prezzi, buybox, risultati dei batch, pacchi di spedizione con stato, tracking, corriere e link della fattura, resi, domande e risposte dei clienti, categorie, attributi e marchi, indirizzi e regolamenti finanziari. Basic auth con API key e secret.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
TRENDYOL_API_HOST, TRENDYOL_SELLER_ID, TRENDYOL_API_KEY, TRENDYOL_API_SECRET
Step 1 — Ottieni le credenziali
- Accedi al pannello venditore di Trendyol (
partner.trendyol.com) con il master user (ruolo admin). Solo il master user vede API key e secret. - Apri il nome del tuo negozio (in alto a destra) → Hesap Bilgilerim → Entegrasyon Bilgileri. Copia il Satıcı ID (un numero) in
TRENDYOL_SELLER_ID, la API Key inTRENDYOL_API_KEYe la API Secret Key inTRENDYOL_API_SECRET. - Imposta
TRENDYOL_API_HOSTsuhttps://apigw.trendyol.comper il tuo negozio live. L'host di stage (test)https://stageapigw.trendyol.comrichiede credenziali di stage separate e risponde solo agli indirizzi IP che Trendyol ha messo in whitelist (gli altri ricevono 503), quindi va bene per un'installazione self-hosted di test, non per il tuo negozio live. - Solo se vendi su uno storefront internazionale di Trendyol, imposta
TRENDYOL_STOREFRONT_CODEsul suo codice paese di due lettere. Per Trendyol Turchia lascialo vuoto. - Installa il connettore ed esegui
trendyol_list_stock_and_prices.
Ordini tramite l'endpoint v2: trendyol_list_orders legge i pacchi di spedizione tramite l'endpoint ordini v2 di Trendyol (/v2/orders), che Trendyol ha reso obbligatorio dal 15 ottobre 2026, quando i vecchi elenchi ordini smettono di funzionare. Arriva al massimo all'ultimo mese, con una finestra di date di al massimo 2 settimane (senza date l'ultima settimana) e solo ai primi 10.000 pacchi di un filtro, quindi per vederne di più l'AI restringe la finestra o filtra per stato.
Prima conferma: aggiornamenti di prezzo e stock, modifiche ai contenuti, stato dei pacchi, numeri di tracking, cambi di corriere, link delle fatture, approvazione dei resi, risposte alle domande, archiviazione e creazione di prodotti agiscono tutti sul tuo negozio live. L'AI ti mostra cosa cambia (barcode con valori vecchi e nuovi, il pacco e le sue righe, il testo della risposta) e aspetta il tuo sì. Le scritture sui prodotti sono asincrone: un esito positivo significa solo che la richiesta è in coda, quindi l'AI controlla il risultato con trendyol_get_batch_request (i risultati restano disponibili per 4 ore).
Disattivati all'installazione: trendyol_delete_products (irreversibile), trendyol_report_unsupplied (annulla righe d'ordine per il cliente, irreversibile) e trendyol_reject_claim_items (chiede a Trendyol di rifiutare articoli resi).
Limiti: al massimo 50 richieste ogni 10 secondi su un endpoint, più limiti al minuto per gruppo di servizi che dipendono dal livello di listing del tuo negozio. Un aggiornamento di prezzi e stock accetta fino a 1.000 barcode (al massimo 20.000 unità per prodotto, prezzo di vendita non oltre il prezzo di listino), e Trendyol rifiuta la stessa richiesta ripetuta entro 15 minuti o più di 30 aggiornamenti di prezzo al minuto per un barcode. Gli elenchi finanziari richiedono un tipo di transazione e una finestra di al massimo 15 giorni.
Errori comuni: 401 con ClientApiAuthenticationException o basic.authorization.failed: credenziali errate (le credenziali di stage e di produzione sono diverse). 403: controlla TRENDYOL_SELLER_ID, perché Trendyol richiede uno User-Agent costruito a partire da esso. 429 too.many.requests: aspetta un momento e riprova.
Il connettore non usa il vecchio host api.trendyol.com/sapigw, i vecchi elenchi ordini né il vecchio filtro prodotti.
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 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
Trendyol. - 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
| Tool | What it does |
|---|---|
trendyol_list_products | List the seller's approved products (Product v2 filter): one entry per content (productMainId, title, brand, category, images, attributes)… |
trendyol_list_unapproved_products | List products that are not approved yet: pending approval or rejected, with the reject reasons, price, stock and attributes |
trendyol_list_stock_and_prices | List only stock and prices of approved products (list price, sale price, quantity, last stock change per variant) |
trendyol_get_product | Read the basic state of one product by barcode: approved or not (and when), archived, listing id and content id |
trendyol_get_buybox | Check the buybox for up to 10 barcodes: your position in the buybox, the buybox price and whether other sellers offer the same product |
trendyol_get_batch_request | Read the result of an asynchronous product, price, stock, archive or delete request by its batchRequestId: overall status (IN_PROGRESS… |
trendyol_create_products | Create products (Product v2, up to 1,000 per call) |
trendyol_update_price_and_inventory | Update the stock and prices of approved products (up to 1,000 barcodes per call, at most 20,000 units per product) |
trendyol_update_product_content | Update the content of approved products (title, description, images, attributes) by contentId, up to 1,000 per call |
trendyol_update_unapproved_products | Correct products that are still waiting for approval or were rejected (title, description, brand, category, images, attributes, stock code… |
trendyol_archive_products | Archive products (take them off sale) or bring them back from the archive, by barcode, up to 1,000 per call |
trendyol_delete_products | Delete products from Trendyol by barcode |
trendyol_list_orders | List shipment packages (orders) with their lines, customer, addresses, amounts, status, cargo provider and tracking |
trendyol_update_package_status | Move a shipment package to Picking (you started preparing it) or Invoiced (with the invoice number) |
trendyol_update_tracking_number | Send the carrier's tracking number of a package shipped with your own carrier, mainly on the international storefronts (Europe, Gulf)… |
trendyol_change_cargo_provider | Change the cargo company of a shipment package |
trendyol_send_invoice_link | Send the link of the e-invoice (e-Fatura or e-Arşiv) of a shipment package; Trendyol forwards it to the customer |
trendyol_report_unsupplied | Report that lines of a package cannot be supplied, which cancels them for the customer |
trendyol_list_claims | List returns (claims) with the order, customer, cargo tracking and each returned item with the customer reason and status |
trendyol_get_claim_item_audit | Read the status history of one returned item: each status change, when and by whom |
trendyol_list_claim_issue_reasons | List the reasons a seller can give when rejecting a returned item, with their ids for trendyol_reject_claim_items |
trendyol_approve_claim_items | Approve returned items that arrived at your warehouse; the customer is refunded |
trendyol_reject_claim_items | Open a rejection request for returned items (for example a wrong or damaged item came back), with a reason from… |
trendyol_list_questions | List customer questions about your products: text, product, status (WAITING_FOR_ANSWER to answer), date and the answer if any |
trendyol_get_question | Read one customer question with the product, the answer and, if it was rejected or reported, the reason |
trendyol_answer_question | Answer a customer question (10 to 2,000 characters) |
trendyol_list_categories | Find categories for product creation |
trendyol_get_category_attributes | List the attributes of a leaf category: id, name, whether it is required, a variant attribute, allows several values or a free value |
trendyol_list_attribute_values | List the allowed values of one category attribute (attributeValueId and name), for attributeValueIds in trendyol_create_products |
trendyol_search_brands | Find brands by name to get the brandId for trendyol_create_products |
trendyol_list_brands | List all brands page by page (id and name) |
trendyol_list_cargo_providers | List the cargo companies available on the storefront (code and name) |
trendyol_list_addresses | List the seller's shipment, invoice and return addresses with their ids (shipmentAddressId and returningAddressId for products) and the… |
trendyol_list_settlements | List settlement lines: sales, returns, discounts, coupons, commissions and their payout, with amounts, commission rate, seller revenue… |
trendyol_list_other_financials | List other financial records: payment orders (payouts), wire transfers, incoming transfers, deduction and return invoices, commission… |
Esempi di prompt
- "Quali pacchi di spedizione degli ultimi 3 giorni sono ancora nello stato Created, e quali righe contiene ciascuno?"
- "Controlla la buybox per i barcode 8680001234567 e 8680001234574 e dimmi se un altro venditore ha la buybox e a che prezzo."
- "Elenca le domande dei clienti in attesa di risposta e prepara una bozza di risposta per ciascuna, ma mostrami le risposte prima di inviarne qualcuna."
- "Riassumi vendite, resi e commissioni dai regolamenti dal 1 al 15 ottobre."
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
Questa guida ti è stata utile?