MCP

Krea expose un serveur Model Context Protocol (MCP) hébergé pour les agents et les assistants de programmation. Utilisez-le lorsque vous souhaitez qu’un client compatible MCP appelle Krea directement, plutôt que d’écrire des requêtes API à la main.

Vous n’avez pas besoin d’une clé API pour vous connecter. Ajoutez https://api.krea.ai/mcp comme URL de serveur MCP, puis connectez-vous avec votre compte Krea via le flux OAuth de votre client.

Détails du serveur

Paramètre	Valeur
Transport	Streamable HTTP
URL	`https://api.krea.ai/mcp`
Authentification	OAuth

La facturation dépend de la manière dont vous vous authentifiez :

Méthode d’authentification	Source de facturation
OAuth	Les unités de calcul de l’espace de travail que vous sélectionnez lors du consentement
Jeton API	Le solde API distinct de votre espace de travail

Authentification

La plupart des clients MCP utilisent OAuth automatiquement. Lorsque le client vous invite à vous connecter, suivez le flux de connexion dans le navigateur et autorisez Krea.

Choisir un espace de travail lors du consentement

L’écran de consentement OAuth comprend un sélecteur Espace de travail qui répertorie tous les espaces de travail auxquels vous appartenez. Votre espace de travail par défaut est présélectionné ; choisissez-en un autre si vous souhaitez que cette session MCP s’exécute ailleurs (par exemple, un espace de travail de studio partagé plutôt que votre espace personnel). L’espace de travail que vous sélectionnez est lié à la session OAuth et détermine :

Facturation. Les unités de calcul sont déduites de l’espace de travail sélectionné, et non simplement du compte connecté.
Portée des ressources. Les fichiers téléversés via des outils tels que upload_asset sont enregistrés dans l’espace de travail lié, et les outils qui nécessitent un téléversement (par exemple, get_upload_url) ne fonctionnent qu’une fois qu’un espace de travail est lié.

Pour changer l’espace de travail lié ultérieurement, déconnectez Krea dans votre client MCP et reconnectez-vous — le sélecteur réapparaîtra.

Les anciennes sessions OAuth créées avant l’introduction du sélecteur d’espace de travail n’ont pas de liaison explicite. Ces sessions reviennent à l’espace de travail par défaut de votre compte. Reconnectez-vous pour lier la session à un espace de travail spécifique.

Si votre client MCP ne prend pas en charge OAuth, vous pouvez vous authentifier avec un jeton API à la place :

Clé d’en-tête	Valeur d’en-tête
`Authorization`	`Bearer KREA_API_TOKEN`

Remplacez KREA_API_TOKEN par un jeton issu de krea.ai/app/api/tokens. Seuls les propriétaires et les administrateurs de l’espace de travail peuvent créer des jetons API. L’utilisation via jeton API est facturée sur le solde API de votre espace de travail, comme pour les appels API directs. Consultez Clés API et facturation pour plus de détails sur le solde API.

Stockez les identifiants MCP par jeton API de la même manière que vos clés API. Ne validez pas (commit) des fichiers de configuration MCP contenant de vrais jetons.

Claude Code

Exécutez cette commande dans votre terminal :

claude mcp add --transport http krea-ai https://api.krea.ai/mcp

Connectez-vous avec votre compte Krea lorsque Claude Code vous le demande. Redémarrez Claude Code ou rechargez vos serveurs MCP après avoir ajouté le serveur.

Codex

Ouvrez Settings > MCP servers dans Codex.
Ajoutez un nouveau serveur.
Sélectionnez Streamable HTTP comme transport.
Collez l’URL du serveur :

https://api.krea.ai/mcp

Enregistrez le serveur et connectez-vous avec votre compte Krea lorsque Codex vous le demande.

Cursor

Ouvrez la palette de commandes, recherchez Open MCP settings, puis ajoutez cette entrée à mcp.json :

{
  "mcpServers": {
    "krea-ai": {
      "url": "https://api.krea.ai/mcp"
    }
  }
}

