AI アシスタント接続ガイド / AI Connection Guide

Taviro は「AI に操作されること」を前提に設計されたプラットフォームです。Claude・ChatGPT・Cursor などお使いの AI をつなぐだけで、商品登録・在庫更新・注文確認など多くの操作を AI アシスタントに任せられます。このページだけで接続から日常運用まで完結します。

5分でMCP接続（推奨）開発者向け API 接続ツール別手順タスク例文集トラブルシューティングと安全 API リファレンス →

MCP 接続（推奨・キー貼り付け不要）

Taviro は MCP サーバーを公開しています。対応 AI ならコネクタとして追加してログインするだけ——API キーの発行も貼り付けも不要で、いちばん簡単・安全な接続方法です。

Claude（Web / デスクトップ）

コネクタに追加

「設定 → コネクタ → カスタムコネクタを追加」で URL に https://taviroglobal.com/mcp を入力 → Taviro のログイン画面が開くのでログインして「許可」。以後は「Taviro に商品を登録して」と話すだけです。

Claude Code（ターミナル）

コマンド 1 行

claude mcp add --transport http taviro https://taviroglobal.com/mcp → 初回に /mcp で認証（ブラウザでログイン・許可）。

ChatGPT（Web / デスクトップ）

コネクタに追加

「設定 → コネクタ → 追加」で URL に https://taviroglobal.com/mcp を入力（コネクタ機能が使えるプラン/開発者モードが必要）→ Taviro のログイン画面でログインして「許可」。以後はチャットで指示するだけです。

Cursor / その他 MCP 対応ツール

URL を登録

MCP サーバー設定に https://taviroglobal.com/mcp（transport: HTTP、非対応なら上記 mcp-remote 経由）を追加。同じ OAuth ログインで認証できます。

利用できるツール

まず listing_guide を

商品の一括登録（create_products_bulk）と事前検証（validate_products）・写真アップロード用リンクの発行・カテゴリ自動判定（suggest_category）・下書き確認リンク・カタログ検索と選品推薦（recommend_products）・店舗への出品・在庫調整・注文/精算・発送登録。最初に listing_guide を呼ぶと、必須項目・カテゴリ・画像・海外販売設定・写真からの出品手順まで、出品マニュアル全文を AI が自分で取得します。

認証はお使いの Taviro アカウントそのもの。サプライヤーは自社商品だけ、販売パートナーは承認済みカタログと自店舗の注文だけが見えます。連携の失効は管理画面の「AI・API連携」からいつでも行えます（パスワード変更でも全失効）。

開発者向け API 接続（自社システム・ERP・開発ツール向け）

API キーは、シークレット管理機能を備えた開発者ツール・自社システム・ERP から Taviro を操作するための資格情報です。Claude・ChatGPT などの汎用チャットに接続する場合は、キーの発行も貼り付けも不要な上記の MCP 接続をご利用ください。

API キーはチャット本文に貼り付けず、利用するツールのシークレット管理機能または環境変数に保存してください。

STEP 1

API キーを発行

サプライヤーまたは販売パートナーとしてログイン →「API連携」→「キーを作成」。tvk_ で始まる文字列をコピー（表示は一度きり）。

STEP 2

シークレットに保存

キーはツールのシークレット管理機能または環境変数（例：TAVIRO_API_KEY）に保存し、コードやプロンプト本文には直接書かないでください。

STEP 3

自分のコード／ツールから呼ぶ

各リクエストの Authorization: Bearer ヘッダーに、保存したキーを渡します。破壊的な操作は実行前に内容を確認する実装にしてください。

接続の要点（開発者リファレンス）

自社システムや開発ツールを構成する際の要点です。汎用チャットの本文に貼り付けるためのものではありません。

ベース URL：https://taviroglobal.com
API ドキュメント：GET https://taviroglobal.com/api/docs（最初に取得して利用可能な操作を確認）
認証：HTTP ヘッダー Authorization: Bearer <シークレットに保存した API キー>（鍵の直書きは禁止）
リクエスト／レスポンスは JSON。金額は日本円の整数です。
レート制限：1 時間あたり 600 リクエスト。429 が返ったら Retry-After に従ってください。
破壊的な操作（商品の編集、在庫の変更など）は、実行前に内容を確認する運用・実装にしてください。

ツール別の詳しい手順

Claude（Web / デスクトップ / Claude Code）

MCP 接続（上記）が最も簡単です。コネクタ追加 → ログイン → 完了。汎用チャットに鍵を貼り付ける必要はありません。
Claude Code などの開発ツールから API キーを使う場合は、キーをシークレット管理または環境変数に保存し、チャット本文には貼り付けないでください（開発者向け API 接続）。
Claude Code は手元の CSV や商品画像フォルダを直接読ませられるので大量一括処理に最適（例：「このフォルダの products.csv を全部 Taviro に登録して」）。お使いのパソコン上で動くため、画像もアップロードリンクを使わずに直接送信できます。

