Mage

官方

使用多種前沿模型生成 AI 圖像、影片和音訊，預設即為私密。

你可以用 Mage MCP 做什麼？

生成媒體 — 請你的助理建立圖像、影片或音訊片段，Gems 會從你的 Mage 帳戶扣款。
生成前先報價 — 讓你的助理先報出生成費用，這樣在你核准之前不會有任何扣款。
使用已儲存的角色與參照 — 提及像 @ana 或 @red-coat 這樣的代稱，讓生成內容重複使用你已儲存的角色、服裝、姿勢和語音片段。
檢視過往作品 — 要求查看你過去 30 天的生成內容，或依內容、收藏集或日期搜尋你已儲存的創作。
查看餘額並取消執行 — 查看你已連結帳戶的 Gems 餘額，或停止正在執行的生成（Gems 不會退還）。

託管 MCP 伺服器

npx add-mcp 'https://mcp.mage.space/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

從 Claude、ChatGPT、Grok 和 Cursor 使用 Mage

透過 Mage MCP 伺服器將 Claude、ChatGPT、Claude Code、Grok 或 Cursor 連接到你的 Mage 帳戶，然後請你的助理生成圖片、影片和音訊，並以 Gems 付費。

Mage MCP 伺服器會將 AI 助理連接到你的 Mage 帳戶。連接後，你可以請 Claude、ChatGPT、Claude Code、Grok 或 Cursor 挑選模型、查詢價格、生成圖片、影片或音訊片段，並取回結果。它也會讀取你的生成歷史記錄和已儲存的創作，並使用你儲存的角色和參考素材。

https://mcp.mage.space/mcp

[!WARNING]

你的助理啟動的每一次生成都會從你的帳戶以 Gems 付費。你的助理可以先查詢價格，你也可以隨時中斷連接。

連接你的助理

Claude

適用於網頁版 Claude、桌面應用程式、行動應用程式和 Cowork。

開啟 Connect Mage to Claude。連接器名稱和 URL 已為你填好。選擇 Add。
選擇 Connect。會開啟一個 Mage 頁面，如果你尚未登入，系統會要求你登入。
確認頁面顯示的是你正在連接的應用程式，然後選擇 Connect。你會返回 Claude。
在對話中，從 + 選單的 Connectors 底下開啟 Mage 連接器，然後提出你想製作的內容。

在 Team 或 Enterprise 方案中，需先由擁有者在 Organization settings → Connectors 底下新增連接器。Free 方案允許一個自訂連接器。

ChatGPT

從 ChatGPT 的 Plugins 頁面將 Mage 新增為個人外掛。

開啟 ChatGPT Plugins。
點擊 Add，然後選擇 Create MCP App。
在 Name 輸入 Mage，在 Server URL 輸入 https://mcp.mage.space/mcp，並在 Authentication 選擇 OAuth。將 Advanced OAuth settings 留空；不需要 client ID 或 client secret。圖示和描述為選填。
檢閱通知，勾選 I understand and want to continue，然後點擊 Create。
在開啟的頁面登入 Mage，確認應用程式的名稱，然後選擇 Connect。
從你的 Personal 外掛安裝 Mage，開始一個 Work 對話，並提及 @Mage。

[!NOTE]

如果找不到 Create MCP App，請在 ChatGPT 的 Settings → Security and login 中開啟 Developer mode，然後返回 Plugins。詳情請參閱 ChatGPT 的設定指南。

Claude Code

新增伺服器，然後從 Claude Code 登入：

claude mcp add --transport http mage https://mcp.mage.space/mcp

在 Claude Code 中執行 /mcp，選擇 mage，然後進行驗證。會開啟一個瀏覽器頁面，讓你登入 Mage 並選擇 Connect。

若要改用 API 金鑰而非登入：

claude mcp add --transport http mage https://mcp.mage.space/mcp \
  --header "Authorization: Bearer $MAGE_API_KEY"

Grok

將 Mage 新增為自訂 MCP 連接器。

