Vai al contenuto principale
Krea espone un server Model Context Protocol (MCP) gestito per agenti e assistenti di programmazione. Usalo quando vuoi che un client compatibile con MCP chiami Krea direttamente invece di scrivere richieste API a mano.
Non ti serve una chiave API per connetterti. Aggiungi https://api.krea.ai/mcp come URL del server MCP, quindi accedi con il tuo account Krea tramite il flusso OAuth del tuo client.

​
Dettagli del server

ImpostazioneValore
TrasportoStreamable HTTP
URLhttps://api.krea.ai/mcp
AutenticazioneOAuth
La fatturazione dipende da come ti autentichi:
Metodo di autenticazioneFonte di fatturazione
OAuthLe unità di calcolo del tuo account Krea con cui hai effettuato l’accesso
Token APIIl saldo API separato del tuo workspace

​
Autenticazione

La maggior parte dei client MCP usa OAuth automaticamente. Quando il client ti chiede di connetterti, segui il flusso di accesso nel browser e autorizza Krea. L’utilizzo via OAuth viene addebitato al tuo account Krea con cui hai effettuato l’accesso utilizzando le unità di calcolo. Se il tuo client MCP non supporta OAuth, puoi autenticarti con un token API:
Chiave dell’headerValore dell’header
AuthorizationBearer KREA_API_TOKEN
Sostituisci KREA_API_TOKEN con un token da krea.ai/app/api/tokens. Solo i proprietari e gli amministratori del workspace possono creare token API. L’utilizzo con token API viene addebitato al saldo API del tuo workspace, allo stesso modo delle chiamate API dirette. Vedi Chiavi API e fatturazione per i dettagli sul saldo API.
Conserva le credenziali MCP con token API allo stesso modo in cui conservi le chiavi API. Non fare commit di file di configurazione MCP che contengono token reali.

​
Claude Code

Esegui questo comando nel tuo terminale: 
claude mcp add --transport http krea-ai https://api.krea.ai/mcp
Accedi con il tuo account Krea quando Claude Code ti chiede di connetterti. Riavvia Claude Code o ricarica i tuoi server MCP dopo aver aggiunto il server.

​
Codex

  1. Apri Settings > MCP servers in Codex.
  2. Aggiungi un nuovo server.
  3. Seleziona Streamable HTTP come trasporto.
  4. Incolla l’URL del server:
https://api.krea.ai/mcp
  1. Salva il server e accedi con il tuo account Krea quando Codex ti chiede di connetterti.

​
Cursor

Apri la palette dei comandi, cerca Open MCP settings, quindi aggiungi questa voce a mcp.json: 
{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}
Riavvia Cursor dopo aver salvato il file, quindi accedi con il tuo account Krea quando Cursor ti chiede di connetterti.

​
Usare Krea tramite MCP

Una volta connesso, chiedi al tuo agente di elencare i modelli Krea o di ispezionare lo schema di un modello prima di generare. Gli ID dei modelli corrispondono ai percorsi API usati nel resto della documentazione per sviluppatori, come image/krea/krea-2/medium o video/google/veo-3.1. Per esempio: 
List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.
Se un modello è deprecato, Krea restituisce i metadati di deprecazione tramite la scoperta dei modelli MCP. Vedi Deprecazioni per le linee guida sulla migrazione.

​
Risoluzione dei problemi

ProblemaSoluzione
L’autenticazione fallisceRiconnetti il server MCP e completa il flusso OAuth di Krea nel tuo browser. Se usi un token API, conferma che l’header sia esattamente Authorization: Bearer KREA_API_TOKEN e che il token non sia stato revocato.
Il client non riesce a connettersiVerifica che il client sia configurato per Streamable HTTP e usi https://api.krea.ai/mcp.
La generazione viene rifiutata per fatturazioneSe ti sei connesso con OAuth, controlla le unità di calcolo sul tuo account Krea con cui hai effettuato l’accesso. Se ti sei connesso con un token API, aggiungi saldo API su krea.ai/app/api.
La chiamata al modello fallisceChiedi al tuo agente di ispezionare lo schema del modello prima di riprovare. Le richieste MCP usano gli stessi input dei modelli dell’API.

​
Prossimi passi

Chiavi API e fatturazione

Crea token API e gestisci il saldo API per le richieste autenticate con token.

Playground interattivo

Prova le richieste nell’app Krea prima di chiedere a un agente di eseguirle.

Deprecazioni

Scopri come MCP espone i metadati di migrazione dei modelli.

API dei modelli

Esplora gli schemi degli endpoint e i parametri dei modelli.