跳至主要內容

適用於 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 帳號;訪客工作階段無法連接應用程式。

  1. 加入伺服器

    在終端機中執行此指令。

    claude mcp add --transport http mage https://mcp.mage.space/mcp
  2. 進行驗證

    在 Claude Code 中執行 /mcp,選擇 mage 並進行驗證。瀏覽器會開啟一個頁面,讓你登入 Mage 並選擇「連接」。

  3. 或使用 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 等無介面環境。
費用是多少?
連接是免費的,但帳號需要先完成一次成功付款,購買任一 Gem 包或訂閱任一方案皆可;註冊贈送的 Gems 僅限在 Mage 應用程式中使用。你的助理每次發起生成時,都會依照模型的標價,從你的 Mage 帳號扣除 Gems 來支付,而且助理在開始前可以用 estimate_cost 回報價格。
我的助理會使用哪些模型?
除非你指定模型,否則你的助理會用 Mango 4 生成圖片、用 Cherry 2 Pro 生成影片、用 Seed Audio 生成音訊。你也可以直接說出名稱,指定任何其他 Mage 模型。
連接我的 Mage 帳號安全嗎?
在分享任何內容之前,Mage 會先顯示應用程式的名稱、網站和返回位置,且每次連接都需要你的核准。你隨時可以在 MCP → 已連接的應用程式中中斷任何應用程式的連接。

開始使用 Mage 打造你的作品

一個帳號、一份 Gems 餘額,通用所有模型。只需為你生成的內容付費。

Characters社群