PopNow

PopNow MCP 服务 — 为 ChatGPT、Claude、Cursor 和任何 MCP 客户端生成 AI 图像、视频和音乐

PopNow MCP 服务是一个托管的模型上下文协议服务，地址为 https://api.popnow.ai/mcp，可让 ChatGPT、Claude、Cursor、VS Code 和任何其他 MCP 客户端使用你的 PopNow 点数，在 PopNow 上创作 AI 图像、视频、歌曲和配音。

只需用日常语言提出需求（“把这张照片变成 5 秒的视频”“制作一首欢快的合成器流行乐”），助手就会选择合适的 PopNow 工具，告知你价格，并在聊天中返回结果。你无需托管任何内容：该服务是远程服务，通过 OAuth 2.1 为你完成登录，并使用与 popnow.ai 相同的模型、价格和资源库。这里也是 PopNow 免费 Agent 技能的所在地：询问适合你的发布视频、演示文稿或落地页的风格，助手就会展示可供选择的预设。让作品更出彩。

此代码仓库包含公开的设置指南、examples/ 中可直接复制粘贴的客户端配置、MCP 注册表清单，以及 @popnow/mcp——一个可选的轻量 stdio 桥接程序，供只能运行本地服务的客户端使用。

目录

• 快速入门
• 工具
• 风格预设：find_skills 和 use_skill
• 连接客户端：Claude · Claude Desktop（本地） · Claude Code · ChatGPT · Cursor · VS Code · Windsurf · Cline · Codex CLI · 其他客户端
• Hermes Agent 和 Gemini CLI 扩展
• 身份验证
• 点数、价格和确认
• 提示词示例
• stdio 桥接程序（@popnow/mcp）
• 故障排除
• 常见问题

快速入门

1. 复制服务 URL： https://api.popnow.ai/mcp
2. 将其添加到你的客户端，作为远程（Streamable HTTP）MCP 服务。例如，在 Claude Code 中：

   claude mcp add --transport http popnow https://api.popnow.ai/mcp
   

3. 登录并提出请求。 首次使用时，客户端会打开 PopNow 登录页面；点击 允许，然后请求生成图片、视频或歌曲。

还没有 PopNow 账号？请前往 popnow.ai 注册；需要更多额度时，可选择一个额度包。

服务 URL	https://api.popnow.ai/mcp
传输方式	Streamable HTTP，无状态（仅支持 POST；GET 和 DELETE 返回 405）
登录	使用 PKCE 和动态客户端注册的 OAuth 2.1，或 Authorization: Bearer sk-popnow-...
权限范围	generate（使用你的额度进行创作）和 read（余额、作品、模型列表）
工具	生成、账号和风格预设工具（见下文）
价格	与 popnow.ai 使用相同额度（1 个额度 = $0.001）。最多可立即开始生成 300 个额度的内容；超过部分需等待你确认。风格预设免费

工具

