AI・API接続ガイドAI 与 API 接入指南AI & API connection guide

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

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

浏览器授权总是失败？用 API 密钥直连（无需 OAuth）

登录后反复出现「localhost 拒绝访问」、AI 工具与浏览器不在同一台电脑、或运行在 Docker / 远程环境——这些情况请把 API 密钥直接放在请求头里。不经过授权页和回调，一定能连上；权限就是密钥所属账号本身。

1. 在供应商／卖家后台的「API 密钥（高级）」发一把密钥，记下只显示一次的 tvk_…。
2. 在 AI 工具的 MCP 配置里用 --header 传入（下面是 Claude Desktop 的 claude_desktop_config.json 示例；Authorization: 后不留空格是 Claude Desktop 参数解析的要求）。
3. 重启应用。不会弹出授权页，直接出现工具列表。

{
  "mcpServers": {
    "taviro": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://taviroglobal.com/mcp", "--header", "Authorization:${TAVIRO_AUTH}"],
      "env": { "TAVIRO_AUTH": "Bearer tvk_在此填写密钥" }
    }
  }
}

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

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

接入要点（开发者参考）

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

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

分工具教程

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

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

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

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

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

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

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

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

让 AI 好用的三个诀窍

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

故障排查

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.

Browser approval keeps failing? Connect with an API key (no OAuth)

If you keep seeing “localhost refused to connect” after logging in, if the AI tool and the browser are on different machines, or if you run inside Docker or on a remote host, pass an API key in the request header instead. No consent screen, no callback — it simply connects, with exactly the permissions of the key's owner.

1. Create a key under “API keys (advanced)” in your supplier / seller portal and copy the tvk_… value shown once.
2. Pass it with --header in your MCP tool's config (Claude Desktop claude_desktop_config.json shown; no space after Authorization: because of how Claude Desktop parses arguments).
3. Restart the app. No approval page opens; the tool list appears directly.

{
  "mcpServers": {
    "taviro": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://taviroglobal.com/mcp", "--header", "Authorization:${TAVIRO_AUTH}"],
      "env": { "TAVIRO_AUTH": "Bearer tvk_your-key-here" }
    }
  }
}

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.

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

Task recipes (copy & use)

Role-by-role playbook

Supplier

Seller

Warehouse

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