ChatGPT（Web / デスクトップ）

MCP（推奨）：「設定 → コネクタ → 追加」で https://taviroglobal.com/mcp を登録（コネクタ対応プラン/開発者モード）→ Taviro にログイン・許可 → 「Taviro の listing_guide を読んで、この写真の商品を出品して」のように指示。
API キー方式は開発ツール・自社システム向けです。キーはシークレット管理／環境変数に保存し、チャット本文には貼り付けないでください（開発者向け API 接続）。
定型業務はカスタム指示や GPTs に保存して再利用できます。

キーを直書きせず環境変数へ：export TAVIRO_API_KEY=tvk_... → プロンプトには「キーは環境変数 TAVIRO_API_KEY にある」と書くのが安全です。

ローカル AI・自社エージェント

OpenAI 互換のローカル AI（LM Studio、Ollama 等）でも HTTP ツールがあれば接続可能。開発者向け API 接続の要点に沿って設定し、キーは環境変数に保存してから利用してください。
動作確認：curl -H "Authorization: Bearer $TAVIRO_API_KEY" https://taviroglobal.com/api/ops/summary — JSON が返れば認証は正常（キーは環境変数から読み込みます）。

タスク例文集（コピーしてそのまま使えます）

写真から出品する（サプライヤー）

この商品写真を見て、Taviro の listing_guide の手順どおりに出品して。カテゴリは suggest_category に商品名を渡して選び、タイトルと説明文は日本語で、仕入価格1200円・推奨売価2980円・在庫40。登録できたら商品IDを教えて。

AI に選品させる（販売パートナー）

recommend_products で北米にも発送できる商品を商品差益率30%以上（送料・決済手数料等を除く概算）で探して、直近30日の売れ行き順にトップ10を表にして。私が選んだものを売価は仕入の2.5倍で私のストアに出品して。※最終的な利益は配送費・決済手数料・税等を差し引いて確認してください。

商品を一括登録する（サプライヤー）

以下の商品リストを Taviro に一括登録してください。まず validate_products で検証、次に下書きとして登録（各行に SKU を external_ref として）、最後に下書き確認リンクを出して。配送方法はすべてメーカー直送で。
商品名 / カテゴリ / 仕入価格 / 推奨売価 / 在庫 / SKU
（ここに商品リストを貼る）

今週の売上を確認する

Taviro の注文データを取得して、今週の注文件数・売上合計・商品別の売れ筋トップ3を教えて。

在庫をまとめて更新する（サプライヤー）

次の SKU の在庫を実在庫に合わせて調整して。変更前に差分を見せて、私が OK と言ってから実行して。
DJP-MAT-01: 45個 / DJP-CUP-02: 120個 / DJP-BOX-03: 8個

精算データを取得する（サプライヤー）今月の精算データ（会計CSV）を取得して、未払い金額の合計と支払予定を教えて。

ロール別実践プレイブック（保存版）

「AIに何を頼めばいいか分からない」方のために、立場別にそのままコピーして使える指示文を用意しました。接続（上記のMCP接続）さえ済んでいれば、貼り付けるだけで動きます。

サプライヤー編 — 出品・在庫・出荷・精算

AIができること：商品写真からの自動出品（カテゴリ・属性・商品名・説明文まで全部AIが作成）／表からの一括出品／在庫調整／受注確認と出荷処理／精算の確認／経営サマリー。

レシピ①　写真を渡すだけで出品（いちばん簡単）商品写真を数枚アイに添付して、これを送るだけ：

この写真の商品を Taviro に出品してください。
・仕入価格：1,200円　・販売希望価格：2,980円
・在庫：40個　・SKU：IMB-TWL-01　・重さ：約420g　・発送：自社直送
カテゴリと属性はあなたが検索して最適なものを選び、日本語の商品名（60字以内）と正直で魅力的な説明文も書いてください。
登録する前に内容を一覧で見せて、私が「OK」と言ってから実行してください。

写真が数枚を超えるときは、AI に画像そのものを渡さないでください。「写真をアップロードするリンクをちょうだい」と頼めば、AI が専用リンクを出します。そこにフォルダごとドラッグすれば、ブラウザから直接 Taviro に届きます（AI の会話を経由しないので一瞬です）。アップロード後は「終わりました」と伝えるだけで、AI がファイル名で商品と写真を結び付けます。

商品名・説明に社名・電話番号・URL・SNSを入れると自動的に登録できません（プラットフォームの規約です）。AIが書く文章は自動でこのルールを守ります。

レシピ②　手持ちの商品リストから一括出品数十件でも一度に。まず検証、次に下書き、最後にあなたが確認してから審査へ。

