重點速覽
要在 Claude Code 中使用 Mage,請加入 Mage MCP 伺服器 (https://mcp.mage.space/mcp) 並用你的 Mage 帳號登入。之後 Claude Code 就能用 Mango 3 生成圖片、用 Cherry 2 Pro 生成影片、用 Seed Audio 生成音訊,或使用你指定的 28 個 Mage 模型中的任何一個,並以 Gems 按每次生成付費。
16
MCP 工具
28
圖片、影片與音訊模型
5
支援的助理
$0
連接所需時間
設定
如何將 Mage 連接到 Claude Code
需要有 Mage 帳號；訪客工作階段無法連接應用程式。
加入伺服器
在終端機中執行此指令。
claude mcp add --transport http mage https://mcp.mage.space/mcp進行驗證
在 Claude Code 中執行 /mcp,選擇 mage 並進行驗證。瀏覽器會開啟一個頁面,讓你登入 Mage 並選擇「連接」。
或使用 API 金鑰
若想略過瀏覽器登入,可改為在標頭中帶入你的金鑰來加入伺服器。
claude mcp add --transport http mage https://mcp.mage.space/mcp \ --header "Authorization: Bearer $MAGE_API_KEY"
試試看
在 Claude Code 中使用 Mage 的提示詞範例
- 為這篇部落格文章生成一張 1200×630 的 Open Graph 圖片,並儲存到 public/og.png。
- 用我們的品牌色,為三個登陸頁區塊製作主視覺插圖。
- 上傳 assets/demo.mp4,並將它重新設計成水彩動畫風格。
- 為首頁製作一段 5 秒的循環背景影片。
工具
助理可呼叫的 16 項工具
| 工具 | 功能 |
|---|---|
| list_models | 列出推薦的模型,包含價格、各自最適合的用途與取捨。 |
| get_model | 說明單一模型的欄位、可用值、預設值、規則與價格。 |
| estimate_cost | 在生成開始前先報價,不會收取任何費用。 |
| create_upload | 取得簽署連結以上傳本機檔案,適用於能執行指令的助理。 |
| generate | 開始生成圖片、影片或音訊。 |
| get_request | 等待生成完成並回傳結果連結。 |
| cancel_request | 停止正在進行的生成。 |
| get_account | 顯示已連接的帳號及其 Gems 餘額。 |
| list_characters | 列出你儲存的角色及其 @handle。 |
| create_character | 從圖片儲存私人角色,也可以加上聲音。 |
| delete_character | 刪除你的其中一個角色。 |
| list_references | 列出你儲存的服裝、姿勢、地點、物件和聲音片段。 |
| create_reference | 從圖片或音訊連結儲存私人參考素材。 |
| delete_reference | 刪除你的其中一個參考素材。 |
| list_history | 列出你最近 30 天的生成紀錄,包含在應用程式中製作的內容。 |
| search_creations | 依內容、收藏集或日期搜尋你儲存的作品。 |
更多助理
Mage 適用於各大主流 AI 助理
常見問題
常見問題
Claude Code 可以為我的專案生成圖片嗎?
可以。透過 Mage MCP 伺服器,Claude Code 可以生成圖片、影片與音訊,並將結果下載到你的程式碼儲存庫。它也能用 create_upload 上傳專案中的檔案,例如要編輯的影片片段。
在 Claude Code 中該用 OAuth 還是 API 金鑰?
兩種都可以。OAuth 透過瀏覽器登入,不需要在 shell 中放置密鑰。API 金鑰適合 CI 和無介面的機器,以 Authorization: Bearer 標頭傳送即可。
什麼是 Mage MCP 伺服器?
這是位於 https://mcp.mage.space/mcp 的遠端 Model Context Protocol 伺服器,可讓 AI 助理使用你的 Mage 帳號生成圖片、影片和音訊。它提供 16 種工具,讓助理選擇模型、報價、生成、等待結果,並使用你儲存的角色、參考素材和歷史紀錄。
使用 MCP 伺服器需要 API 金鑰嗎?
不需要。Claude、ChatGPT、Grok、Cursor 和 Claude Code 都是透過 OAuth 登入 Mage 來連線。API 金鑰為選用,適用於 CI 等無介面環境。
費用是多少?
連接本身免費。你的助理每次開始生成時，會依模型標示的價格，從你的 Mage 帳號扣除 Gems；助理在開始前也能用 estimate_cost 報價。
我的助理會使用哪些模型？
如果你沒有指定模型，助理預設會用 Mango 3 生成圖片、Cherry 2 Pro 生成影片、Seed Audio 生成音訊。你也可以直接點名要求任何其他 Mage 模型。
連接我的 Mage 帳號安全嗎？
在分享任何內容之前，Mage 會先顯示應用程式的名稱、網站和返回位置，且每次連接都需要你的核准。你隨時可以在 MCP → 已連接的應用程式中中斷任何應用程式的連接。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。