開啟 Grok connectors，選擇 New Connector，然後選擇 Custom。
輸入 https://mcp.mage.space/mcp 並完成驗證提示，以連接你的 Mage 帳戶。
開始對話，並請 Grok 使用 Mage 建立圖片、影片或音訊。

在 Grok Business 或 Enterprise 中，需先由團隊管理員在雲端主控台中佈建連接器。

Cursor

此按鈕會使用其公開 OAuth client ID 安裝 Mage；出現提示時登入 Mage。如果已安裝 Mage，請將其現有設定替換為此連結中的設定。如果按鈕沒有作用，請改為開啟網頁安裝連結：它會從瀏覽器開啟 Cursor，並顯示相同的設定供你手動新增。

若要手動設定，請將此項目新增至 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "auth": {
        "CLIENT_ID": "https://cursor.com/mcp",
        "scopes": [
          "mage",
          "offline_access"
        ]
      }
    }
  }
}

client ID 是公開的，不需要 client secret。Cursor 使用靜態 OAuth 設定來開啟 Mage 的同意頁面。

你也可以使用 API 金鑰連接：

{
  "mcpServers": {
    "mage": {
      "url": "https://mcp.mage.space/mcp",
      "headers": { "Authorization": "Bearer ${env:MAGE_API_KEY}" }
    }
  }
}

當應用程式透過登入連接時，Mage 會在分享任何內容之前顯示要求者是誰：應用程式的名稱、來源網站，以及你之後返回的位置。訪客工作階段無法連接應用程式；請先使用你的 Mage 帳戶登入。

你的助理可以做什麼

工具	功能
`list_models`	列出推薦的模型及其價格、各自最適合的用途和取捨；其餘模型則依要求提供。
`get_model`	描述單一模型：其欄位、允許值、預設值、規則和價格。
`estimate_cost`	在生成開始前計算價格。不會收取任何費用。
`create_upload`	取得簽署連結，以便從你的電腦上傳檔案，供可執行命令的助理使用。
`generate`	啟動生成，以 Gems 付費。
`get_request`	等待生成完成並傳回結果連結。
`cancel_request`	停止執行中的生成。Gems 不會退還。
`get_account`	顯示已連接的帳戶及其 Gems 餘額。
`list_characters`	列出你的角色及其 `@handle`。
`create_character`	從圖片連結儲存私人角色，可選擇附上語音片段。
`delete_character`	刪除你的其中一個角色。
`list_references`	列出你的服裝、姿勢、地點、物件和語音片段，可列出全部或單一類型。
`create_reference`	從圖片或音訊連結儲存私人參考素材。
`delete_reference`	刪除你的其中一個參考素材。
`list_history`	列出你過去 30 天的生成記錄，包括你自己在 Mage 中製作的生成。
`search_creations`	依內容、收藏集或日期搜尋你儲存的創作。

在請求中以代號提及已儲存的角色或參考素材，例如「Make a portrait of @ana wearing @red-coat」，你的助理會將其傳遞給模型。

技能

Mage 技能會在這些工具之上教導你的助理完成完整工作：產品攝影、市集刊登、廣告變化版本、UGC 和無臉影片、YouTube 縮圖，以及 Mage 應用程式，從換臉和重新打光到影片編輯和對嘴。使用 npx skills add mage-space/skills 新增它們，或在 mage.space/skills 瀏覽附範例的技能。

你的助理使用哪個模型

除非你指定模型，否則你的助理會使用 Mango 3 製作圖片、使用 Cherry 2 Pro 製作影片，並使用 Seed Audio 製作音訊。它會在開始前告知你模型和價格，並在產生結果後，當某個替代方案的取捨更適合你正在做的事時，建議一個替代方案。

	圖片	影片
