Vai al contenuto principale

MCP e agenti

Fai creare immagini e video al tuo assistente IA

Il server MCP ufficiale dà a Claude, Cursor, Codex, VS Code e altri assistenti il catalogo dei modelli in tempo reale, preventivi esatti e la creazione di attività. Tu chiedi con parole tue, e prima di qualsiasi addebito si ferma per la tua conferma.

Crea una chiave APIGuida completa nella documentazione

Cos’è un server MCP?

MCP (Model Context Protocol) è un modo standard per dare nuovi strumenti a un assistente IA. Aggiungi il server SpicyAPI e il tuo assistente può sfogliare i modelli, controllare i prezzi e creare immagini o video per te.

  1. Tu e il tuo assistenteClaude, Cursor, Codex, VS Code…
  2. Server MCP di SpicyAPIGira sul tuo computer tramite npx
  3. Modelli di immagini e videoCatalogo in tempo reale, prezzi esatti
L’assistente decide quale strumento chiamare. Tutto ciò che costa si ferma e aspetta il tuo sì.

Ideale per

  • Contenuti mentre programmiChiedi un’immagine hero o una clip di prodotto senza uscire dall’editor.
  • Esplorare i modelliChiedi quale modello va bene per un lavoro e quanto costerà.
  • Batch gestiti dall’agenteLascia che l’agente crei più attività, ne attenda il completamento e raccolga i risultati.

Cosa succede quando chiedi

  1. Passaggio 1Trova un modello adatto nel catalogo in tempo reale e legge cosa accetta
  2. Passaggio 2Carica il tuo file locale, se ce n’è uno
  3. Passaggio 3Ottiene un preventivo esatto in dollari USA e ti chiede conferma prima di addebitare
  4. Passaggio 4Avvia l’attività, la attende e ti consegna il link al risultato
Sessione di esempio

  1. Tu: Trasforma beach.jpg in una clip di sei secondi di onde al tramonto.

  2. spicyapi_models_listspicyapi_model_get
    Assistente: Trovato un modello video che accetta un’immagine iniziale
  3. spicyapi_upload_file
    Caricato beach.jpg
  4. spicyapi_task_quote

    Ecco il prezzo esatto in dollari USA. Creo l’attività?

  5. spicyapi_task_createspicyapi_task_wait
    Fatto. Ecco il tuo link di download.
Illustrazione di una sessione tipica. Non viene addebitato nulla finché non approvi.

Aggiungilo al tuo assistente

Ogni client avvia lo stesso server locale tramite npx. Scegli il tuo per il comando o il blocco di configurazione esatto.

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

Un solo server stdio per qualsiasi client MCP. Metti il blocco nel file di configurazione di quel client.

I client di terze parti cambiano formato di configurazione da una versione all’altra. Se uno snippet qui non corrisponde più, vale la documentazione del client.

Usi Claude? Genera immagini e video direttamente da Claude →

Strumenti esposti

Gli strumenti di sola lettura sono gratuiti. I due strumenti che spendono denaro e quello che elimina contenuti chiedono sempre prima a te.

GratisGratuiti, sola lettura12

  • spicyapi_service_statusControllo di stato pubblico, senza chiave
  • spicyapi_docs_searchCercare nella documentazione inclusa
  • spicyapi_models_listModelli attivi e i tuoi prezzi
  • spicyapi_model_getUn modello e il suo schema di input
  • spicyapi_balance_getSaldo disponibile, bloccato e totale
  • spicyapi_usage_getQuanto ha speso la chiave in uso
  • spicyapi_tasks_listAttività recenti della chiave in uso
  • spicyapi_task_getUn’attività, con i link ai risultati pronti
  • spicyapi_task_waitAttendere fino a 5 minuti la fine di un’attività
  • spicyapi_task_quoteCalcolare il prezzo di una richiesta senza crearla
  • spicyapi_upload_fileCaricare un file locale da usare come input
  • spicyapi_download_url_createUn nuovo link di download per un risultato

Chiede conferma prima di addebitareChiedono prima di agire3

  • spicyapi_task_createAvviare un’attività di generazione
  • spicyapi_task_retryRieseguire un’attività fallita o scaduta
  • spicyapi_task_purgeEliminare definitivamente il contenuto di un’attività conclusa
Apri il pacchettoVedi il codice sorgente

Aggiungi l’Agent Skill per l’ordine delle chiamate

Il server MCP dà all’agente le capacità; l’Agent Skill gli dice come usarle: leggere lo schema, confermare il preventivo, riutilizzare una sola chiave di idempotenza per tentativo. Claude Code e Codex supportano entrambi.

Apri il pacchettoVedi il codice sorgente
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

File che il tuo agente può leggere

Questi file aiutano assistenti e strumenti di integrazione a trovare la descrizione del prodotto, il catalogo dei modelli e la documentazione canonica.

agent.md

Contratto di integrazione per agent e limiti di sicurezza, in forma compatta.

/agent.md →

llms.txt

Indice curato del sito e dei modelli per il recupero da parte delle AI.

/llms.txt →

llms-full.txt

Contesto esteso su prodotto, flussi di lavoro, endpoint e discovery.

/llms-full.txt →

Manifesto dell’agent

Discovery JSON strutturata per strumenti e client autonomi.

/api/agent →

Risolvi gli errori più comuni

Di solito i problemi iniziali sono uno di questi tre. Ogni scheda mostra cosa vedi e l’unica cosa da cambiare.

  • tool

    Gli strumenti non compaiono

    Riavvia l’assistente dopo aver modificato la sua configurazione e controlla che il JSON sia valido.

  • chiave

    Chiave API mancante

    Inserisci SPICY_API_KEY nel blocco env della configurazione del server. Le app desktop non vedono una chiave esportata nella tua shell.

  • conferma

    Non riesce a creare attività

    Il tuo client non può mostrare richieste di conferma. Gli strumenti gratuiti funzionano comunque; per creare attività usa un client che supporti MCP elicitation.

Domande frequenti