開発者向け MCP サーバー
Claude Code、Cursor、Codex など任意の MCP クライアント向けの単一エンドポイントです。API キーで認証し、モデル ID で PopNow の任意のモデルを呼び出して、すべての課金を USD で承認できます。
エンドポイント
Streamable HTTP に対応し、インストールは不要です。API キーを Bearer トークンとして送信してください。キーに設定されたモデルの許可リスト、IP の許可リスト、支出上限は、REST API と同じように適用されます。
- API キーのみ。アカウントへのサインインは不要
- API 残高から USD で課金
- 毎分 240 リクエスト、新規タスク 20 件
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 と、確保中の USD を表示します。 |
compose_video | 過去の結果を 1 本の 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実行
タスク開始時に金額を確保し、完了時に確定します。失敗したタスクでは確保した金額が解放されます。
旧アドレスからの移行
https://api.popnow.ai/mcp に送信された API キーは 2027年1月31日 まで引き続き利用できます。レスポンスには Deprecation と Sunset ヘッダーが付きます。それまでに、設定を上記のエンドポイントに切り替えてください。
よくある質問
インストールは必要ですか?
いいえ。リモートサーバーなので、アドレスと API キーを追加するだけです。オープンソースのブリッジは、ローカルサーバーしか実行できないクライアント向けです。
どのモデルを呼び出せますか?
PopNow API カタログのうち、MCP で利用できる画像・動画・音楽・音声モデルです。list_models で正確な ID と入力項目を確認できます。
料金はどのように計算されますか?
キーに紐づく API 残高から USD で課金され、料金は REST API と同じです。有料の呼び出しには、事前に max_usd の承認が必要です。
タスクが失敗した場合は?
確保された金額は全額解放されます。get_task で失敗理由を確認できます。
ChatGPT や Claude で PopNow を使いたいだけですか?PopNow for ChatGPT & Claude をご覧ください