MCP 服务器：在 AI 应用中使用图像、视频和语音

让 Claude、ChatGPT、Cursor、VS Code 等 AI 应用使用 Zurelay 的图片、视频和语音模型。只需连接一次 MCP 服务器并登录，即可在聊天中要求生成图片、视频片段或配音：内容由 Nano Banana、GPT Image、Seedance、Kling、Wan 或 Gemini TTS 生成，费用从你的 Zurelay 余额中扣除，与 API 同价。

https://api.zurelay.com/mcp

这是一个远程服务器（Streamable HTTP），无需安装。在应用中登录，或发送 API key 即可。它已收录于官方 MCP Registry，名称为 com.zurelay/mcp。

功能介绍

这里不将聊天模型作为工具提供：由模型驱动的应用本身就已接入模型。要让 Claude Code、Cursor 或其他应用使用 Zurelay 的聊天模型，只需修改其 base URL（参见集成）。

连接你的应用

以下应用均支持登录：在 zurelay.com 授权一次即可，无需粘贴密钥。不支持登录的应用，或不宜打开浏览器的环境（服务器、CI），则发送 API key。

Claude（网页版、桌面端和移动端）

点击将 Zurelay 添加到 Claude，即可打开已填好的表单。也可以手动添加:

1. 前往自定义，打开连接器，选择添加，再选择添加自定义连接器。
2. 将名称设为 Zurelay，并将 https://api.zurelay.com/mcp 粘贴为 MCP 服务器 URL。两种 OAuth 客户端选项均可：使用 Claude 的公开身份或自动注册。然后添加。
3. 选择连接。Zurelay 打开后，登录、设置每日消费限额，再选择允许。
4. 在聊天中打开 +，再打开连接器，启用 Zurelay，然后直接提出需求：“制作一张 16:9 的海报，内容是…”、“把这张图做成 5 秒短片”、“用平静的语气朗读这段文字”。

所有套餐均可在网页版、桌面端和手机上使用连接器（Free 支持一个自定义连接器）。Team 和 Enterprise 的所有者需在组织设置的连接器中添加 Zurelay（添加、自定义、网页）；然后各成员分别连接自己的 Zurelay 账号。

Claude Code

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp

然后在 Claude Code 中输入 /mcp，选择 zurelay，并在打开的浏览器中登录（或运行 claude mcp login zurelay）。也可以使用 API key，无需浏览器:

claude mcp add --scope user --transport http zurelay https://api.zurelay.com/mcp \
  --header "Authorization: Bearer $ZURELAY_API_KEY"

--scope user 会为所有文件夹添加此服务器。省略该选项后，只有在添加时所在的文件夹中运行 Claude Code，才会显示此服务器；也可以使用 --scope project，通过项目的 .mcp.json 共享（不要将密钥写入共享文件：.mcp.json 会从环境中读取 ${ZURELAY_API_KEY}）。请在普通终端中运行命令，不要在 Claude Code 内运行；如果 Claude Code 已打开，请重启。

ChatGPT

1. 在设置的安全与登录中启用开发者模式（适用于 Plus、Pro、Business、Enterprise 和 Edu；可能需要工作区管理员先行允许）。
2. 打开 ChatGPT Plugins，点击 +。将名称设为 Zurelay，连接 URL 填入 https://api.zurelay.com/mcp，并使用 OAuth。
3. 登录 Zurelay 并选择允许。在聊天中打开 +，选择开发者模式，再选择 Zurelay。

ChatGPT 仅支持登录，无法发送 API key。

Cursor

将 Zurelay 添加到 Cursor，然后在 Cursor 的 MCP 设置中，点击它旁边的连接以登录。也可以将其添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）:

