개발자를 위한 MCP 서버

Claude Code, Cursor, Codex 및 모든 MCP 클라이언트를 위한 단일 엔드포인트입니다. API 키로 인증하고, 모델 ID로 PopNow의 모든 모델을 호출하며, 모든 요금을 USD로 승인하세요.

엔드포인트

Streamable HTTP를 사용하며 설치할 것이 없습니다. API 키를 Bearer 토큰으로 보내세요. 키에 설정된 모델 허용 목록, IP 허용 목록, 지출 한도는 REST API와 똑같이 적용됩니다.

API 키만 있으면 되며 계정 로그인은 필요 없음
API 잔액에서 USD로 결제
분당 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 금액과 보류 중인 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와 입력 항목을 확인하세요.

요금은 어떻게 청구되나요?

키에 연결된 API 잔액에서 USD로 차감되며, 요금은 REST API와 같습니다. 유료 호출에는 먼저 승인된 max_usd가 필요합니다.

작업이 실패하면 어떻게 되나요?

보류된 금액은 전액 해제됩니다. get_task에서 실패 사유를 볼 수 있습니다.

몇 분이면 시작할 수 있습니다

키 하나로 모든 모델을 사용하고, 필요할 때 미국 달러 잔액을 충전하며, 실행 전에 정확한 가격을 확인하세요.

API 키 받기 Playground에서 사용해 보기

ChatGPT나 Claude에서만 PopNow를 쓰고 싶으신가요? PopNow for ChatGPT & Claude를 이용하세요