適用於 Claude Code 的 Mage
在 Claude Code 中生成圖片、影片與音訊
在終端機與編輯器中將 Mage 連接到 Claude Code,用簡單的白話就能要求生成圖片、影片與音訊。Claude Code 會挑選模型、告知價格,並帶回結果。
https://mcp.mage.space/mcp重點速覽
要在 Claude Code 中使用 Mage,請新增 Mage MCP 伺服器(https://mcp.mage.space/mcp),並用你的 Mage 帳號登入。之後 Claude Code 就能用 Mango 4 生成圖片、用 Cherry 2 Pro 生成影片、用 Seed Audio 生成音訊,或使用你指定的任一款 Mage 模型(共 37 款),依每次生成以 Gems 計費。
- 16MCP 工具
- 37圖片、影片與音訊模型
- 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 中使用 Mage
在 Claude 網頁版、桌面應用程式、行動應用程式和 Cowork 中生成圖片、影片與音訊。
在 ChatGPT 中使用 Mage
以個人 MCP 應用程式的方式,在 ChatGPT 中生成圖片、影片與音訊。
Grok 中的 Mage
透過自訂連接器,在 Grok 中生成圖片、影片和音訊。
Cursor 中的 Mage
在 Cursor 的 Agent 模式中生成圖片、影片和音訊。
常見問題
常見問題
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 等無介面環境。
費用是多少?
連接是免費的,但帳號需要先完成一次成功付款,購買任一 Gem 包或訂閱任一方案皆可;註冊贈送的 Gems 僅限在 Mage 應用程式中使用。你的助理每次發起生成時,都會依照模型的標價,從你的 Mage 帳號扣除 Gems 來支付,而且助理在開始前可以用 estimate_cost 回報價格。
我的助理會使用哪些模型?
除非你指定模型,否則你的助理會用 Mango 4 生成圖片、用 Cherry 2 Pro 生成影片、用 Seed Audio 生成音訊。你也可以直接說出名稱,指定任何其他 Mage 模型。
連接我的 Mage 帳號安全嗎?
在分享任何內容之前,Mage 會先顯示應用程式的名稱、網站和返回位置,且每次連接都需要你的核准。你隨時可以在 MCP → 已連接的應用程式中中斷任何應用程式的連接。
開始使用 Mage 打造你的作品
一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。