让编码代理把图片变成可编辑文件。

1. 创建 API 密钥

使用 Google 登录后打开 https://unraster.ai/developers/api-keys。请妥善保管密钥：它会消耗您账户的积分。建议存入名为 UNRASTER_API_KEY 的环境变量。

export UNRASTER_API_KEY="your-api-key"

2. 连接 MCP 服务器

服务器地址：https://unraster.ai/mcp（Streamable HTTP，无状态）。每个请求都带上请求头 Authorization: Bearer $UNRASTER_API_KEY。

Claude Code

claude mcp add --transport http unraster https://unraster.ai/mcp \
  --header "Authorization: Bearer $UNRASTER_API_KEY"

执行命令时由 shell 代入密钥，Claude Code 会把它保存在自己的配置里。

Cursor

写入 ~/.cursor/mcp.json（或项目内的 .cursor/mcp.json）。Cursor 会从环境变量读取密钥。

{
  "mcpServers": {
    "unraster": {
      "url": "https://unraster.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:UNRASTER_API_KEY}"
      }
    }
  }
}

Codex

写入 ~/.codex/config.toml。Codex 会把 UNRASTER_API_KEY 的值作为 Bearer 令牌发送。

[mcp_servers.unraster]
url = "https://unraster.ai/mcp"
bearer_token_env_var = "UNRASTER_API_KEY"

其他 MCP 客户端

任何支持 Streamable HTTP 服务器的客户端，都可以使用同样的地址和 Authorization 请求头。

技能包

安装 Claude Code 插件，即可同时获得这个 MCP 服务器和一个现成的图片转 PowerPoint 技能。它使用同一个 API 密钥（UNRASTER_API_KEY）。

claude plugin marketplace add zane-labs/agent-skills
claude plugin install unraster@zane-agent-skills

工具

积分

• 新 API 账户第一次 PowerPoint 转换免费：每个账户、每个 Google 登录账号限一次，outputs 只选 pptx。转换失败不会用掉这次免费机会。
• SVG：1 积分。PowerPoint：2 积分。两者都要：3 积分。
• 只有交付的文件才扣积分，失败的转换不扣积分。
• 报价、查询进度和下载都免费。

查看订阅与积分包

限制

• 仅支持 PNG、JPEG 和 WebP。
• 通过链接获取的图片最大 25 MiB；base64 图片解码后最大 5 MB。
• 图片链接必须是 https，并指向公网地址；私有和内网地址会被拒绝。
• 下载链接有效期 7 天，任何拿到链接的人都能下载，请不要公开分享。

示例指令

把 https://example.com/slide.png 转成可编辑的 PowerPoint，并把下载链接给我。

查一下把 ./chart.png 同时转成 SVG 和 PPTX 需要多少积分。

把这张截图转成 SVG，下载后保存到 assets/logo.svg。

最后一条指令中，代理会先转换图片，再从返回的链接下载文件。

常见问题