工具	功能	关键参数	典型费用
create_image	根据描述生成新图片	prompt、aspect_ratio（默认 1:1）、model、max_credits	约 48 个积分（默认使用 Nano Banana 2.1）
edit_image	用文字修改照片：更换风格、服装或背景，添加或移除内容	prompt、image_url / image、more_image_urls、aspect_ratio、model、max_credits	约 48 个积分
create_video	根据描述制作短视频，或让照片动起来（文本生成视频和图片生成视频）	prompt、image_url / image、duration_seconds（默认 5）、aspect_ratio（默认 16:9）、model、max_credits	5 秒约 185 个积分（默认使用 MiniMax H3）；需要 1 到 3 分钟
create_music	创作原创歌曲或纯音乐曲目	prompt、lyrics、instrumental、voice（female / male）、title、max_credits	每首歌约 72 个积分（Suno v6）
create_speech	将文本转换成多种音色和语言的自然语音	text、voice（Kore、Puck、Charon、Aoede、Fenrir、Leda ...）、style（whisper、empathetic、vocal_smile、newscaster、promo_hype、deadpan）、max_credits	按时长计费，音频每分钟约 20 个积分
apply_effect	将照片制作成热门特效视频（Zombie Turn、Flying Car、Tiny Planet、Molten Gold、Hyperdrive ...），或对照片进行改造（Clay Figure、Pixel Art ...）	effect（名称或 ID）、image_url / image、max_credits	每段视频约 125 到 340 个积分，每张改造照片约 30 到 50 个积分；会先报价
remove_background	抠出主体并将背景设为透明	image_url / image、max_credits	约 5 个积分
upscale	提高清晰度并放大照片或视频	image_url / image 或 video_url、size（照片：2k、4k、8k；视频：720p、1080p、2k、4k）、max_credits	每张照片约 12 个积分；视频按时长计费
get_job	查看仍在运行的创作任务，并在任务完成后返回结果	job_id、wait_seconds（0 到 50，默认 30）	免费
list_my_creations	显示你最近创建的 PopNow 内容及其链接	kind（image、video、audio）、limit（1 到 20，默认 10）	免费
check_balance	显示剩余积分（以及运行中任务占用的积分）	无	免费
list_models	列出图像、视频和音频模型，或列出所有特效及其价格	category（image、video、audio、effects）	免费
find_skills	根据你的创作需求查找现成的风格预设（Agent Skills）：产品发布视频、幻灯片、落地页和网站、编辑类图片。每个选项都包含名称、一句话风格描述、预览视频或图片、所用的 PopNow 生成工具，以及本地所需内容	intent（用你的话描述）、type（video、image、slides、web）、limit（1 到 6，默认 4）	免费
use_skill	获取你选中的预设：完整操作指南（SKILL.md）、包含安装命令且限时有效的整套资源签名下载链接，以及用于执行生成步骤的 PopNow 工具	slug（来自 find_skills）、agent（claude-code、codex、cursor、gemini-cli、github-copilot、opencode，或无文件系统的 chat）	免费；运行的每项生成任务都会先报价

• 模型。 每个接受 model 的生成工具都支持来自 list_models 的 PopNow 模型 ID，因此“使用 Seedance”或“用 Wan 制作”都能直接使用。模型包括 Kling、Seedance、Wan、Vidu、MiniMax、Nano Banana、GPT Image、Flux、Suno 等；实时列表始终以 list_models 为准（或通过 REST API 上的 GET /api/v1/models 获取）。
• 输入照片。 image_url 可接受公开的 https 链接，或来自先前结果的 popnow:// 链接。在 ChatGPT 中，附加的照片会作为 image 文件对象传入。
• 获取结果。 图片会以内嵌预览和下载链接的形式返回；视频和音频会以链接形式返回。每个结果还有一个永久的 popnow:// 链接，可传给另一个工具（“现在让那张图片动起来”）。所有内容都会保存到你的 PopNow 资源库。
• 注解。 所有工具都带有标准 MCP 提示。get_job、list_my_creations、check_balance、list_models、find_skills 和 use_skill 均为只读工具，且没有任何工具会删除内容。
• 特效涵盖与 特效页面相同的内容。双人特效需要放置两张照片，且仅限网站使用。

风格预设：find_skills 和 use_skill

PopNow 提供免费的 Agent Skills 目录：其中包含用于产品发布视频、幻灯片、落地页和网站、编辑类图片等的命名风格，每项都附有预览和完整的操作手册，供 AI Agent 遵循以生成结果。两个免费工具可将该目录引入任何 MCP 客户端：

1. 查找。 助手会根据你用自己的话描述的创作需求调用 find_skills（可选的 type 为 video、image、slides 或 web）。它最多返回 6 个选项（默认为 4 个），按匹配度从高到低排列；每项都包含名称、对风格的一句话描述、预览链接、所用的 PopNow 生成功能及其本地要求。
2. 选择。 助手会向你展示这些选项及其预览，并询问你想选哪一个。
3. 使用。 助手会使用所选的 slug 和 agent 调用 use_skill（在无文件系统的应用中，agent 可以是 claude-code、codex、cursor、gemini-cli、github-copilot、opencode 或 chat）。回复中包含完整的 SKILL.md 操作手册、一个短时有效的签名下载链接（可下载包含该 Agent 安装命令的完整软件包），以及用于替代操作手册自带生成脚本的 PopNow 工具（create_image、create_video、create_music、create_speech 等）。

