In breve
Tiki Open API per i venditori nel marketplace vietnamita: ordini, conferma di stock e dropship, etichette di spedizione e risultati di consegna del venditore, prodotti con prezzo e stock per magazzino, magazzini e inventari dei venditori, categorie, marchi e richieste di prodotto. ID e segreto dell'app interna.
Configurazione guidata
Collega Tiki a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Tiki 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 Tiki
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 → Tiki, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Tiki + Microsoft Copilot
Tiki Open API per i venditori nel marketplace vietnamita: ordini, conferma di stock e dropship, etichette di spedizione e risultati di consegna del venditore, prodotti con prezzo e stock per magazzino, magazzini e inventari dei venditori, categorie, marchi e richieste di prodotto. ID e segreto dell'app interna.
Prerequisiti
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:
TIKI_CLIENT_ID, TIKI_CLIENT_SECRET
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti.
- Accedi alla console della Tiki Open Platform su
https://open.tiki.vncon il tuo account Tiki e apri Applicazione, Crea (https://open.tiki.vn/web/console/apps/create). - Compila il nome, il riassunto, la descrizione, la homepage e l'icona. Come Metodo di autenticazione dell'endpoint del token scegli basic header (non può essere cambiato in seguito), e come tipo di applicazione In-house.
- Inserisci il tuo ID negozio (il numero senza il prefisso S) e il nome del negozio, e invia. Copia l'App ID in
TIKI_CLIENT_IDe il App Secret inTIKI_CLIENT_SECRET. - Approva la connessione nel Tiki Seller Center: Informazioni venditore, Dettagli, Impostazioni negozio e Informazioni di contatto, Gestisci, Applicazioni integrate. Fino ad allora ogni chiamata restituisce 401.
Il connettore ottiene un token su https://api.tiki.vn/sc/oauth2/token (credenziali client, HTTP Basic) e lo rinnova quando scade. Un'app interna ha ogni permesso del negozio, quindi non ci sono scope da scegliere. Tiki ha solo un ambiente di produzione.
Dove iniziare: tiki_list_orders con item_confirmation_status in attesa (ordini da confermare) e stato nin|processing,waiting_payment, poi tiki_get_order.
Conferma degli ordini: un ordine evaso dal tuo stock (tiki_delivery, seller_delivery, cross_border) è confermato con tiki_confirm_available, elencando gli ID degli articoli che puoi fornire e un inventario venditore da tiki_list_seller_inventories (passa il codice magazzino Tiki dell'ordine). Gli articoli esclusi vengono annullati. Un ordine dropship è confermato con tiki_confirm_dropship; tiki_cancel_dropship rifiuta uno ed è installato spento. tiki_get_shipping_label restituisce il link dell'etichetta per il modello di consegna dell'ordine. Gli ordini che consegni tu stesso ottengono il loro risultato con tiki_update_seller_delivery. Non esiste un'API di restituzione o cancellazione: le restituzioni appaiono come ordini is_rma e lo stato restituito.
Prodotti e stock: tiki_list_products (includi inventario per stock per magazzino), tiki_get_product, tiki_find_product_by_sku (il tuo original_sku), tiki_update_product (prezzo in VND e stock per magazzino venditore da tiki_list_seller_warehouses; non per prodotti in stock memorizzati su Tiki). tiki_set_product_active è spento, perché 0 toglie il prodotto dalla vendita. tiki_list_product_requests e tiki_get_tracking seguono le richieste di prodotto; tiki_list_categories, tiki_get_category_attributes, tiki_list_brands e tiki_list_tiki_warehouses forniscono i dati di riferimento. tiki_get_seller mostra il negozio e i suoi modelli operativi. La creazione di prodotti non è inclusa.
Formati: le date sono yyyy-MM-dd HH:mm:ss in ora vietnamita (UTC+7); i prezzi sono in VND. I filtri impostati sugli ordini sono scritti in|a,b o nin|a,b. Le liste prendono page da 1 e limit; la risposta ha paging (totale, current_page, last_page). Gli errori sono errors (un elenco di messaggi) con 400, 401 (token mancante, scaduto o l'app non connessa al negozio), 403, 422 o 429.
Limite di richiesta: 200 richieste al secondo per venditore; un 429 dovrebbe essere riprovato più tardi, le altre risposte 4xx no.
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
Tiki. - 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 |
|---|---|
tiki_get_seller | Il venditore dietro il token: id, nome, attivo, logo, operation_models (dropship, instock, backorder, seller_backorder, cross_border)… |
tiki_list_seller_warehouses | Magazzini dei venditori (indirizzi di ritiro e restituzione): id, nome, is_primary, stato, tipo, via, quartiere, distretto, regione, paese e contatto… |
tiki_list_orders | Elenca gli ordini, dal più recente: codice, fulfillment_type, stato, is_rma, created_at, updated_at, fattura (subtotale, totale… |
tiki_get_order | Leggi un ordine: codice, relation_code, fulfillment_type, stato, fattura, magazzino Tiki, articoli con prodotto, prezzo, quantità, reddito venditore… |
tiki_list_seller_inventories | Inventari dei venditori (locali di stock) da cui puoi confermare ordini, con i magazzini Tiki che servono: seller_inventories e mappings… |
tiki_get_shipping_label | Link all'etichetta stampabile di un ordine (HTML): shipping_label_url (tiki-delivery), shipping_label_url e shipping_stamp_url (dropship)… |
tiki_list_products | Elenca i prodotti, dal più recente: product_id, sku, original_sku (il tuo SKU), nome, prezzo, market_price, entity_type, master_id, super_id… |
tiki_get_product | Leggi un prodotto: nome, sku, original_sku, prezzo, market_price, stato, attributi, immagini, categorie e stock per magazzino. Solo lettura |
tiki_find_product_by_sku | Trova un prodotto con il tuo SKU (original_sku): product_id, sku, nome, prezzo, market_price, categorie e immagini. Solo lettura |
tiki_list_categories | Categorie Tiki: id, nome, genitore, is_primary e se i prodotti possono essere creati in essa. Filtra per genitore per navigare nell'albero. Solo lettura |
tiki_get_category_attributes | Attributi di una categoria per richieste di prodotto: codice, nome visualizzato, tipo di dato, is_required e valori consentiti. Solo lettura |
tiki_list_brands | Cerca marchi Tiki per nome: id e nome, come utilizzati nelle richieste di prodotto. Solo lettura |
tiki_list_tiki_warehouses | Magazzini Tiki (centri di evasione): id, codice e nome, come appaiono negli ordini e nelle mappature dell'inventario venditore. Solo lettura |
tiki_list_product_requests | Richieste di creazione e aggiornamento di prodotti: id, track_id, stato (drafted, processing, waiting, approved, rejected, deleted), motivo e il… |
tiki_get_tracking | Stato di una richiesta di prodotto asincrona tramite il suo track id: stato, motivo e l'id della richiesta una volta accettata. Solo lettura |
tiki_confirm_available | Conferma stock per un ordine evaso dal tuo inventario (tiki_delivery, seller_delivery o cross_border): elenca gli ID degli articoli che puoi fornire… |
tiki_confirm_dropship | Conferma un ordine dropship (seller_confirmed) da un inventario venditore; Tiki poi organizza il ritiro |
tiki_update_seller_delivery | Riporta il risultato della consegna di un ordine che consegni tu stesso (seller_delivery): successful_delivery, o failed_delivery con la causa e… |
tiki_update_product | Cambia il prezzo e lo stock per magazzino venditore di un prodotto, identificato dal tuo original_sku o dal product_id Tiki. Lo stock non può essere… |
tiki_set_product_active | Attiva un prodotto (1) o disattivalo (0) per la vendita. 0 lo toglie dalla vendita su Tiki |
tiki_cancel_dropship | Rifiuta un ordine dropship (seller_canceled). Non può essere annullato; il cliente viene rimborsato e conta contro il negozio |
Esempi di prompt
- "Quali ordini Tiki necessitano ancora di conferma dello stock?"
- "Conferma dropship per l'ordine 821034567 e ottieni l'etichetta di spedizione."
- "Qual è lo stock dello SKU TK-KETTLE-17 in ciascuno dei miei magazzini?"
- "Quali richieste di prodotto sono ancora in attesa di approvazione da Tiki?"
- "Traccia la consegna dell'ordine 821034567."
FAQ
Da dove provengono le credenziali? Da un'app interna sulla console della Tiki Open Platform, con il metodo di autenticazione dell'endpoint del token basic header. Approva la connessione nel Tiki Seller Center sotto Applicazioni integrate, o ogni chiamata restituisce 401.
Cosa copre? Ordini con conferma di stock e dropship, etichette di spedizione e risultati di consegna del venditore, prodotti con prezzo e stock per magazzino, magazzini e inventari dei venditori, categorie, marchi e richieste di prodotto.
Quali strumenti sono installati spenti? tiki_cancel_dropship e tiki_set_product_active. Attivali nella pagina del connettore solo se l'AI deve usarli.
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?