Passer au contenu principal
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ètreValeur
TransportStreamable HTTP
URLhttps://api.krea.ai/mcp
AuthentificationOAuth
La facturation dépend de la manière dont vous vous authentifiez :
Méthode d’authentificationSource de facturation
OAuthLes unités de calcul de votre compte Krea connecté
Jeton APILe 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. L’utilisation via OAuth est facturée à votre compte Krea connecté en unités de calcul. Si votre client MCP ne prend pas en charge OAuth, vous pouvez vous authentifier avec un jeton API à la place :
Clé d’en-têteValeur d’en-tête
AuthorizationBearer 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

  1. Ouvrez Settings > MCP servers dans Codex.
  2. Ajoutez un nouveau serveur.
  3. Sélectionnez Streamable HTTP comme transport.
  4. Collez l’URL du serveur :
https://api.krea.ai/mcp
  1. 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.

​
Dépannage

ProblèmeSolution
L’authentification échoueReconnectez 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 connecterVé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 facturationSi vous vous êtes connecté avec OAuth, vérifiez les unités de calcul de votre compte Krea connecté. Si vous vous êtes connecté avec un jeton API, ajoutez du solde API sur krea.ai/app/api.
L’appel d’un modèle échoueDemandez à 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.