一览
要在 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 余额,畅用所有模型。按生成量付费,用多少付多少。