次の表の商品を Taviro に一括登録してください。全て自社直送、カテゴリはあなたが選んでください。
手順：まず validate_products で全件チェックして問題を直し、次に下書きとして一括登録（各行に SKU を external_ref として付けてください）、最後に下書き確認用のリンクを出して。私がそのページで確認してから審査に出します。
商品名 / 仕入価格 / 販売価格 / 在庫 / SKU
今治タオル ギフト3枚組 / 1200 / 2980 / 40 / IMB-TWL-01
美濃焼 マグカップ 桜柄 / 800 / 2200 / 60 / MNO-CUP-02
（ここにあなたの商品を追加）

レシピ③　在庫を実在庫に合わせる（棚卸し後に）

次のSKUの在庫を実在庫に合わせてください。まず現在の在庫との差分を表で見せて、私が承認してから実行して。
IMB-TWL-01：45個　MNO-CUP-02：120個

レシピ④　今日の受注確認と出荷処理

未出荷の注文を一覧してください。そのあと O-31 を出荷済みにして、追跡番号は 1234-5678-9012、配送会社はヤマト運輸で登録して。

出荷はセラーの支払い確認後に可能になります（前払い制）。「支払待ち」の注文は出荷できません — AIに聞けば理由も教えてくれます。

レシピ⑤　月次の精算チェック

今月の精算状況をまとめてください。支払済み・未払いの金額、次回入金の見込みも教えて。

レシピ⑥　経営サマリー（週1回おすすめ）

Taviroの経営概況を取得して、今週の受注件数・売上・在庫が少ない商品トップ3を報告してください。先週と比べて気になる点があれば指摘して。

セラー（販売パートナー）編 — 選品・出品・売上管理

AIができること：条件を伝えるだけの商品推薦／利益シミュレーション／販売価格を決めてワンクリック出品／受注・売上の確認／毎朝の定型レポート。

事前にポータルでストア接続（Shopify）を済ませてください。出品先ストアがないと出品できません。

レシピ①　ニッチを伝えて選品（選品の基本形）

20〜30代女性向けの生活雑貨で、商品差益率（概算）35%以上の商品を recommend_products で5つ探してください。それぞれについて、出品ページに使える説明文の下書きも添えて。

レシピ②　利益シミュレーション（出品前に必ず）

P-13 を 6,980円 で売った場合の、商品差益（送料・決済手数料等を除く）・プラットフォーム手数料・送料を引いた実際の手取りを計算してください。5,980円の場合とも比較して。

レシピ③　価格を決めて出品

P-13 を私のストアに出品してください。販売価格は 6,980円。実行前に商品内容と価格を確認させて。

レシピ④　毎朝のルーティン（コピーして固定メッセージに）

おはよう。Taviroの今日の状況を報告して：①新しい注文（あれば商品と金額）②未払いの請求合計 ③私が出品中の商品で在庫10個未満のもの。問題がなければ「異常なし」の一言でOK。

レシピ⑤　売れ行き比較

私が出品している商品の直近30日の注文数を多い順に並べて。売れていない商品は掲載停止を検討すべきか意見も聞かせて。

お支払いは前払い制です。カード自動支払いをONにしておくと（請求ページ）、注文のたびに自動で決済され出荷が最速になります。

倉庫パートナー編 — 入庫・ピッキング・出荷

レシピ①　今日の出荷リスト

未出荷の注文を一覧して、商品名・数量・宛先都道府県をピッキングしやすい形の表にしてください。

レシピ②　まとめて出荷処理

O-31 と O-32 を出荷済みにしてください。追跡番号はそれぞれ 1111-2222-3333 と 4444-5555-6666、配送会社は佐川急便。

レシピ③　入庫計上（荷物が届いたら）P-20 の入庫を50個計上してください。検品で2個不良があったので実際は48個で。

同梱（同一住所の注文をまとめて発送）はポータルの出荷タスク画面から操作できます。

上手な頼み方 3つのコツ

①数字を必ず入れる（価格・在庫数・SKU・注文番号）。「いい感じに」はAIが一番困る指示です。②登録・出荷など書き込み系の操作は「実行前に確認して」と一言添える。取り消せない操作を防げます。③迷ったら「あなたはTaviroで何ができますか？」と聞けば、AIが自分の道具箱を説明してくれます。

トラブルシューティング

