跳至主要内容

适用于 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 生成音频,或使用你指定的任意 37 个 Mage 模型,按每次生成用 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社区