預設	Mango 3	Cherry 2 Pro
同系列	Mango 3S（較便宜，最高 3K）、Mango 2（最高 4K）、Mango	Cherry Pro（4K）、Cherry、Cherry Mini（最便宜的 Cherry）
其他推薦	Guava 2 Pro 和 Guava 2（寫實）、GPT Image 2.5 Flare（文字和精確編輯）	Lemon（首尾影格，片段最長 30 秒）

其他所有模型只會在你指名要求時執行，例如「make it with Melon」或「use Nano Banana 2」。當某個模型更適合某項請求時，你的助理可能會建議它，例如用動漫模型製作動漫片段，並等待你的答覆。我該使用哪個模型？會比較所有模型。

Cherry 2 Pro 是 Mage 功能最強大也最昂貴的影片模型，其價格會隨解析度和長度急遽上升。在草擬階段請要求使用 Cherry Mini 或 Lemon。

生成如何運作

你的助理會如上所述使用 list_models 挑選模型，並使用 get_model 讀取其欄位。
它會使用 estimate_cost 查詢價格，這也會攔截模型會拒絕的請求。影片的價格取決於其長度：Mage 在報價時會測量已在 Mage 上的影片，例如已上傳的檔案或先前的結果，而從其他網站連結的影片則只在生成開始時測量。
它會使用 generate 啟動生成，這會從你的 Gems 扣款。每次生成都帶有你的助理自行產生的金鑰，因此連線中斷後重試會傳回相同的生成，而不會重複付費。
它會使用 get_request 等待，直到結果就緒並提供你連結。

結果會保留 30 天：請下載你想保留的內容，或將其儲存在 Mage 中。被審核標記為 NSFW 的結果會如此標示。請參閱 Requests 了解生成經歷的狀態，以及 Billing 了解 Gems 的收費方式。

圖片和檔案

媒體輸入，例如首個影格、參考圖片或要編輯的影片，都是連結：指向檔案本身的公開 https 連結，或最大約 3 MB 的 data URL。

Claude Code、Cursor 和其他可執行命令的助理 可以從你的電腦上傳檔案：它們會使用 create_upload 取得簽署的上傳連結，將檔案傳送到該連結，然後像使用任何其他連結一樣使用該檔案的新連結。檔案最大可達 100 MB，並會在 30 天後刪除。每次上傳只保留一個檔案：修正後的檔案會作為新的上傳，因為舊連結最多可能持續顯示第一個檔案達 4 小時。
Claude、ChatGPT 和 Grok 對話 無法將你附加到對話的檔案傳遞給 Mage。請改為分享檔案的直接連結，或使用已在 Mage 上的創作。
指向網頁的連結，例如 YouTube 或 TikTok 影片，不是檔案，會被拒絕。

管理已連接的應用程式

你連接的每個應用程式都會列在 MCP → Connected apps 中，並顯示你連接的時間和最後使用的時間。選擇 Disconnect 可立即停止應用程式；在你再次連接之前，它將無法再使用你的帳戶或花費你的 Gems。在浮動導覽中開啟 MCP，然後選擇 Connected apps。

限制

你的帳戶最多可同時執行 20 個生成，與 API 相同。
應用程式每分鐘最多可進行 120 次工具呼叫。
get_request 每次呼叫最多等待 2 分鐘；對於較長的生成，你的助理會再次呼叫它。

疑難排解

Cursor 顯示「Incompatible auth server: does not support dynamic client registration」：將 ~/.cursor/mcp.json 中現有的 Mage 項目更新為包含上述 Cursor 設定中的 auth 區塊，然後重新連接。僅有伺服器 URL 並不包含 Mage 預先註冊的 Cursor client ID。
「Couldn't reach the MCP server」：檢查 URL 是否完全為 https://mcp.mage.space/mcp，然後移除連接器並重新新增。
連線要求你再次登入：連線最長持續 180 天，之後應用程式會要求你再次核准。在 Mage 中中斷連接也會結束連線。
生成失敗並顯示 insufficient_gems：在 API → Billing 中新增 Gems，然後再試一次。

本文件建置並託管於 Mintlify，一個開發者文件平台。