PopNow

PopNow MCP Server — ChatGPT、Claude、Cursor、あらゆる MCP クライアント向けの AI 画像・動画・音楽生成

PopNow MCP Server は、https://api.popnow.ai/mcp でホストされる Model Context Protocol サーバーです。ChatGPT、Claude、Cursor、VS Code など、あらゆる MCP クライアントから PopNow のクレジットを使って AI 画像、動画、楽曲、ナレーションを作成できます。

「この写真を5秒の動画にして」「アップテンポなシンセポップの曲を作って」と普通の言葉で頼むと、アシスタントが適切な PopNow ツールを選び、料金を伝えて、チャット内に結果を返します。ホスティングは不要です。サーバーはリモートで、OAuth 2.1 でサインインし、popnow.ai と同じモデル、価格、ライブラリを使用します。また、PopNow の無料 Agent Skills の拠点でもあります。ローンチ動画、プレゼン資料、ランディングページのスタイルを尋ねると、アシスタントが選べるプリセットを表示します。目を引くものを作りましょう。

このリポジトリには、一般公開されているセットアップガイド、コピーして貼り付けられるクライアント設定（examples/）、MCP レジストリマニフェスト、そしてローカルサーバーしか実行できないクライアント向けの小さなオプションの stdio ブリッジ @popnow/mcp が含まれています。

目次

• クイックスタート
• ツール
• スタイルプリセット：find_skills と use_skill
• クライアントを接続する：Claude · Claude Desktop（ローカル） · Claude Code · ChatGPT · Cursor · VS Code · Windsurf · Cline · Codex CLI · その他のクライアント
• Hermes Agent と Gemini CLI の拡張機能
• 認証
• クレジット、料金、確認
• プロンプトの例
• stdio ブリッジ（@popnow/mcp）
• トラブルシューティング
• FAQ

クイックスタート

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 のサインインページが表示されます。Allow を押してから、画像、動画、または曲をリクエストしてください。

まだ 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	1曲あたり約72クレジット（Suno v6）
create_speech	テキストを、さまざまな声や言語による自然な音声に変換します	text、voice（Kore、Puck、Charon、Aoede、Fenrir、Leda など）、style（whisper、empathetic、vocal_smile、newscaster、promo_hype、deadpan）、max_credits	長さに応じて課金。音声1分あたり約20クレジット
apply_effect	写真をトレンドのエフェクト動画（Zombie Turn、Flying Car、Tiny Planet、Molten Gold、Hyperdrive など）や写真の加工（Clay Figure、Pixel Art など）に変換します	effect（名前または ID）、image_url / image、max_credits	動画1本あたり約125～340クレジット、写真加工1回あたり30～50クレジット。事前に料金を提示します
remove_background	被写体を切り抜き、背景を透明にします	image_url / image、max_credits	約5クレジット
upscale	写真や動画を鮮明にし、サイズを大きくします	image_url / image または video_url、size（写真は 2k、4k、8k。動画は 720p、1080p、2k、4k）	写真1枚あたり約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）を検索します。製品発表動画、スライド資料、ランディングページやウェブサイト、エディトリアル画像などが対象です。各候補には名前、1行で表した見た目、プレビュー動画または画像、使用する 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は読み取り専用で、削除を行うツールはありません。
• エフェクトはエフェクトページと同じ種類をカバーしています。2人用のエフェクトには、2枚の写真を配置する必要があり、ウェブサイトでのみ利用できます。

スタイルプリセット：find_skillsとuse_skill

PopNowには、無料で利用できるAgent Skillsのカタログがあります。製品ローンチ動画、スライドデッキ、ランディングページやウェブサイト、エディトリアル画像などの名前付きスタイルが揃っており、それぞれにプレビューと、AIエージェントが成果物を作成する際に従う詳細な手順書が用意されています。2つの無料ツールを使うと、どのMCPクライアントからでもカタログを利用できます。

