接入指南

在 AI 工具裡直接用 Shopix

你可以在 Claude Code、Codex、Cursor 和其他 MCP 用戶端裡直接呼叫 Shopix,生成商品主圖和詳情圖。不需要先打開網頁工作台,對 AI 說人話就行。

打開 Shopix,產生接入金鑰

三步接入

  1. 01

    產生接入金鑰

    登入 Shopix,點工作台右上角的終端機圖示,產生一把接入金鑰。完整金鑰只會顯示一次,請立刻複製。

  2. 02

    跑一行命令

    把對應工具的接入片段貼進去。Claude Code 是一條終端機命令,Codex 寫進設定檔,Cursor 寫進 MCP 設定。

  3. 03

    對 AI 說人話

    例如:「用這張商品圖出 4 張 Amazon 主圖」。平台、張數、檔位沒說全也沒關係,會依預設值走。

各工具怎麼接

Claude Code

在終端機執行下面這一行,然後直接讓 Claude 幫你出 Shopix 主圖或詳情圖。

claude mcp add --transport http shopix https://shopix-ai.company/api/mcp --header "Authorization: Bearer <YOUR_KEY>"

Codex

把這段寫進 ~/.codex/config.toml。Codex 桌面版和命令列都可以用。

# Codex 桌面 / CLI 通用
[mcp_servers.shopix]
url = "https://shopix-ai.company/api/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_KEY>" }

Cursor

把這段合併進 Cursor 的 MCP 設定,儲存後即可在對話裡呼叫 Shopix。

{
  "mcpServers": {
    "shopix": {
      "url": "https://shopix-ai.company/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

其他 MCP 用戶端

只要用戶端支援 HTTP MCP,就可以用同一套網址和金鑰:網站 /api/mcp,請求頭 Authorization: Bearer 你的金鑰。

預設值

項目預設
平台通用,除非你在對話裡點名某個平台
張數主圖預設 4 張
檔位實用版,和網頁端同一檔
從對話識別AI 會從你的話裡識別平台、張數和檔位

點數和計費

出圖按網頁端同一套點數規則扣費,真正開始生成時才扣。任務失敗或逾時,會依現有規則退回沒用掉的點數。產生金鑰本身不扣點數。

常見問題

完整金鑰只顯示一次,弄丟了怎麼辦?

重新產生一把即可。舊金鑰會立刻失效,記得把 AI 工具裡的設定換成新的。

企業子帳號能用嗎?

不能。請用主帳號登入後再產生金鑰。

會額外扣點數嗎?

金鑰本身不收費。真正出圖時,點數和網頁端一樣。點數不夠時會提示去儲值。

沒說平台、張數或檔位會怎樣?

依預設值走:平台按通用、主圖預設 4 張、檔位按實用版。你如果在話裡提到了,AI 會照你說的來。

只支援這三個工具嗎?

Claude Code、Codex、Cursor 是我們寫好步驟的三個。其他支援 MCP 的用戶端也可以用同一套網址和金鑰。