Redémarrez Cursor après avoir enregistré le fichier, puis connectez-vous avec votre compte Krea lorsque Cursor vous le demande.

Utiliser Krea via MCP

Une fois connecté, demandez à votre agent de lister les modèles Krea ou d’inspecter le schéma d’un modèle avant de générer. Les identifiants de modèles correspondent aux chemins d’API utilisés dans le reste de la documentation développeur, par exemple image/krea/krea-2/medium ou video/google/veo-3.1. Par exemple :

List the available Krea image models, then generate an image with Krea 2 using a 16:9 aspect ratio.

Si un modèle est déprécié, Krea renvoie des métadonnées de dépréciation via la découverte de modèles MCP. Consultez Dépréciations pour les conseils de migration.

Outils

Le serveur MCP de Krea expose des outils qui correspondent à l’API publique. Votre agent les découvre automatiquement via tools/list ; les plus courants sont :

Outil	Ce qu’il fait
`list_models`	Liste les modèles d’image et de vidéo disponibles.
`get_model_schema`	Inspecte le schéma d’entrée d’un modèle avant de générer.
`generate`	Soumet un job de génération d’image ou de vidéo.
`execute_node_app`	Exécute une node app.
`get_job`	Récupère le statut actuel et la sortie d’un job à partir de son `jobId`.
`cancel_job`	Annule un job en cours et le supprime de la liste de vos jobs.
`get_upload_url`	Demande une URL présignée à durée de vie courte pour téléverser un fichier local à utiliser comme entrée d’un modèle.

Les sorties des outils de génération et de node app incluent le job_id du job soumis, en plus du payload du job. Passez cet ID à get_job pour interroger le statut, ou à cancel_job pour arrêter un job dont vous n’avez plus besoin.

Annuler un job

cancel_job appelle DELETE /jobs/{id} en arrière-plan et renvoie { "job_id": "...", "deleted": true } en cas de succès. L’annulation ne prend effet que tant que le job se trouve dans un état non terminal — consultez Cycle de vie d’un job pour les règles et les implications de facturation (les jobs annulés ne sont pas facturés). Exemple de prompt :

Cancel job 7f3c9b1a-… because the prompt was wrong.

Fournir des entrées média

Toute entrée de modèle qui accepte une URL média (par exemple start_image, image_style_references[].url ou reference_images) accepte l’une des trois formes suivantes :

Une URL externe — un lien https:// accessible publiquement vers un fichier image, vidéo, audio ou modèle 3D.
Une data URI en base64 — par exemple data:image/png;base64,iVBORw0KGgo….
Une URL d’asset téléversé — l’URL renvoyée après le téléversement d’un fichier local sur Krea.

Les listes d’URL séparées par des virgules ne sont pas prises en charge. Passez chaque entrée comme son propre champ ou élément de tableau.

Téléverser un fichier local avec `get_upload_url`

Lorsque le fichier que vous souhaitez utiliser se trouve sur votre machine locale et n’est pas déjà hébergé quelque part, demandez à votre agent d’appeler get_upload_url. L’outil renvoie une URL présignée valable trois heures. Votre client envoie ensuite le fichier en POST à cette URL au format multipart/form-data avec un unique champ file, et le corps de la réponse contient une URL d’asset que vous pouvez passer à un appel generate ultérieur. Exemple de flux :

# 1. Ask the agent to call get_upload_url through MCP. It returns something like:
#    https://api.krea.ai/public-api/assets/presigned/...

# 2. POST the local file to that presigned URL.
curl -X POST "$UPLOAD_URL" -F "file=@/path/to/image.png"

# 3. The response body contains the asset URL. Use it in the next generate call,
#    for example as start_image or image_style_references[].url.

Si le POST de téléversement échoue à cause d’une sortie réseau restreinte, ajoutez api.krea.ai à la liste des domaines autorisés de votre client. L’URL présignée est servie depuis le même hôte que le reste de l’API publique.