症状 / エラー	原因と対処
`401 AUTH_REQUIRED`	API キーが誤りか無効化済み。`Authorization: Bearer tvk_...` の形式を確認し、必要なら新しいキーを発行。
`403 FORBIDDEN`	キーの持ち主の権限外の操作（例：サプライヤーのキーで出品）。適切なロールのアカウントでキーを発行してください。
`422 SELLING_PRICE_BELOW_COST`	売価が仕入価格を下回っています。仕入以上に設定してください。
`429 RATE_LIMITED`	600回/時の上限。`Retry-After`（秒）だけ待って再開。常駐エージェントはポーリング間隔を延ばす。
MCP 認証後「localhost で接続が拒否されました」	Taviro 側の認可は成功しています。ローカル受信プロセス（mcp-remote）が未起動なのが原因。①もう一度やり直す（初回は npx のダウンロードで間に合わないことがあります）②固定ポートを指定：`args = ["-y", "mcp-remote@latest", "https://taviroglobal.com/mcp", "33418"]` ③AI ツールとブラウザが同じ PC であること（リモートサーバー/Docker 内では localhost 方式不可 → API キー方式へ）④Node 18 以上・セキュリティソフトのポート遮断を確認。
AI が「リクエストを送れない」	ツール実行（HTTP）機能がないか無効。Claude Code など、ツール実行に対応した環境をご利用ください。
変更が Shopify に反映されない	公開中商品の編集は再審査に戻ります。承認後に同期されます。

セキュリティ：API キーはパスワードと同じ機密情報です。API キーはチャット本文に貼り付けず、利用するツールのシークレット管理機能または環境変数に保存してください。共有チャット・スクリーンショット・コードリポジトリに鍵を残さないでください。キーの発行時は権限範囲（scope）を確認し、管理画面「AI・API連携」で作成日時・最終使用日時（データがある場合）を点検してください。不要・不審なキーは即時失効でき、失効するとそのキーを使う連携はすべて直ちに停止します（失効の影響）。在庫変更や出荷などの書き込み操作は実行前に必ず内容を確認し、用途ごとにキーを分けて影響範囲を最小にしてください。

Taviro 从设计之初就是"给 AI 操作的平台"。接上 Claude、ChatGPT、Cursor 等你在用的 AI，上架商品、更新库存、查询订单等大量操作都可以交给 AI 助手。这一页覆盖从接入到日常运营的全部内容。

MCP 接入（推荐 · 无需粘贴密钥）

Taviro 公开了 MCP 服务器。支持 MCP 的 AI 只需添加连接器并登录——不用发密钥也不用粘贴，是最简单安全的方式。

Claude（网页 / 桌面）

添加连接器

「设置 → 连接器 → 添加自定义连接器」，URL 填 https://taviroglobal.com/mcp → 弹出 Taviro 登录页，登录并点"许可"。之后直接说"帮我在 Taviro 上架商品"即可。

Claude Code（终端）

一行命令

claude mcp add --transport http taviro https://taviroglobal.com/mcp → 首次用 /mcp 认证（浏览器登录·许可）。

ChatGPT（网页 / 桌面版）

添加连接器

「设置 → 连接器 → 添加」输入 URL https://taviroglobal.com/mcp（需支持连接器的套餐/开发者模式）→ 在弹出的 Taviro 页面登录并「许可」。之后在对话里直接下指令即可。

Cursor / 其他 MCP 工具

登记 URL

在 MCP 服务器设置中添加 https://taviroglobal.com/mcp（transport: HTTP，不支持则用上面的 mcp-remote 桥接），同一 OAuth 登录即可。

可用工具

先调 listing_guide

上架商品、目录检索与选品推荐（recommend_products）、类目搜索、图片上传、铺货到店铺、库存调整、订单/结算、发货登记。先调用 listing_guide，AI 会自己拿到完整上架手册：必填项、类目、图片、海外销售设置、看图上架七步流程。

认证就是你的 Taviro 账号本身：供应商只能看到自己的商品，卖家只能看到已审核目录和自己店铺的订单。随时可在后台「AI·API连携」吊销连接（改密码也会全部失效）。

开发者 API 接入（自有系统 · ERP · 开发工具）

API 密钥用于从具备密钥管理能力的开发工具、自有系统或 ERP 操作 Taviro。若要连接 Claude、ChatGPT 等通用聊天，请使用上面的 MCP 接入（无需签发密钥，也无需把密钥贴进聊天框）。

请勿将 API 密钥粘贴到聊天正文中，应保存在所用工具的密钥管理功能或环境变量里。

STEP 1

签发密钥

以供应商或卖家身份登录 →「API连携」→「创建密钥」，复制 tvk_ 开头的字符串（只显示一次）。

STEP 2

存入密钥库

把密钥保存到工具的密钥管理功能或环境变量（如 TAVIRO_API_KEY），不要写进代码或提示词正文。

STEP 3

从自己的代码/工具调用

在每次请求的 Authorization: Bearer 头里带上密钥。破坏性操作请在执行前先确认内容。

接入要点（开发者参考）

配置自有系统或开发工具时的要点，并非用于粘贴到通用聊天正文。

Base URL：https://taviroglobal.com
API 文档：GET https://taviroglobal.com/api/docs（先获取以确认可用操作）
认证：HTTP 头 Authorization: Bearer <保存在密钥库中的 API 密钥>（禁止硬编码）
请求/响应均为 JSON，金额为日元整数。
限流：每小时 600 次请求，收到 429 时按 Retry-After 等待。
破坏性操作（编辑商品、改库存等）请在执行前确认内容。

