面向开发者的 MCP 服务器

为 Claude Code、Cursor、Codex 和任何 MCP 客户端提供统一端点。用 API 密钥认证，按模型 ID 调用任意 PopNow 模型，每笔扣费都以 USD 确认。

端点

采用 Streamable HTTP，无需安装。将 API 密钥作为 Bearer 令牌发送。该密钥的模型白名单、IP 白名单和花费上限与 REST API 完全一致。

仅需 API 密钥，无需账号登录
以 USD 从 API 余额扣款
每分钟 240 次请求、20 个新任务

https://api.popnow.ai/api/v1/mcp

curl -X POST https://api.popnow.ai/api/v1/mcp \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

连接你的编程代理

将密钥保存在 POPNOW_API_KEY 中。切勿粘贴到提示词里，也不要提交到代码仓库。

claude mcp add --transport http popnow-api https://api.popnow.ai/api/v1/mcp \
  --header "Authorization: Bearer $POPNOW_API_KEY"

{
  "mcpServers": {
    "popnow-api": {
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POPNOW_API_KEY}"
      }
    }
  }
}

.cursor/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "popnow-api-key",
      "description": "PopNow API key (sk-popnow-...)",
      "password": true
    }
  ],
  "servers": {
    "popnow-api": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:popnow-api-key}"
      }
    }
  }
}

.vscode/mcp.json

[mcp_servers.popnow-api]
url = "https://api.popnow.ai/api/v1/mcp"
bearer_token_env_var = "POPNOW_API_KEY"

~/.codex/config.toml

{
  "mcpServers": {
    "popnow-api": {
      "serverUrl": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:POPNOW_API_KEY}"
      }
    }
  }
}

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "popnow-api": {
      "type": "http",
      "url": "https://api.popnow.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${POPNOW_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "popnow-api": {
      "command": "npx",
      "args": [
        "-y",
        "@popnow/mcp"
      ],
      "env": {
        "POPNOW_API_KEY": "sk-popnow-...",
        "POPNOW_MCP_URL": "https://api.popnow.ai/api/v1/mcp"
      }
    }
  }
}

适用于只能运行本地服务器的客户端：开源桥接程序会把 stdio 转发到此端点。

工具

具名工具使用合理的默认值。create_task 可以按模型的准确 ID 运行任意模型。

`create_task`	按模型的准确 API ID 运行任意模型，传入该模型自己的输入字段，调用方式与 POST /api/v1/jobs/createTask 相同。
`create_image · create_video · create_music · create_speech`	带默认值的具名工具，另有 edit_image、apply_effect、remove_background、upscale、add_sound，以及 extend_video、relight_photo 等单一用途工具。
`list_models`	准确的模型 ID、每个模型的输入项及其 USD 价格。
`get_task · list_tasks`	跟踪任务进度，列出使用此密钥创建的近期任务。
`check_balance`	此密钥钱包中可用与冻结的 USD 金额。
`compose_video`	将先前的结果剪辑成一个 MP4，可加入音乐、语音和字幕。免费。
`find_skills · install_skill`	选择一个技能包，然后获取其操作手册、下载链接和安装命令。
`run_my_recipe · get_recipe_run · resume_recipe_run`	运行你保存的配方与工作流。

每笔扣费都以 USD 确认

1报价
不带 max_usd 调用付费工具。返回 cost_usd 和 available_usd，此时不会扣费。
2确认
向用户展示价格。用户同意后，以相同参数再次调用该工具，并将 max_usd 设为报价中的 cost_usd。
3运行
任务开始时冻结相应金额，完成后结算。任务失败则释放冻结金额。

API 余额不足？请前往 API 控制台充值。

从旧地址迁移

发送到 https://api.popnow.ai/mcp 的 API 密钥将继续有效至 2027年1月31日，响应中带有 Deprecation 与 Sunset 头。在此之前，请把你的配置切换到上面的端点。

常见问题

需要安装任何东西吗？

不需要。这是远程服务器，只需添加地址和你的 API 密钥。开源桥接程序仅适用于只能运行本地服务器的客户端。

可以调用哪些模型？

PopNow API 目录中向 MCP 开放的图片、视频、音乐和语音模型。list_models 会列出准确的 ID 和输入项。

如何计费？

以 USD 计价，从该密钥对应的 API 余额中扣除，价格与 REST API 相同。每次付费调用都需先确认 max_usd。

任务失败会怎样？

冻结的金额会全额释放。get_task 会显示失败原因。

开始接入 PopNow API

一个密钥调用所有模型，按需为 API 美元余额充值，每次运行前提供准确报价。

获取 API 密钥在 Playground 中试用

只想在 ChatGPT 或 Claude 中使用 PopNow？请前往 PopNow for ChatGPT & Claude