{
  "mcpServers": {
    "zurelay": {
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

VS Code

将 Zurelay 添加到 VS Code，或将其添加到项目中的 .vscode/mcp.json（也可以从命令面板运行 MCP: Add Server 并选择 HTTP）。Copilot 的智能体模式首次使用它时，VS Code 会提示你登录。如果使用 API key，则只需按提示输入一次，密钥会加密保存:

{
  "servers": {
    "zurelay": {
      "type": "http",
      "url": "https://api.zurelay.com/mcp"
    }
  }
}

AI 智能体

常驻智能体和个人智能体也可以用同样的方式添加服务器：向 Grok Bot 和 Meta Muse 发送添加请求，通过 ChatGPT 的插件为 OpenAI dots 添加，或在 Gemini Spark、Manus 和 Perplexity 的连接器设置中添加。OpenClaw 和 Hermes Agent 也支持连接，还可以使用 Zurelay 的技能，通过你授权的链接获取各自专用的密钥。各智能体的操作步骤见 AI 智能体。

Codex、Gemini CLI 和其他应用

任何支持通过 Streamable HTTP 使用 MCP 的应用都可以连接。Codex 使用 codex mcp login zurelay 登录，Gemini CLI 使用 /mcp auth zurelay 登录；如果使用密钥，大多数应用都支持通过 Authorization 请求头发送:

# or: codex mcp add zurelay --url 'https://api.zurelay.com/mcp' --bearer-token-env-var ZURELAY_API_KEY
[mcp_servers.zurelay]
url = "https://api.zurelay.com/mcp"
bearer_token_env_var = "ZURELAY_API_KEY"

登录或使用 API key

登录更简单，也更安全。应用会打开 zurelay.com，你可以用邮件验证码登录，选择扣费的工作区并设置每日消费限额，然后授权。Zurelay 随后会在你的密钥页面添加一个以应用命名的密钥，例如“Claude (MCP)”，并应用该限额。应用始终不会接触到 API 密钥：它持有的是有效期为一小时的 token，以及每次使用都会更换的刷新 token，两者都只能用于 MCP 服务器，不能用于 API 的其他接口。你可以在密钥页面修改限额，或撤销密钥以断开应用连接。

API 密钥放在 Authorization: Bearer zr_live_… 请求头中。密钥上的所有设置都会生效：预算、速率限制、允许的模型和允许的 IP 地址。建议为应用单独创建一个密钥并设置每日预算，避免 agent 在忙碌时超出你的预期支出（参见密钥限额与规则）。Claude 和 ChatGPT 等应用从各自的服务器发起调用，因此为这些应用创建密钥时，请将允许的 IP 地址留空。

价格、链接与等待时间

• 价格与 API 相同：可在模型页面查看各模型价格，也可以让 AI 调用 list_models 查询。请求失败不收费，视频仅在生成完成后收费。
• 工具会在约 35 秒内返回响应。图片和语音通常能在这段时间内完成；耗时更长的任务（大多数视频）会先返回一个 id，AI 随后调用 get_result，每次最多再等待 45 秒。
• 结果以指向我们存储空间的链接返回，有效期为 24 小时。图片和视频会在你的素材库中保留 30 天，每次请求也都会像其他请求一样显示在请求页面中。
• 图片还会附带一张小尺寸预览，方便 AI 查看生成结果并调整。你可以让它不返回预览，以节省上下文空间。

使用电脑上的文件

编辑图片或将单帧图片生成动画时，模型需要通过链接访问文件。已在线上的文件可以直接传入其 https 链接。对于电脑上的文件，能运行命令的应用（Claude Code、Cursor、Codex）会使用 create_upload_link：支持在 15 分钟内上传一个不超过 20 MB 的 PNG、JPEG、WebP、MP4、MOV、MP3 或 WAV 文件。返回的链接有效期为 2 小时，文件会在 2 天后删除。账户有余额才能获取上传链接。

# 1. The agent calls create_upload_link and gets a one-time URL.
# 2. It uploads the file with curl:
curl -sS -T ./product-photo.png 'https://api.zurelay.com/mcp/uploads/…'
# {"url":"https://…/inputs/2026-10-05/….png","type":"image/png","bytes":482113,…}
# 3. It passes that url to generate_image's reference_images or generate_video's first_frame.

安全性

• 登录遵循 MCP 规范：使用 OAuth 2.1 和 PKCE（仅支持 S256），只允许已注册的重定向地址，一次性授权码有效期为 5 分钟。同一授权码若被重复使用，通过该授权码换取的凭据也会失效。
• token 随机生成，存储时仅保留 SHA-256 哈希值。访问 token 有效期为一小时，且只能用于 MCP 服务器。刷新 token 每次使用都会更换；如果旧 token 在超过一分钟后再次被使用，就说明它已被复制，系统会断开连接并撤销对应密钥。
• 每个连接都对应密钥页面上的一个密钥，各有独立的每日限额，工作区成员均可查看。撤销密钥或退出工作区都会断开应用连接。
• 授权页面无法嵌入其他网站显示；如果应用未经 Zurelay 识别，页面会明确提示，并告知授权后将跳转到的地址。
• 上传链接带有签名，只能上传一个文件，15 分钟后失效；上传的文件会在 2 天后删除。
• 每个密钥和工作区都有各自的 MCP 调用速率限制，批量请求中的每次调用都会单独计数。

开发者说明

服务器通过 Streamable HTTP 支持 MCP 2025-11-25（以及 2025-06-18、2025-03-26 和 2024-11-05）：向 https://api.zurelay.com/mcp POST JSON-RPC 请求，即可收到 JSON 响应。服务器不保留会话，因此不提供服务器发送事件（SSE），GET 会返回 405。未携带 token 时，服务器返回 401，并通过 WWW-Authenticate 指向 https://api.zurelay.com/.well-known/oauth-protected-resource/mcp；授权服务器的元数据位于 https://api.zurelay.com/.well-known/oauth-authorization-server，支持动态客户端注册。

curl https://api.zurelay.com/mcp \
  -H "Authorization: Bearer $ZURELAY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_image",
      "arguments": { "prompt": "A lighthouse at dusk, oil painting", "model": "nano-banana-pro" }
    }
  }'

故障排查

• Claude Code 的 /mcp 中没有 zurelay: 可能是添加到了其他文件夹，或添加时 Claude Code 已在运行。请退出 Claude Code，在普通终端中运行上面的命令（带上 --scope user），然后重新启动 Claude Code。登录前，claude mcp list 会显示需要身份验证。
• 应用反复要求登录: 应用创建的密钥已被撤销，或其登录授权已有一年未使用。重新连接即可。
• “你的 Zurelay 余额已用完”或“已达到每日预算”: 请在账单页面充值，或在密钥页面提高该密钥的限额。
• “此 token 属于通过 Zurelay MCP 服务器连接的应用”: 你向 API 发送了应用的 token。调用 API 时请使用 API 密钥。
• 视频似乎卡住了: 请让 AI 再次调用 get_result；视频通常需要 1 到 5 分钟，模型繁忙时可能更久。