查找、下载和使用预设均免费。只有生成的图片、视频、音乐或语音会消耗积分；费用会像其他 PopNow 工具一样，在生成前报价并确认。预设授权用于你自己的项目和客户项目；请勿重新发布软件包。在没有文件系统的聊天应用中，助手仍可遵循操作手册中的风格，并使用 create_image 制作图片；需要运行本地脚本的步骤则需要编码 Agent。

You:        I need a launch video for our note-taking app.
Assistant:  (calls find_skills with intent "launch video for a note-taking app", type "video")
            Here are three styles:
            1. <Preset A> - <its one-line look>. Preview: <link>. Uses PopNow video; needs Node.js.
            2. <Preset B> - ...
            3. <Preset C> - ...
            Which one do you like? The preset is free; only the clips it makes cost credits.
You:        The first one.
Assistant:  (calls use_skill with that slug and agent "claude-code", installs the package from the
            signed link, then follows the playbook)
            Installed. The first clip will cost 185 credits. Go ahead?
You:        Yes.
Assistant:  (calls create_video with max_credits: 185, then get_job, and keeps building the video)

除 MCP 外，还可通过开放 API（GET /api/v1/agent-skills、GET /api/v1/agent-skills/{slug} 和 GET /api/v1/agent-skills/{slug}/download，后者会重定向到签名链接；需要 API 密钥）、popnow-skills 中的 popnow-skill-finder skill，以及网站访问同一目录。

连接你的客户端

以下每个客户端都连接到同一个远程服务。默认使用 OAuth 登录；每个部分也会介绍 API 密钥替代方案（参见身份验证）。现成的配置文件位于 examples/。

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

自定义连接器适用于允许使用该功能的 Claude 方案和工作区。

1. 在网页版 Claude 或 Claude 桌面应用中，打开 Settings → Connectors（claude.ai/settings/connectors）。
2. 点击 Add custom connector，将其命名为 PopNow，并粘贴 https://api.popnow.ai/mcp。高级 OAuth 字段留空：Claude 会自动注册自身。
3. 点击 Connect，登录 PopNow（Google、GitHub 或电子邮件验证码），然后点击 Allow。

在网页版添加的连接器也可在 Claude 移动应用中使用。如果看不到 Connectors，请联系工作区管理员。

Claude Desktop（本地配置）

建议使用上面的连接器。如果想改为在 claude_desktop_config.json 中配置 PopNow（macOS：~/Library/Application Support/Claude/claude_desktop_config.json，Windows：%APPDATA%\Claude\claude_desktop_config.json），请使用通用的 mcp-remote stdio 桥接程序。

使用 OAuth（examples/claude-desktop-mcp-remote.json）：

{
  "mcpServers": {
    "popnow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.popnow.ai/mcp"]
    }
  }
}

使用 API 密钥（examples/claude-desktop.json）：

{
  "mcpServers": {
    "popnow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.popnow.ai/mcp", "--header", "Authorization:${POPNOW_AUTH}"],
      "env": { "POPNOW_AUTH": "Bearer sk-popnow-..." }
    }
  }
}

保持 Authorization:${POPNOW_AUTH} 中没有空格，并在 env 块中填入 Bearer ...：一些客户端（包括 Windows 上的 Claude Desktop）不会转义 args 中的空格。编辑文件后，重启 Claude Desktop。两种配置都需要 Node.js 18 或更高版本。

Claude Code

# OAuth: run /mcp inside Claude Code afterwards and choose PopNow to sign in
claude mcp add --transport http popnow https://api.popnow.ai/mcp

# Or with an API key
claude mcp add --transport http popnow https://api.popnow.ai/mcp \
  --header "Authorization: Bearer $POPNOW_API_KEY"

添加 --scope user，即可在所有项目中使用 PopNow；添加 --scope project，即可通过 .mcp.json 与他人共享。

ChatGPT

自定义 MCP 服务取决于你的 ChatGPT 方案和工作区设置，菜单名称也会随 ChatGPT 更新而变化。当前操作路径如下：