1. 検索。 アシスタントは、作りたいものを自分の言葉で指定してfind_skillsを呼び出します（必要に応じてtypeにvideo、image、slides、webのいずれかを指定します）。最適なものから順に最大6件（デフォルトは4件）が返され、それぞれに名前、スタイルの簡単な説明、プレビューリンク、使用するPopNowの生成機能、ローカルでの要件が含まれます。
2. 選択。 アシスタントはプレビューとともに選択肢を提示し、どれを使うか尋ねます。
3. 使用。 アシスタントは、選択したslugとagent（claude-code、codex、cursor、gemini-cli、github-copilot、opencode、またはファイルシステムのないアプリではchat）を指定してuse_skillを呼び出します。応答には、完全なSKILL.md手順書、そのエージェント向けのインストールコマンドを含むパッケージ全体の短期間有効な署名付きダウンロードリンク、さらに手順書内の生成スクリプトを置き換えるPopNowツール（create_image、create_video、create_music、create_speechなど）が含まれます。

プリセットの検索、ダウンロード、使用は無料です。生成する画像、動画、音楽、音声のみクレジットが必要で、ほかのPopNowツールと同様に、料金が提示され確認を求められます。プリセットは、ご自身の作業およびクライアント向けの作業に使用するライセンスが付与されています。パッケージを再公開しないでください。ファイルシステムのないチャットアプリでも、アシスタントは手順書のスタイルに従ってcreate_imageで画像を作成できます。ローカルスクリプトを実行する手順にはコーディングエージェントが必要です。

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スキル、ウェブサイトからも同じカタログを利用できます。

クライアントを接続する

以下のすべてのクライアントは、同じリモートサーバーに接続します。デフォルトではOAuthサインインを使用します。各セクションにはAPIキーを使う方法も記載しています（認証を参照）。すぐに使える設定ファイルはexamples/にあります。

Claude（ウェブ、デスクトップ、モバイル）

カスタムコネクターは、対応する Claude のプランおよびワークスペースで利用できます。

1. ウェブ版またはデスクトップアプリの 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（macOS：~/Library/Application Support/Claude/claude_desktop_config.json、Windows：%APPDATA%\Claude\claude_desktop_config.json）で PopNow を使用する場合は、汎用の 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} はスペースを入れずに記述し、Bearer ... は env ブロックに設定してください。一部のクライアント（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}" }
    }
  }
}

OAuth でサインインするには、headers ブロックを削除します。保存後、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 では、OAuth を明示するために、ネイティブの MCP 設定を使用します。アクティブなプロファイルの 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 を使用すると、すべてのモデルパラメーター、ウェブフック、冪等性キー、タスクごとの保持期間を利用できます。

認証

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 にあります。同意ページにはアプリ名と 2 つのスコープ、generate と read が表示されます。アクセストークンの有効期間は 1 時間で、自動的に更新されます。接続は 90 日間使用されない状態になるまでサインインしたままです。AI アプリにパスワードや決済情報が渡ることはありません。

API キー（代替手段）。 ブラウザーを使わないスクリプト、CI ジョブ、エージェントは、API console で発行したキーを Authorization: Bearer sk-popnow-... として送信できます。キーに設定されたモデルの許可リスト、IP 許可リスト、日次・月次・生涯の利用上限が、REST API と同様に適用されます。エージェントごとに日次上限の低いキーを発行し、コミットするファイルにキーを記載しないでください。クライアントの環境変数、または安全な入力機能を使用してください。

popnow.ai の Account settings → Devices → Connected AI apps から、いつでも接続を解除できます。キーを使用するクライアントの場合は、API コンソールでキーを失効させてください。

クレジット、価格、確認

接続は無料で、find_skills と use_skill も無料です。生成のたびに、popnow.ai と同じ価格で、同じ残高から同じクレジットが消費されます。1 クレジット = $0.001 です。PopNow はサブスクリプションなしのクレジットパックを販売しています。Starter（$9、9,000 クレジット）から Pro（$99、ボーナス込みで 120,000 クレジット）までのパックのほか、$10 から $2,000 までの任意の金額（$1 あたり 1,000 クレジット）を購入できます。詳しくは価格をご覧ください。

すべての生成ツールは、まず価格を提示します。

• 300 クレジット以下（画像、曲、デフォルトモデルでの 5 秒の動画）：ジョブはすぐに開始され、返信に費用が記載されます。
• 300 クレジット超（長時間または高解像度の動画、一部のエフェクト）：生成は開始されません。ツールは価格と残高を示して Needs confirmation と応答し、アシスタントが確認を求めます。承認すると、アシスタントは承認した価格を max_credits に設定して、ツールを再度呼び出します。
• 見積もりから開始までの間に価格が変わった場合：課金は行われず、返信に確認が必要な新しい価格が記載されます。
• 生成に失敗した場合：クレジットは自動的に返金されます。

