Server MCP per sviluppatori

Un unico endpoint per Claude Code, Cursor, Codex e qualsiasi client MCP. Autenticati con la tua chiave API, richiama qualsiasi modello PopNow tramite ID e approva ogni addebito in USD.

Ottieni una chiave API Leggi la documentazione MCP

Endpoint

Streamable HTTP, nessuna installazione richiesta. Invia la tua chiave API come token Bearer. La lista dei modelli consentiti, la lista degli IP consentiti e i limiti di spesa della chiave si applicano esattamente come nella REST API.

Solo chiave API, senza accesso con account
Fatturato in USD sul tuo saldo API
240 richieste e 20 nuove attività al minuto

Chiavi API

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"}'

Collega il tuo agente di programmazione

Conserva la chiave in POPNOW_API_KEY. Non incollarla mai in un prompt e non committarla in un repository.

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"
      }
    }
  }
}

Per i client che eseguono solo server locali: il bridge open source inoltra lo stdio a questo endpoint.

Strumenti

Gli strumenti con nome usano impostazioni predefinite sensate. create_task esegue qualsiasi modello tramite il suo ID esatto.

`create_task`	Esegui qualsiasi modello tramite il suo ID API esatto, con i campi di input del modello, come POST /api/v1/jobs/createTask.
`create_image · create_video · create_music · create_speech`	Strumenti con nome e impostazioni predefinite, più edit_image, apply_effect, remove_background, upscale, add_sound e strumenti dedicati come extend_video e relight_photo.
`list_models`	ID esatti dei modelli, input di ogni modello e prezzo in USD.
`get_task · list_tasks`	Segui un'attività ed elenca le attività recenti create con questa chiave.
`check_balance`	USD disponibili e bloccati nel wallet di questa chiave.
`compose_video`	Unisce i risultati precedenti in un unico MP4 con musica, voce e sottotitoli. Gratis.
`find_skills · install_skill`	Scegli un pacchetto di skill, poi ottieni la sua guida operativa, un link di download e i comandi di installazione.
`run_my_recipe · get_recipe_run · resume_recipe_run`	Esegui le tue ricette e i tuoi workflow salvati.

Ogni addebito viene approvato in USD

1Preventivo
Chiama uno strumento a pagamento senza max_usd. Ricevi cost_usd e available_usd, e non viene addebitato nulla.
2Approvazione
Mostra il prezzo. Quando l'utente conferma, richiama lo stesso strumento con gli stessi argomenti e con max_usd impostato sul cost_usd preventivato.
3Esecuzione
L'importo viene bloccato all'avvio dell'attività e addebitato al termine. Un'attività fallita sblocca il blocco.

Saldo API insufficiente? Aggiungi fondi dalla console API.

Passaggio dal vecchio indirizzo

Le chiavi API inviate a https://api.popnow.ai/mcp continueranno a funzionare fino al 31 gennaio 2027, con le intestazioni Deprecation e Sunset. Prima di quella data, passa la configurazione all'endpoint indicato sopra.

Domande frequenti

Devo installare qualcosa?

No. È un server remoto: aggiungi l'indirizzo e la tua chiave API. Il bridge open source serve solo ai client che possono eseguire da soli server locali.

Quali modelli posso richiamare?

I modelli di immagini, video, musica e voce del catalogo API di PopNow aperti a MCP. list_models mostra gli ID esatti e gli input.

Come viene fatturato?

In USD dal saldo API associato alla tua chiave, agli stessi prezzi della REST API. Ogni chiamata a pagamento richiede prima un max_usd approvato.

Cosa succede se un'attività fallisce?

L'importo bloccato viene sbloccato per intero. get_task mostra il motivo.

Inizia a creare in pochi minuti

Una chiave per tutti i modelli, un saldo in USD da ricaricare quando serve e un prezzo esatto prima di ogni esecuzione.

Ottieni una chiave API Prova nel Playground

Vuoi solo PopNow in ChatGPT o Claude? Usa PopNow per ChatGPT e Claude