1. 前往 chatgpt.com/plugins，点击 +，然后选择 Add custom MCP server。
2. 将其命名为 PopNow，在 Connection 下粘贴 https://api.popnow.ai/mcp，并选择 OAuth 作为登录方式。接受警告，然后选择 Create as a plugin。
3. 登录 PopNow，然后点击 Allow。
4. 在新聊天中输入 @，选择 PopNow 并提问。你附加的照片会直接传给 PopNow。

Cursor

将配置添加到项目中的 .cursor/mcp.json，或添加到 ~/.cursor/mcp.json 以供所有项目使用（examples/cursor.mcp.json）：

{
  "mcpServers": {
    "popnow": { "url": "https://api.popnow.ai/mcp" }
  }
}

Cursor 连接时会启动 OAuth 登录。若改用 API 密钥（examples/cursor-api-key.mcp.json）：

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

PopNow MCP 页面也提供一键式 Add to Cursor 按钮。

VS Code

添加到 .vscode/mcp.json（注意顶层键为 servers）（examples/vscode.mcp.json）：

{
  "servers": {
    "popnow": { "type": "http", "url": "https://api.popnow.ai/mcp" }
  }
}

服务首次启动时，VS Code 会打开登录页面。若使用 API 密钥，请让 VS Code 提示输入密钥并安全存储（examples/vscode-api-key.mcp.json）：

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

Windsurf

打开 Windsurf 中的 MCP 设置，并编辑原始 mcp_config.json（文件位置见 Windsurf 官方 MCP 文档）。远程服务使用 serverUrl（examples/windsurf.mcp_config.json）：

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

删除 headers 块即可改用 OAuth 登录。保存后，在 MCP 面板中点击 Refresh。

Cline

打开 MCP Servers → Configure，并将 PopNow 添加到 cline_mcp_settings.json。请明确将 type 设为 streamableHttp；否则 Cline 会回退到旧版 SSE 传输方式（examples/cline_mcp_settings.json）：

