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 Gemini in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Tiki con la configurazione guidata e aggiungi il tuo URL MCP a Gemini. 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 + Gemini
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 Gemini
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.
Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia
gemini. - Esegui
/mcpin Gemini CLI (oppuregemini mcp listdal terminale):anythingmcpdovrebbe risultare connesso. - Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di
Tiki.
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.
Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.
Prossimi passi
Questa guida ti è stata utile?