重點速覽
要在 Cursor 中使用 Mage,請新增 Mage MCP 伺服器 (https://mcp.mage.space/mcp),並用你的 Mage 帳號登入。之後 Cursor 就能用 Mango 3 生成圖片、用 Cherry 2 Pro 生成影片、用 Seed Audio 生成音訊,或指定 28 種 Mage 模型中的任何一種,每次生成以 Gems 計費。
16
MCP 工具
28
圖片、影片與音訊模型
5
支援的助理
$0
連接所需時間
設定
如何將 Mage 連接到 Cursor
需要有 Mage 帳號;訪客工作階段無法連接應用程式。
一鍵安裝
選取「將 Mage 新增至 Cursor」,即可安裝內含公開 OAuth 用戶端 ID 的伺服器。如果已經安裝過 Mage,請替換原本的設定。
或手動加入 mcp.json
若要手動設定,請將這個項目加入 ~/.cursor/mcp.json。用戶端 ID 是公開的,不需要密鑰。
{ "mcpServers": { "mage": { "url": "https://mcp.mage.space/mcp", "auth": { "CLIENT_ID": "https://cursor.com/mcp", "scopes": [ "mage", "offline_access" ] } } } }登入並開始提問
出現提示時,用你的 Mage 帳號完成驗證,接著在 Agent 模式下請 Cursor 為你的專案生成媒體內容。
試試看
在 Cursor 中使用 Mage 的提示範例
- 為種子資料生成預留位置的商品照片,並儲存到 /public/products。
- 製作三種風格的應用程式圖示,並加入設計資料夾。
- 為空白狀態製作一段簡短的新手引導影片。
工具
助理可呼叫的 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 助理
常見問題
常見問題
在 Cursor 中可以用 API 金鑰取代 OAuth 嗎?
可以。將伺服器項目設為該 URL,並加上 headers: { "Authorization": "Bearer ${env:MAGE_API_KEY}" },金鑰則存放在你的環境變數中。
什麼是 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 餘額,通用所有模型。只需為你生成的內容付費。