{
  "mcpServers": {
    "popnow": {
      "type": "streamableHttp",
      "url": "https://api.popnow.ai/mcp",
      "headers": { "Authorization": "Bearer sk-popnow-..." },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Cline CLI 也可以通过 OAuth 登录：移除 headers，并在 cline mcp 向导中使用 Authorize OAuth。

若要直接通过 Cline CLI 添加托管服务：

cline mcp add popnow https://api.popnow.ai/mcp --transport http --yes

相同步骤也汇总在 llms-install.md 中。登录后，调用 check_balance 并传入 {}，即可检查连接而不消耗额度。

Hermes Agent 和 Gemini CLI 扩展

此仓库也是一个可移植的 Agent Plugins v1 软件包。它在 mcp.json 中声明了托管服务；不会启动本地可执行文件，也不需要可选的 npm 桥接程序。

对于 Hermes Agent，请使用其原生 MCP 配置，以明确启用 OAuth。将以下内容添加到当前配置文件的 config.yaml 中：

mcp_servers:
  popnow:
    url: https://api.popnow.ai/mcp
    auth: oauth
    trust: untrusted

运行 hermes mcp login popnow，然后启动新会话或使用 /reload-mcp。原生配置会要求 Hermes 在执行具有写入能力的调用（包括生成）前征求批准。PopNow 也会在服务端强制执行其返回的价格和确认要求。读取余额或列出模型不会消耗额度。

对于 Gemini CLI：

gemini extensions install https://github.com/popnow-ai/popnow-mcp

根目录下的 gemini-extension.json 使用 Streamable HTTP 和 OAuth。如有需要，请在 Gemini CLI 中运行 /mcp auth popnow 登录。工具审批遵循客户端的常规策略。

数据与执行说明。 这些清单会连接到 https://api.popnow.ai/mcp。客户端只会向 PopNow 传递工具参数和媒体引用。生成操作会在已连接的账户中创建媒体，并消耗预付余额。此可移植软件包不包含钩子、本地命令、后台进程或自定义凭据存储。此仓库其他位置提供的可选 TypeScript stdio 桥接程序仅在单独安装后才会使用。请查阅隐私政策和条款，或联系 [email protected]。

市场审核与直接安装相互独立。这些安装命令并不代表客户端供应商已批准或认可。

Codex CLI

# OAuth
codex mcp add popnow --url https://api.popnow.ai/mcp
codex mcp login popnow

或者编辑 ~/.codex/config.toml（examples/codex.config.toml）；bearer_token_env_var 会从环境中读取 API 密钥：

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

其他客户端和你自己的代码

任何支持 Streamable HTTP 的客户端都可以使用相同的 URL（examples/generic.json、examples/generic-api-key.json）。仅能运行本地 stdio 服务的客户端可以使用 mcp-remote（如 Claude Desktop 配置所示），也可以从源代码构建 @popnow/mcp。

使用官方 TypeScript SDK 从代码调用（npm install @modelcontextprotocol/sdk）：

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://api.popnow.ai/mcp'), {
  requestInit: { headers: { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` } },
});
const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const result = await client.callTool({ name: 'check_balance', arguments: {} });
console.log(result.content[0].text);
await client.close();

使用 Python SDK（pip install mcp）：

import asyncio, os

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    headers = {"Authorization": f"Bearer {os.environ['POPNOW_API_KEY']}"}
    async with streamablehttp_client("https://api.popnow.ai/mcp", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool(
                "create_image",
                {"prompt": "A paper boat on a rainy window sill, soft morning light", "aspect_ratio": "4:5"},
            )
            for part in result.content:
                print(part.type, getattr(part, "text", ""))

asyncio.run(main())

或者使用 curl。此服务是无状态的，因此每个请求都是独立的；请在 Accept 中发送两种媒体类型：

curl -X POST "https://api.popnow.ai/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/call", "params": {"name": "check_balance", "arguments": {}}}'

对于直接调用模型的生产代码，PopNow REST API 提供所有模型参数、Webhook、幂等键和按任务设置的保留期限。

身份验证

OAuth 2.1（默认）。 PopNow 是标准的 OAuth 2.1 授权服务器：支持使用 PKCE（S256）的授权码、刷新令牌、动态客户端注册（RFC 7591）和客户端 ID 元数据文档。发现流程从 /mcp 返回的 401 响应开始，其 WWW-Authenticate 标头指向 /.well-known/oauth-protected-resource/mcp；服务器元数据位于 /.well-known/oauth-authorization-server。授权页面会显示应用名称和两个范围：generate 与 read。访问令牌有效期为一小时，并会自动刷新；连接在连续 90 天未使用后才会退出登录。AI 应用无法获取你的密码或付款详情。

API 密钥（替代方式）。 没有浏览器的脚本、CI 任务和 Agent 可以将 API 控制台中的密钥作为 Authorization: Bearer sk-popnow-... 发送。密钥的模型允许列表、IP 允许列表以及每日、每月和终身支出上限均适用，与 REST API 上的规则完全相同。为每个 Agent 单独创建密钥，并设置较低的每日上限；不要将密钥放入会提交的文件中：请使用客户端支持的环境变量或安全输入功能。

你可以随时在 popnow.ai 的账户设置 → 设备 → 已连接的 AI 应用中断开连接。对于基于密钥的客户端，请在 API 控制台中撤销密钥。

积分、价格与确认

连接免费，find_skills 和 use_skill 也免费。每次创作消耗的积分与 popnow.ai 上相同，价格相同，使用同一余额：1 积分 = $0.001。PopNow 销售积分包，无需订阅，套餐从 Starter（$9，9,000 积分）到 Pro（$99，含奖励积分共 120,000 积分）；也可以按每 $1 购买 1,000 积分，金额为 $10 至 $2,000；详情请见定价。

每个生成工具都会先报价：

• 不超过 300 积分（一张图片、一首歌曲、默认模型生成的 5 秒视频）：任务会立即开始，回复中会说明费用。
• 超过 300 积分（更长或更高分辨率的视频、某些特效）：任务不会开始。工具会回复需要确认，并显示价格和余额；助手会询问你，得到同意后会再次调用工具，并将 max_credits 设为你接受的价格。
• **报价与开始之间价格变动：**不会扣费，回复会给出需要确认的新价格。
• **创作失败：**积分会自动退还。

同一账户在十秒内发出的相同调用只会创建一个任务，因此助手重试也不会重复付费。工具最多等待约 40 秒以获取结果；耗时更长的任务（大多数视频）会返回 job_id，然后由助手通过 get_job 获取结果。

速率限制	值
每个账户的工具调用次数（包括 get_job 轮询）	每分钟 240 次
每个账户的新创作次数	每分钟 20 次

超过速率限制的创作不会扣费；工具会说明需要等待多少秒。

提示词示例

• “生成一张 4:5 图片：雨天窗台上的纸船，柔和的晨光。”
• “编辑这张照片：给她穿上一件红色夹克，并把背景换成积雪覆盖的街道。”
• “把这张产品照片变成一段 5 秒视频，镜头缓慢推进。”
• “生成一段 9:16 视频：一辆复古汽车在黄金时段沿海岸行驶，时长 10 秒。”（超过 300 积分，因此助手会先询问）
• “对我的自拍应用 Zombie Turn 特效。”
• “创作并制作一首欢快的合成器流行歌曲，主题是夏日公路旅行，由女声演唱。”
• “用 Puck 的声音，以新闻播报风格朗读这段文字。”
• “移除这个徽标的背景，然后将其放大到 4K。”
• “你可以使用哪些视频模型？每个模型的费用是多少？”
• “我还剩多少 PopNow 积分？显示我最近的五个视频。”
• “为我们的种子轮融资演示文稿找一种风格。”（find_skills，然后 use_skill；免费）

典型对话：

You:        Make a 9:16 video of a vintage car cruising along the coast at golden hour, 10 seconds.
Assistant:  (calls create_video → "Needs confirmation … costs 370 credits (the user has 8450)")
            That's 370 credits from your PopNow balance. Want me to go ahead?
You:        Yes.
Assistant:  (calls create_video again with max_credits: 370 → job_id, then get_job)
            Here it is. It's saved in your PopNow library too.
You:        Now give me an upbeat synth-pop track for it.
Assistant:  (calls create_music → about 72 credits, under 300, starts at once)

stdio 桥接程序（@popnow/mcp）

packages/popnow-mcp 是一个精简的 TypeScript 包（可执行文件为 popnow-mcp），供只能启动本地 stdio 服务的 MCP 客户端使用。它将 StdioServerTransport 连接到官方 MCP SDK 中的 StreamableHTTPClientTransport，并原样转发每条消息，因此工具和价格始终与在线服务一致。

该包已发布到 npm，名称为 @popnow/mcp，因此无需安装即可通过 npx 运行：

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

环境变量	必填	说明
POPNOW_API_KEY	是	PopNow API 密钥（sk-popnow-...），作为 Bearer 令牌发送
POPNOW_MCP_URL	否	远程端点，默认为 https://api.popnow.ai/mcp

若要改为从源码构建并运行（Node.js 18 或更高版本）：

git clone https://github.com/popnow-ai/popnow-mcp.git
cd popnow-mcp
npm --prefix packages/popnow-mcp install
npm --prefix packages/popnow-mcp test    # builds with tsc, then runs an end-to-end test against a local fake server
node packages/popnow-mcp/dist/cli.js --help

然后将客户端指向构建好的文件：

{
  "mcpServers": {
    "popnow": {
      "command": "node",
      "args": ["/absolute/path/to/popnow-mcp/packages/popnow-mcp/dist/cli.js"],
      "env": { "POPNOW_API_KEY": "sk-popnow-..." }
    }
  }
}

MCP 注册表清单

server.json 按照 MCP 注册表 格式（架构 2025-12-11）描述此服务：远程 Streamable HTTP 端点，以及可选的 Authorization 标头。

故障排除

你看到的情况	原因	解决方法
没有 Connectors / Add custom MCP server 选项	你的套餐或工作区不允许使用自定义连接器	联系工作区管理员
“Please connect your PopNow account first.”	客户端在登录完成前调用了工具	在客户端的 MCP 或连接器设置中重新连接
“This connection wasn't given permission to do that.”	批准连接时未授予 generate 范围	断开连接，重新连接并点击 Allow
Needs confirmation, nothing started yet	任务费用超过 300 积分	回复“是”；助手会使用 max_credits 重复调用
“Not enough credits ... Nothing was charged.”	余额不足	购买积分包，或选择更便宜的模型或更短的视频
“Too many creations at once. Nothing was charged.”	一分钟内新建的内容超过 20 个	等待消息中指定的秒数
带有 WWW-Authenticate 标头的 401	未提供令牌，或 API 密钥错误或已撤销	使用有效的 sk-popnow- 密钥发送 Authorization: Bearer，或重新登录
405 Method Not Allowed	向 /mcp 发送了 GET 或 DELETE 请求；该服务无状态	使用 POST（任何 MCP 客户端都会自动处理）
Cline 已连接，但无法正常工作	缺少 type，因此 Cline 使用了旧版 SSE	设置 "type": "streamableHttp"

常见问题

如何通过 Claude 或 ChatGPT 生成 AI 图像和视频？

将 https://api.popnow.ai/mcp 添加为自定义连接器（Claude）或自定义 MCP 服务（ChatGPT），登录 PopNow，然后直接用自然语言提出请求。助手会调用 create_image、create_video 或其他 PopNow 工具，并在聊天中返回结果。

如何使用 MCP 服务根据图像生成视频？

向助手提供一张照片（在 ChatGPT 中附加照片，或在其他地方粘贴公开的 https 链接），并描述画面如何动起来。它会调用带有 image_url 的 create_video，从而切换到图生视频。使用默认模型生成 5 秒视频约需 185 积分。

有用于 AI 音乐和文本转语音的 MCP 服务吗？

有。PopNow 的 create_music 可创作原创歌曲或纯音乐（Suno v6），而 create_speech 可使用多种声音、语言和表达风格朗读文本。

在 ChatGPT、Claude 或 Cursor 中使用 PopNow 会产生额外费用吗？

不会。连接免费，每次创作消耗的积分与在 popnow.ai 上相同。创作失败时会自动退还积分，超过 300 积分的任务则会等待你确认。

我需要安装任何东西吗？

不需要。PopNow 是托管的远程 MCP 服务，你只需添加其 URL。无法连接远程服务的客户端可以使用 mcp-remote，也可以通过 npx -y @popnow/mcp 运行可选的 @popnow/mcp 桥接程序。

可以使用 API 密钥代替 OAuth 吗？

可以。使用 API 控制台中的密钥发送 Authorization: Bearer sk-popnow-...。密钥的消费上限和允许列表均适用。

PopNow MCP 服务支持哪些 AI 模型？

支持图像、视频和音频模型，包括 Kling、Seedance、Wan、Vidu、MiniMax、Nano Banana、GPT Image、Flux 和 Suno，以及一键视频特效。请让助手调用 list_models 获取包含价格的当前列表，然后在请求中指定模型名称。

如何为发布视频、幻灯片或落地页寻找现成风格？

例如，请助手“为我们的产品发布视频寻找一种风格”。它会调用 find_skills，向你展示几个带预览链接的预设；你选定后，它会调用 use_skill 获取其操作指南和安装链接。预设免费；只有运行这些预设生成内容时才会消耗点数。你也可以在 popnow.ai/skills/agent-skills 浏览目录。

我创作的内容会保存在哪里？

你会在聊天中收到一个链接，所有内容也都会保存在你的 PopNow 资料库中，就像在网站上创作的内容一样。

链接

• 网站：popnow.ai · 定价 · 在 ChatGPT 和 Claude 中使用 PopNow · Agent Skills 目录
• 文档：popnow.ai/docs · MCP 指南 · API 参考（OpenAPI） · llms.txt
• 其他 PopNow 仓库：
  • popnow-skills：PopNow 的 Agent Skills，包括用于风格预设目录的 popnow-skill-finder（/plugin marketplace add popnow-ai/popnow-skills 或 npx skills add popnow-ai/popnow-skills）
  • popnow-python：Python SDK
  • popnow-js：JavaScript / TypeScript SDK
  • popnow-api：REST API 示例和 OpenAPI 规范
  • popnow-blender：Blender 插件

贡献

欢迎提交问题和拉取请求。请参阅 CONTRIBUTING.md。有关安全问题，请参阅 SECURITY.md。

许可证

MIT © PopNow