Si votre fichier est déjà accessible à une URL publique ou si vous pouvez l’encoder sous forme de data URI en base64, sautez get_upload_url et passez cette valeur directement dans l’entrée de génération. Les appels aux outils de génération et de node app joignent une ressource d’interface MCP Apps. Les clients MCP qui prennent en charge MCP Apps affichent un widget interactif de résultat de job en ligne avec la réponse de l’outil, comprenant :

Une vignette de chargement dimensionnée selon le rapport d’aspect du job pendant que celui-ci est en file d’attente ou en cours de traitement.
Le polling automatique de get_job afin que le widget se mette à jour à mesure que le job avance, sans que l’agent ait à appeler get_job lui-même.
Des boutons d’action pour relancer la génération ou annuler le job depuis le widget.
Un curseur de comparaison avant/après en plein écran pour les résultats d’enhance.

Le widget est exposé sous la forme de la ressource ui://krea-public-api/job-result-frame et est branché automatiquement — aucune configuration côté client n’est requise. Les clients qui ne prennent pas en charge MCP Apps ignorent simplement la ressource et se rabattent sur la sortie structurée de l’outil. Comme le widget effectue le polling à votre place, préférez la génération asynchrone (le mode par défaut) lorsque vous voulez que l’interface affiche la progression. N’utilisez le mode synchrone que lorsque l’utilisateur demande explicitement à attendre le résultat final dans la réponse de l’outil.

Dépannage

Problème	Solution
L’authentification échoue	Reconnectez le serveur MCP et complétez le flux OAuth de Krea dans votre navigateur. Si vous utilisez un jeton API, vérifiez que l’en-tête est exactement `Authorization: Bearer KREA_API_TOKEN` et que le jeton n’a pas été révoqué.
Le client ne peut pas se connecter	Vérifiez que le client est configuré pour Streamable HTTP et qu’il utilise `https://api.krea.ai/mcp`.
La génération est rejetée pour des raisons de facturation	Si vous vous êtes connecté avec OAuth, vérifiez les unités de calcul de l’espace de travail que vous avez sélectionné lors du consentement — reconnectez-vous si vous devez lier la session à un autre espace de travail. Si vous vous êtes connecté avec un jeton API, ajoutez du solde API sur krea.ai/app/api.
L’appel d’un modèle échoue	Demandez à votre agent d’inspecter le schéma du modèle avant de réessayer. Les requêtes MCP utilisent les mêmes entrées de modèle que l’API.

Étapes suivantes

Clés API et facturation

Créez des jetons API et gérez le solde API pour les requêtes authentifiées par jeton.

Playground interactif

Essayez des requêtes dans l’application Krea avant de demander à un agent de les exécuter.

Dépréciations

Découvrez comment MCP expose les métadonnées de migration des modèles.

API de modèles

Parcourez les schémas des endpoints et les paramètres des modèles.

Premiers pas

Krea 2

Concepts clés

Exemples de code

Détails du serveur

Authentification

Choisir un espace de travail lors du consentement

Claude Code

Codex

Cursor

Utiliser Krea via MCP

Outils

Annuler un job

Fournir des entrées média

Téléverser un fichier local avec `get_upload_url`

Widget d’interface MCP Apps

Dépannage

Étapes suivantes

Clés API et facturation

Playground interactif

Dépréciations

API de modèles

​Détails du serveur

​Authentification

​Choisir un espace de travail lors du consentement

​Claude Code

​Codex

​Cursor

​Utiliser Krea via MCP

​Outils

​Annuler un job

​Fournir des entrées média

​Téléverser un fichier local avec get_upload_url

​Widget d’interface MCP Apps

​Dépannage

​Étapes suivantes

Clés API et facturation

Playground interactif

Dépréciations

API de modèles

Détails du serveur

Authentification

Choisir un espace de travail lors du consentement

Claude Code

Codex

Cursor

Utiliser Krea via MCP

Outils

Annuler un job

Fournir des entrées média

Téléverser un fichier local avec `get_upload_url`

Widget d’interface MCP Apps

Dépannage

Étapes suivantes