同じアカウントから 10 秒以内に行われた同一の呼び出しは 1 つのジョブになるため、アシスタントが再試行しても二重に支払うことはありません。ツールは結果を最大約 40 秒待ちます。それ以上かかるジョブ（ほとんどの動画）では job_id が返され、アシスタントは get_job で結果を取得します。

レート制限	値
アカウントあたりのツール呼び出し数（get_job のポーリングを含む）	1 分あたり 240 回
アカウントあたりの新規生成数	1 分あたり 20 回

上限を超える生成には課金されません。ツールが待機する秒数を伝えます。

プロンプトの例

• 「雨の降る窓辺に置かれた紙のボートの 4:5 の画像を作成してください。柔らかな朝の光で。」
• 「この写真を編集してください。彼女に赤いジャケットを着せて、背景を雪の降る通りにしてください。」
• 「この商品写真を、カメラがゆっくり寄っていく 5 秒の動画にしてください。」
• 「ゴールデンアワーにヴィンテージカーが海岸沿いを走る 9:16 の動画を、10 秒で作成してください。」（300 クレジット超のため、アシスタントが先に確認します）
• 「自撮り写真に Zombie Turn エフェクトを適用してください。」
• 「夏のドライブ旅行をテーマにした、明るいシンセポップの曲を作詞・制作してください。女性ボーカルで。」
• 「この段落を、ニュースキャスター風の Puck の声で読み上げてください。」
• 「このロゴの背景を削除してから、4K にアップスケールしてください。」
• 「どの動画モデルを使えますか。それぞれの料金はいくらですか。」
• 「PopNow クレジットの残高はいくつですか。直近 5 件の動画を表示してください。」
• 「シードラウンド向けのピッチデッキに合うスタイルを探してください。」（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 は、ローカルの stdio サーバーしか起動できない MCP クライアント向けの最小限の TypeScript パッケージ（bin popnow-mcp）です。公式 MCP SDK の StdioServerTransport を 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）でサーバーを記述します。任意の Authorization ヘッダーを指定できる、リモートの Streamable HTTP エンドポイントです。

トラブルシューティング

表示される内容	原因	対処方法
Connectors／Add custom MCP server オプションが表示されない	プランまたはワークスペースでカスタムコネクターが許可されていません	ワークスペースの管理者に問い合わせてください
"Please connect your PopNow account first."	サインインが完了する前に、クライアントがツールを呼び出しました	クライアントの MCP またはコネクター設定から再接続してください
"This connection wasn't given permission to do that."	generate スコープなしで接続が承認されました	接続を切断し、再接続して Allow を押してください
確認が必要です。まだ開始されていません	ジョブの料金が 300 クレジットを超えています	はい、と答えてください。アシスタントが max_credits を指定して呼び出しを繰り返します
"Not enough credits ... Nothing was charged."	残高が不足しています	クレジットパックを購入するか、より安価なモデルまたは短い動画を選んでください
"Too many creations at once. Nothing was charged."	1 分間に 20 件を超える新規生成がありました	メッセージに記載された秒数だけ待ってください
WWW-Authenticate ヘッダー付きの 401	トークンがないか、API キーが間違っているか、無効化されています	有効な sk-popnow- キーを使って Authorization: Bearer を送信するか、再度サインインしてください
405 Method Not Allowed	/mcp への GET または DELETE。サーバーはステートレスです	POST を使用してください（MCP クライアントなら自動的に対応します）
Cline は接続するものの、何も動作しない	type が指定されていないため、Cline がレガシー SSE を使用しました	"type": "streamableHttp" を設定してください

FAQ

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 を使用するか、オプションの @popnow/mcp ブリッジを npx -y @popnow/mcp で実行できます。

OAuth の代わりに API キーを使用できますか？

はい。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 を使用する · エージェントスキルカタログ
• ドキュメント：popnow.ai/docs · MCP ガイド · API リファレンス（OpenAPI） · llms.txt
• その他の PopNow リポジトリ：
  • popnow-skills：popnow-skill-finder（スタイルプリセットカタログ用）を含む、PopNow 向けエージェントスキル（/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 アドオン

コントリビューション

Issue とプルリクエストを歓迎します。CONTRIBUTING.md をご覧ください。セキュリティに関する問題については、SECURITY.md をご覧ください。

ライセンス

MIT © PopNow