接入指南
在 AI 工具裡直接用 Shopix
你可以在 Claude Code、Codex、Cursor 和其他 MCP 用戶端裡直接呼叫 Shopix,生成商品主圖和詳情圖。不需要先打開網頁工作台,對 AI 說人話就行。
打開 Shopix,產生接入金鑰三步接入
01
產生接入金鑰
登入 Shopix,點工作台右上角的終端機圖示,產生一把接入金鑰。完整金鑰只會顯示一次,請立刻複製。
02
跑一行命令
把對應工具的接入片段貼進去。Claude Code 是一條終端機命令,Codex 寫進設定檔,Cursor 寫進 MCP 設定。
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 的用戶端也可以用同一套網址和金鑰。