分工具教程

Claude（网页 / 桌面 / Claude Code）

首选上面的 MCP 接入：加连接器 → 登录 → 完成，无需把密钥贴进聊天。
用 Claude Code 等开发工具时，把 API 密钥存进密钥管理或环境变量，不要贴进通用聊天（见开发者 API 接入）。
Claude Code 能直接读本地 CSV 和商品图片文件夹，最适合批量处理（如"把这个文件夹里的 products.csv 全部上架"、"看这几张照片帮我上架"）。

ChatGPT（网页 / 桌面版）

MCP（推荐）：「设置 → 连接器 → 添加」注册 https://taviroglobal.com/mcp（需支持连接器的套餐/开发者模式）→ 登录 Taviro 授权 → 直接说"读一下 Taviro 的 listing_guide，把这张照片的商品上架"。
密钥方式面向开发工具与自有系统：把密钥存进密钥管理/环境变量，不要贴进聊天正文（见开发者 API 接入）。
常规业务可存到自定义指令或 GPTs 里复用。

本地 AI · 自研 Agent

OpenAI 兼容的本地 AI（LM Studio、Ollama 等）只要有 HTTP 工具即可接入。请按开发者 API 接入的要点配置，并把密钥存进环境变量后再使用。
连通性验证：curl -H "Authorization: Bearer $TAVIRO_API_KEY" https://taviroglobal.com/api/ops/summary 返回 JSON 即为正常（密钥从环境变量读取）。

任务示例（可直接复制使用）

看图上架（供应商）

看这几张商品照片，按 Taviro listing_guide 的流程上架：用 search_categories 找类目，标题和描述用日语写，进货价1200日元、建议售价2980、库存40。完成后告诉我商品ID。

让 AI 选品（卖家）

用 recommend_products 找能发北美、商品差价率30%以上（不含运费、支付手续费等的概算）的商品，按近30天销量排前10列成表。我选中的按进货价2.5倍定价铺到我的店铺。※最终利润需再扣除配送费、支付手续费、税等。

批量上架（供应商）

把下面的商品列表逐个上架到 Taviro，全部完成后汇总成表。配送方式都选厂商直发。
品名 / 类目 / 进货价 / 建议售价 / 库存 / SKU
（在此粘贴商品列表）

查看本周销售取 Taviro 订单数据，告诉我本周订单数、销售总额、按商品的畅销前三。

批量调库存（供应商）

把下列 SKU 的库存调整为实际库存。先展示差异，我确认后再执行。
DJP-MAT-01: 45 / DJP-CUP-02: 120 / DJP-BOX-03: 8

拉取结算数据（供应商）取本月结算数据（会计CSV），告诉我未付总额和付款计划。

分角色实战手册（收藏版）

为"不知道该让 AI 干什么"的用户准备：按身份分类、可直接复制的指令。只要完成了上面的 MCP 接入，粘贴即用。提示词用日文写（平台数据是日文的，AI 处理效果最好），你和 AI 的对话用中文完全没问题。

供应商篇 — 上架、库存、发货、结算

AI 能干什么：发几张商品照片就能全自动上架（类目、属性、日文商品名、说明文全由 AI 生成）／从表格批量上架／调库存／查订单发货／对结算账／出经营周报。

秘籍①　发照片就上架（最简单）把商品照片发给 AI，附上这段话：

请把照片里的商品上架到 Taviro：
・供货价 1200 日元　・建议售价 2980 日元
・库存 40 个　・SKU：IMB-TWL-01　・重量约 420g　・自家直发
类目和属性由你搜索选择最合适的，再写一个 60 字以内的日文商品名和真实有吸引力的日文说明文，照片全部上传。
正式创建前先把内容列给我看，我说 OK 你再执行。

商品名和说明里不能出现公司名、电话、网址、SNS（平台规则，写了会被自动拒绝）。AI 生成的文案会自动遵守。

秘籍②　按表格批量上架

请把下表的商品逐个上架到 Taviro，结果汇总成表。全部自家直发，类目由你选。创建前先把全部内容给我过目。
商品名 / 供货价 / 售价 / 库存 / SKU
今治タオル ギフト3枚組 / 1200 / 2980 / 40 / IMB-TWL-01
美濃焼 マグカップ 桜柄 / 800 / 2200 / 60 / MNO-CUP-02
（在这里加你的商品）

秘籍③　盘点后对齐库存

请把以下 SKU 的库存调整为实际库存。先列出与当前库存的差异表，我确认后再执行。
IMB-TWL-01：45 个　MNO-CUP-02：120 个

秘籍④　查单+发货

列出所有未发货订单。然后把 O-31 标记为已发货，快递单号 1234-5678-9012，承运商ヤマト運輸。

