概要
ベトナムのマーケットプレイス向けのTikiオープンAPI:注文、在庫およびドロップシップ確認、配送ラベルと販売者の配送結果、倉庫ごとの価格と在庫を持つ製品、販売者の倉庫と在庫、カテゴリ、ブランドおよび製品リクエスト。社内アプリIDとシークレット。
ガイド付きセットアップ
Tiki を Gemini に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Tiki を接続して、MCP URL を Gemini に追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Tiki のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → Tikiをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Tiki + Gemini
ベトナムのマーケットプレイス向けのTikiオープンAPI:注文、在庫およびドロップシップ確認、配送ラベルと販売者の配送結果、倉庫ごとの価格と在庫を持つ製品、販売者の倉庫と在庫、カテゴリ、ブランドおよび製品リクエスト。社内アプリIDとシークレット。
前提条件
コネクタに組み込まれた完全なセットアップ手順を参照してください(コネクタを選択するとアプリ内ストアで表示されます)。このコネクタに必要な環境変数は次のとおりです:
TIKI_CLIENT_ID, TIKI_CLIENT_SECRET
ステップ1 — 認証情報を取得する
設定には約10分かかります。
- Tikiアカウントで
https://open.tiki.vnのTikiオープンプラットフォームコンソールにログインし、Application, Createを開きます(https://open.tiki.vn/web/console/apps/create)。 - 名前、概要、説明、ホームページ、アイコンを入力します。Token endpoint auth methodとしてbasic headerを選択します(後で変更できません)、アプリケーションタイプはIn-houseを選択します。
- ストアID(Sプレフィックスなしの番号)とストア名を入力し、送信します。App IDを
TIKI_CLIENT_IDに、App SecretをTIKI_CLIENT_SECRETにコピーします。 - Tiki販売者センターで接続を承認します:Seller info, Detail, Store Setting and Contact Info, Manage, Integrated Applications。それまではすべての呼び出しが401で応答します。
コネクタはhttps://api.tiki.vn/sc/oauth2/tokenでトークンを取得し(クライアント資格情報、HTTP Basic)、期限切れの際には更新します。社内アプリはストアのすべての権限を持つため、スコープを選択する必要はありません。Tikiには本番環境のみがあります。
開始する場所:tiki_list_ordersでitem_confirmation_statusがwaiting(確認待ちの注文)で、statusがnin|processing,waiting_payment、その後tiki_get_orderを呼び出します。
注文の確認:在庫から履行された注文(tiki_delivery、seller_delivery、cross_border)はtiki_confirm_availableで確認され、供給可能なアイテムをリストし、tiki_list_seller_inventoriesから販売者の在庫を表示します(注文のTiki倉庫コードを渡します)。除外されたアイテムはキャンセルされます。ドロップシップ注文はtiki_confirm_dropshipで確認され、tiki_cancel_dropshipは1つを拒否し、オフに切り替えられます。tiki_get_shipping_labelは注文の配送モデルのラベルリンクを返します。自分で配送する注文はtiki_update_seller_deliveryで結果を取得します。返品やキャンセルのAPIはありません:返品はis_rma注文として表示され、返却ステータスが表示されます。
製品と在庫:tiki_list_products(倉庫ごとの在庫を含む)、tiki_get_product、tiki_find_product_by_sku(あなたのoriginal_sku)、tiki_update_product(価格はVND、tiki_list_seller_warehousesからの販売者倉庫ごとの在庫;Tikiに保管されている在庫商品には適用されません)。tiki_set_product_activeはオフにされており、0は製品を販売停止にします。tiki_list_product_requestsとtiki_get_trackingは製品リクエストに従い、tiki_list_categories、tiki_get_category_attributes、tiki_list_brands、tiki_list_tiki_warehousesは参照データを提供します。tiki_get_sellerはストアとその運用モデルを表示します。製品の作成は含まれていません。
フォーマット:日付はベトナム時間(UTC+7)でyyyy-MM-dd HH:mm:ss、価格はVNDです。注文に設定されたフィルターはin|a,bまたはnin|a,bとして記述されます。リストは1からpageを取り、limitを指定します;応答にはpaging(total、current_page、last_page)が含まれます。エラーはerrors(メッセージのリスト)で、400、401(トークンが欠落、期限切れ、またはアプリがストアに接続されていない)、403、422または429があります。
レート制限:販売者ごとに1秒あたり200リクエスト;429は後で再試行する必要がありますが、他の4xx応答は再試行しないでください。
ステップ2 — アダプタをインストールする
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
ステップ3 — Geminiにコネクタを追加する
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
Gemini CLI は ~/.gemini/settings.json(Windows では %USERPROFILE%\.gemini\settings.json)から MCP サーバーを読み込みます。次を追加してください:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、
YOUR_MCP_API_KEYと置き換えます。 - ファイルを保存し、
geminiを再起動します。 - Gemini CLI で
/mcpを実行します(またはシェルでgemini mcp list)。anythingmcpが接続済みとして表示されるはずです。 - プロンプトを入力しましょう — Gemini CLI が
Tikiのツールを呼び出せるようになりました。
利用可能なツール
| ツール | 機能 |
|---|---|
tiki_get_seller | トークンの背後にいる販売者:id、名前、アクティブ、ロゴ、operation_models(ドロップシップ、在庫、バックオーダー、販売者バックオーダー、クロスボーダー)… |
tiki_list_seller_warehouses | 販売者の倉庫(受取および返品先住所):id、名前、is_primary、status、type、street、ward、district、region、countryおよびcontact… |
tiki_list_orders | 注文をリスト表示、最新のものから:code、fulfillment_type、status、is_rma、created_at、updated_at、invoice(subtotal、grand_total… |
tiki_get_order | 1つの注文を読み取る:code、relation_code、fulfillment_type、status、invoice、Tiki倉庫、製品、価格、数量、販売者収入… |
tiki_list_seller_inventories | 注文を確認できる販売者の在庫(在庫場所)、それに対応するTiki倉庫:seller_inventoriesおよびmappings… |
tiki_get_shipping_label | 注文の印刷可能なラベルへのリンク(HTML):shipping_label_url(tiki-delivery)、shipping_label_urlおよびshipping_stamp_url(ドロップシップ)… |
tiki_list_products | 製品をリスト表示、最新のものから:product_id、sku、original_sku(あなたのSKU)、name、price、market_price、entity_type、master_id、super_id… |
tiki_get_product | 1つの製品を読み取る:name、sku、original_sku、price、market_price、status、attributes、images、categoriesおよび倉庫ごとの在庫。読み取り専用 |
tiki_find_product_by_sku | 自分のSKU(original_sku)で製品を検索:product_id、sku、name、price、market_price、categoriesおよびimages。読み取り専用 |
tiki_list_categories | Tikiカテゴリ:id、name、parent、is_primaryおよび製品が作成できるかどうか。親でフィルタリングしてツリーを辿ります。読み取り専用 |
tiki_get_category_attributes | 製品リクエスト用の1つのカテゴリの属性:code、display name、data type、is_requiredおよび許可される値。読み取り専用 |
tiki_list_brands | 名前でTikiブランドを検索:idとname、製品リクエストで使用されるもの。読み取り専用 |
tiki_list_tiki_warehouses | Tiki倉庫(履行センター):id、codeおよびname、注文や販売者の在庫マッピングに表示されるもの。読み取り専用 |
tiki_list_product_requests | 製品の作成および更新リクエスト:id、track_id、state(drafted、processing、waiting、approved、rejected、deleted)、reasonおよび… |
tiki_get_tracking | トラッキングIDによる非同期製品リクエストの状態:state、reasonおよび受け入れられたリクエストID。読み取り専用 |
tiki_confirm_available | あなたの在庫から履行された注文の在庫を確認する(tiki_delivery、seller_deliveryまたはcross_border):供給可能なアイテムIDをリストします… |
tiki_confirm_dropship | 1つの販売者在庫からのドロップシップ注文を確認する(seller_confirmed);Tikiがピックアップを手配します |
tiki_update_seller_delivery | 自分で配送する注文の配送結果を報告する(seller_delivery):successful_deliveryまたはfailed_deliveryとその原因… |
tiki_update_product | あなたのoriginal_skuまたはTiki product_idで識別された1つの製品の価格と販売者倉庫ごとの在庫を変更します。在庫は… |
tiki_set_product_active | 1つの製品を販売用にオン(1)またはオフ(0)に切り替えます。0はTikiでの販売を停止します |
tiki_cancel_dropship | ドロップシップ注文を拒否します(seller_canceled)。元に戻すことはできず、顧客は返金され、ショップに対してカウントされます |
例のプロンプト
- "どのTikiの注文がまだ在庫確認を必要としていますか?"
- "注文821034567のドロップシップを確認し、配送ラベルを取得します。"
- "SKU TK-KETTLE-17の在庫は各倉庫にどれくらいありますか?"
- "どの製品リクエストがまだTikiの承認を待っていますか?"
- "注文821034567の配送を追跡します。"
よくある質問
認証情報はどこから来ますか? Tikiオープンプラットフォームコンソールの社内アプリケーションから、トークンエンドポイント認証方法はbasic headerです。Tiki販売者センターのIntegrated Applicationsで接続を承認するか、すべての呼び出しが401で応答します。
何をカバーしていますか? 在庫およびドロップシップ確認のある注文、配送ラベルと販売者の配送結果、倉庫ごとの価格と在庫を持つ製品、販売者の倉庫と在庫、カテゴリ、ブランドおよび製品リクエスト。
どのツールがオフにされてインストールされますか? tiki_cancel_dropshipとtiki_set_product_active。AIが使用する必要がある場合のみ、コネクタページでオンにしてください。
Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。
次のステップ
このガイドは役に立ちましたか?