平台是预付制：卖家付款确认后订单才能发货。显示「支払待ち」的订单发不了——问 AI 它会告诉你原因。

秘籍⑤　月度对账汇总本月结算情况：已打款、待结算各多少，下次预计到账时间。

秘籍⑥　经营周报（建议每周一次）

获取 Taviro 经营概况，报告本周订单数、销售额、库存最紧张的前3个商品。和上周比有什么值得注意的变化也指出来。

卖家篇 — 选品、上架、看生意

AI 能干什么：说出你的人群定位就能推荐商品／算利润账／定好价一句话上架到你的店／查订单看销量／每天早上的例行汇报。

先在门户完成店铺连接（Shopify），没有店铺就没有上架目的地。

秘籍①　按人群选品（选品基本式）

用 recommend_products 找 5 个适合 20〜30 岁女性的生活杂货，要求利润率 35% 以上。每个附一句「在 TikTok 上该怎么带」的建议。

秘籍②　上架前先算账

如果 P-13 卖 6980 日元，算出商品差价（不含运费、支付手续费等）、平台手续费、扣掉运费后的实际到手。再和卖 5980 日元对比一下。

秘籍③　定价上架把 P-13 上架到我的店铺，售价 6980 日元。执行前把商品内容和价格给我确认。

秘籍④　每日晨报（存成固定消息每天发）

早上好。汇报 Taviro 今日情况：①新订单（有的话列商品和金额）②未付账单合计 ③我在售商品中库存少于10个的。没问题就回「一切正常」四个字。

秘籍⑤　销量复盘把我在售商品近 30 天的订单量从高到低排列。卖不动的商品该不该下架，给我你的意见。

平台是预付制：在账单页开通银行卡自动扣款后每笔订单自动结算，发货最快，完全无感。

仓库篇 — 入库、拣货、出库

秘籍①　今日拣货单列出所有未发货订单，整理成方便拣货的表：商品名、数量、收件都道府县。

秘籍②　批量出库把 O-31 和 O-32 标记为已发货，单号分别是 1111-2222-3333 和 4444-5555-6666，承运商佐川急便。

秘籍③　入库登记（到货时）P-20 入库登记 50 个。验收发现 2 个不良品，实际按 48 个入。

合包发货（同地址订单合并一个包裹）在门户的出荷任务页面操作。

让 AI 好用的三个诀窍

①指令里必须带数字（价格、库存、SKU、订单号），"看着办"是 AI 最怕的指令。②上架、发货这类写入操作，加一句"执行前先让我确认"，防止不可撤销的误操作。③不知道能干什么时，直接问"你在 Taviro 上都能做什么？"，AI 会把自己的工具箱讲给你听。

故障排查

现象 / 错误	原因与处理
`401 AUTH_REQUIRED`	密钥错误或已吊销。确认格式为 `Authorization: Bearer tvk_...`，必要时重新签发。
`403 FORBIDDEN`	超出密钥所有者权限（如用供应商密钥做铺货）。请用对应角色的账号签发密钥。
`422 SELLING_PRICE_BELOW_COST`	售价低于进货价，请调整为不低于进货价。
`429 RATE_LIMITED`	达到 600次/小时上限，按 `Retry-After`（秒）等待；常驻 Agent 请拉长轮询间隔。
MCP 授权后提示 "localhost 拒绝访问"	Taviro 侧授权已成功，是本地接收进程（mcp-remote）未在监听。①直接重试一次（首次 npx 下载慢，回调服务器没来得及启动）②指定固定端口：`args = ["-y", "mcp-remote@latest", "https://taviroglobal.com/mcp", "33418"]` ③确认 AI 工具和浏览器在同一台电脑（远程服务器/Docker 里无法用 localhost 回调 → 改用 API 密钥方式）④Node ≥18、检查安全软件是否拦截本地端口。
AI 说"无法发送请求"	所用 AI 没有或未启用工具执行（HTTP）。请改用 Claude Code 等支持工具执行的环境。
改了但 Shopify 没变化	编辑在售商品会回到重审状态，审核通过后才会同步。

安全提醒：API 密钥等同密码。请勿将 API 密钥粘贴到聊天正文，应保存在所用工具的密钥管理功能或环境变量里。不要把密钥留在共享聊天、截图或代码仓库中。签发时确认权限范围（scope），并在后台「AI·API连携」核对创建时间与最后使用时间（若有数据）。不用或可疑的密钥可即时吊销，吊销后使用该密钥的连接会立即全部停止（吊销影响）。库存变更、发货等写入操作请在执行前务必确认；按用途分开签发以将影响范围降到最小。

Taviro is built to be operated by AI. Connect Claude, ChatGPT, Cursor or your own agent, and delegate product listing, inventory updates and order checks — much of the work can be handled by your AI assistant. This one page covers everything from connection to daily operation.

MCP in 5 min (recommended)Developer API Per-tool guides Task recipes Troubleshooting & security API reference →

MCP connection (recommended — no key pasting)

Taviro exposes an MCP server. MCP-capable AIs just add it as a connector and log in — no API key to issue or paste. Simplest and safest.

Claude (web / desktop)

Add a connector

Settings → Connectors → Add custom connector, URL https://taviroglobal.com/mcp → a Taviro login page opens; sign in and Allow. Then just say "list this product on Taviro".

Claude Code (terminal)

One command

claude mcp add --transport http taviro https://taviroglobal.com/mcp, then authenticate once via /mcp.

ChatGPT (Web / Desktop)

Add a connector

Settings → Connectors → Add, enter https://taviroglobal.com/mcp (requires a connector-capable plan / developer mode) → log in to Taviro and approve. Then just talk to it.

Cursor / other MCP tools

Register the URL

Add https://taviroglobal.com/mcp (HTTP transport; bridge via mcp-remote above if HTTP isn't supported). Same OAuth login.

Available tools

Call listing_guide first

Product creation, catalog search & product-selection ranking (recommend_products), taxonomy search, image upload, store listing, inventory, orders/settlements, shipping. Call listing_guide first — the AI fetches the full listing manual by itself, including the photo-to-listing workflow and international-shipping options.

Auth is your Taviro account itself: suppliers see only their own products; sellers see the approved catalog and their own orders. Revoke connections anytime from the portal's AI & API tab (a password change revokes everything too).

Developer API connection (for your own systems, ERP & dev tools)

An API key is a credential for operating Taviro from developer tools, your own systems or an ERP that can store secrets. To connect a general AI chat (Claude, ChatGPT), use MCP above — no key to issue, and nothing to paste into the chat box.

Do not paste API keys into the chat body — store them in your tool's secret manager or an environment variable.

STEP 1

Issue a key

STEP 2

Store the secret

Save the key in your tool's secret manager or an environment variable (e.g. TAVIRO_API_KEY) — never in code or a prompt body.

STEP 3

Call from your own code/tool

Pass the key in each request's Authorization: Bearer header. Confirm destructive operations before executing.

Connection reference (for developers)

Key points when configuring your own system or dev tool — not something to paste into a general chat body.

Base URL: https://taviroglobal.com
API docs: GET https://taviroglobal.com/api/docs (fetch first to learn available operations)
Auth: HTTP header Authorization: Bearer <API key from your secret store> (never hard-code it)
Requests/responses are JSON. Amounts are JPY integers.
Rate limit: 600 requests/hour; on 429, honor Retry-After.
For destructive operations (editing products, changing stock), confirm before executing.

Per-tool guides

Claude (web / desktop / Claude Code)

MCP (above) is the easiest: add connector → log in → done. No key to paste into the chat.
Dev tools (e.g. Claude Code): keep the API key in a secret manager or environment variable — don't paste it into a general chat (see Developer API).
Claude Code reads local CSVs and image folders directly — ideal for bulk work ("read products.csv in this folder and list everything", "list the product in these photos").

ChatGPT (Web / Desktop)

MCP (recommended): Settings → Connectors → Add https://taviroglobal.com/mcp (connector-capable plan / developer mode) → log in to Taviro and approve → then say "read Taviro's listing_guide and list the product in this photo".
Key-based access is for dev tools and your own systems: store the key in a secret manager / environment variable, never in the chat body (see Developer API).
Save recurring workflows to custom instructions or a GPT.

Local AI / your own agent

Any OpenAI-compatible local AI (LM Studio, Ollama, …) with an HTTP tool can connect; configure it per the Developer API points and load the key from an environment variable.
Smoke test: curl -H "Authorization: Bearer $TAVIRO_API_KEY" https://taviroglobal.com/api/ops/summary — JSON back means auth works (key read from the environment).

Task recipes (copy & use)

List from photos (supplier)

Look at these product photos and list the item following Taviro's listing_guide: find the category via search_categories, write the title and copy in Japanese, cost ¥1200, suggested price ¥2980, stock 40. Report the product id.

AI product selection (seller)

Use recommend_products to find items shippable to North America with margin ≥30%, table the top 10 by 30-day sales. List my picks to my store at 2.5× cost.

Bulk listing (supplier)

Register the following products on Taviro one by one and summarize the results in a table. Fulfillment: supplier-direct for all.
name / category / cost / price / stock / SKU
(paste your list here)

Weekly sales checkFetch Taviro order data and give me this week's order count, revenue total, and top-3 sellers by product.

Bulk stock adjustment (supplier)

Adjust these SKUs to actual stock. Show me the diffs first and execute only after I approve.
DJP-MAT-01: 45 / DJP-CUP-02: 120 / DJP-BOX-03: 8

Settlement export (supplier)Fetch this month's settlement data (accounting CSV) and tell me the unpaid total and payment schedule.

Role-by-role playbook

Supplier

List from photos

List this product on Taviro from the attached photos. Cost ¥1200, retail ¥2980, stock 40, SKU IMB-TWL-01, ~420g, supplier-direct. Pick the category and attributes yourself, write a Japanese title (≤60 chars) and honest copy, upload all photos. Show me everything for approval BEFORE creating.

Reconcile stockSet these SKUs to actual stock — show diffs first, execute after my OK. IMB-TWL-01: 45 / MNO-CUP-02: 120

ShipList unshipped orders, then mark O-31 shipped with tracking 1234-5678-9012 via Yamato.

Seller

Pick productsUse recommend_products: 5 lifestyle items for women 20-30 with ≥35% margin, plus one TikTok angle each.

List with my priceImport P-13 to my store at ¥6,980. Confirm details with me before executing.

Morning brief

Report today's Taviro status: new orders, unpaid charges total, my listed products under 10 stock. Say "all clear" if nothing needs me.

Warehouse

Pick list & ship

Table today's unshipped orders (product, qty, prefecture). Then ship O-31 and O-32 with tracking 1111-2222-3333 / 4444-5555-6666 via Sagawa.

InboundRecord inbound for P-20: 50 received, 2 defective, book 48.

Three rules: always include numbers (price/stock/SKU/order id); say "confirm before executing" for any write; when unsure ask "what can you do on Taviro?".

Troubleshooting

Symptom / error	Cause & fix
`401 AUTH_REQUIRED`	Wrong or revoked key. Check the `Authorization: Bearer tvk_...` format; issue a new key if needed.
`403 FORBIDDEN`	Operation outside the key owner's role (e.g. listing with a supplier key). Issue a key from the right account.
`422 SELLING_PRICE_BELOW_COST`	Retail price below supplier cost — set it at or above cost.
`429 RATE_LIMITED`	600 req/hour cap reached. Wait `Retry-After` seconds; long-running agents should poll less often.
"localhost refused to connect" after MCP login	Taviro's authorization succeeded — the local receiver (mcp-remote) wasn't listening. 1) Retry (first-run npx download can outlast the auth page). 2) Pin a fixed port: `args = ["-y", "mcp-remote@latest", "https://taviroglobal.com/mcp", "33418"]`. 3) The AI tool and the browser must be on the SAME machine (remote server/Docker → use the API-key method). 4) Node ≥18; check security software blocking local ports.
The AI says it can't send requests	No (or disabled) tool execution. Use Claude Code or another tool-capable environment.
Changes don't reach Shopify	Editing a live product sends it back to review; it syncs after re-approval.

Security: API keys are passwords. Do not paste API keys into the chat body — store them in your tool's secret manager or an environment variable. Never leave keys in shared chats, screenshots or code repositories. Check a key's scope when issuing it, and review its created and last-used timestamps (when available) in the portal's AI & API tab. Revoking a key stops every integration that uses it immediately. Confirm write operations (inventory changes, shipping) before executing, and issue one key per use-case to minimize blast radius.

← Taviro トップへ / Back to top

MCP 接続（推奨・キー貼り付け不要）

コネクタに追加

コマンド 1 行

コネクタに追加

URL を登録

まず listing_guide を

開発者向け API 接続（自社システム・ERP・開発ツール向け）

API キーを発行

シークレットに保存

自分のコード／ツールから呼ぶ

接続の要点（開発者リファレンス）

ツール別の詳しい手順

タスク例文集（コピーしてそのまま使えます）

ロール別 実践プレイブック（保存版）

サプライヤー編 — 出品・在庫・出荷・精算

セラー（販売パートナー）編 — 選品・出品・売上管理

倉庫パートナー編 — 入庫・ピッキング・出荷

上手な頼み方 3つのコツ

トラブルシューティング

MCP 接入（推荐 · 无需粘贴密钥）

添加连接器

一行命令

添加连接器

登记 URL

先调 listing_guide

开发者 API 接入（自有系统 · ERP · 开发工具）

签发密钥

存入密钥库

从自己的代码/工具调用

接入要点（开发者参考）

分工具教程

任务示例（可直接复制使用）

分角色实战手册（收藏版）

供应商篇 — 上架、库存、发货、结算

卖家篇 — 选品、上架、看生意

仓库篇 — 入库、拣货、出库

让 AI 好用的三个诀窍

故障排查

MCP connection (recommended — no key pasting)

Add a connector

One command

Add a connector

Register the URL

Call listing_guide first

Developer API connection (for your own systems, ERP & dev tools)

Issue a key

Store the secret

Call from your own code/tool

Connection reference (for developers)

Per-tool guides

Task recipes (copy & use)

Role-by-role playbook

Supplier

Seller

Warehouse

Troubleshooting

ロール別実践プレイブック（保存版）