MCP
MCP
Le serveur MCP DesignerBox permet à un assistant AI de travailler directement avec votre compte DesignerBox. Demandez à Claude de générer une photo de produit, d'appliquer un modèle, de vérifier votre solde de crédits ou de récupérer une ressource de votre bibliothèque, et cela se produit dans votre compte et apparaît dans l'application.
MCP (Model Context Protocol) est un standard ouvert pour connecter les assistants AI à des outils externes. DesignerBox héberge son propre serveur MCP, il n'y a donc rien à installer ni rien à héberger vous-même.
URL du serveur
Connectez votre client à :
https://mcp.designerbox.ai/api
Le chemin est /api, pas /mcp. Le serveur communique en JSON-RPC 2.0 via HTTP streamable.
Connectez votre assistant
Les étapes exactes varient selon le client, mais le principe est toujours le même : ajoutez un connecteur personnalisé, collez l'URL du serveur et connectez-vous.
Claude (web, Desktop et Cowork)
- Ouvrez les paramètres, puis la section des connecteurs.
- Choisissez d'ajouter un connecteur personnalisé.
- Collez
https://mcp.designerbox.ai/api. - Terminez la connexion DesignerBox lorsque votre navigateur s'ouvre.
- Démarrez une conversation et demandez quelque chose, par exemple "liste mes designs DesignerBox".
Le connecteur s'enregistre automatiquement, il n'y a donc ni client ID ni secret à copier. Une fois la connexion établie dans Claude, elle est aussi disponible dans Cowork.
Cursor et autres clients MCP
Tout client prenant en charge les serveurs MCP distants via HTTP streamable fonctionne. Pointez-le vers la même URL. Les clients qui gèrent la découverte OAuth trouveront le flux de connexion par eux-mêmes.
Authentification
MCP DesignerBox utilise uniquement OAuth. Vous vous connectez via votre navigateur et votre client reçoit un jeton limité à votre compte. Il n'y a aucune clé API à coller, et les clés API des autres parties de DesignerBox ne sont pas acceptées ici.
Le serveur prend en charge l'enregistrement dynamique des clients, les clients bien conçus se configurent donc à partir de la seule URL. Les jetons sont émis avec ces portées :
openid- identifie votre compte.mcp:read- lit vos designs, ressources, modèles et abonnement.mcp:write- génère des médias et modifie vos données.offline_access- rafraîchit la session pour ne pas avoir à vous reconnecter chaque jour.
Votre appartenance à l'équipe est vérifiée à chaque requête, retirer quelqu'un d'une équipe révoque donc son accès immédiatement, sans attendre l'expiration d'un jeton.
Pour consulter ou révoquer un assistant connecté, ouvrez les connexions MCP dans les paramètres de votre compte dans l'application. Une révocation à cet endroit déconnecte ce client.
Ce que votre assistant peut faire
Le serveur expose 63 outils, 37 en lecture et 26 en écriture. Vous n'avez pas besoin de retenir leurs noms. Demandez ce que vous voulez en langage naturel et l'assistant choisit l'outil.
Les domaines principaux :
- Générer. Images, vidéos, prises de vue cinema studio et personnages AI.
- Éditer. Suppression d'arrière-plan, changement d'éclairage et d'angles, retouche de peau, essayage virtuel, flat lays et publicités produit.
- Modèles et techniques. Parcourez le catalogue sélectionné et appliquez un modèle à vos propres images de référence.
- Bibliothèque. Listez et récupérez vos designs, ressources, dossiers et galeries, ou importez une nouvelle ressource directement depuis la conversation.
- Marque. Lisez et mettez à jour votre profil de marque et vos ressources de marque.
- Flux de travail. Listez, créez et exécutez des pipelines depuis le canevas.
- Compte. Consultez votre abonnement, votre solde de crédits, vos limites et vos équipes.
Les outils de lecture et d'écriture sont identifiés pour que votre assistant sache quelles actions modifient votre compte. La plupart des clients vous demandent de confirmer avant d'exécuter un outil d'écriture la première fois.
Essayez ceci
- "Génère une photo produit d'une gourde noire mate sur une surface en béton."
- "Quels modèles avez-vous pour les flat lays de mode ?"
- "Combien de crédits me reste-t-il ce mois-ci ?"
- "Supprime l'arrière-plan de la dernière image que tu as générée."
- "Liste mes designs de cette semaine."
Abonnements et crédits
Les générations consomment des crédits du même pool mensuel que celui utilisé par l'application. Il n'y a pas de quota MCP séparé ni de frais supplémentaires pour utiliser MCP. L'abonnement Free inclut 112 crédits (environ quatre images sur le modèle par défaut), vous pouvez donc essayer la génération avant de passer à un abonnement supérieur ; une fois les crédits épuisés, les outils de génération s'arrêtent jusqu'au renouvellement de votre quota ou jusqu'à un upgrade, tandis que les outils de lecture continuent de fonctionner.
Le coût d'une image dépend du modèle :
| Modèle | Crédits par image |
|---|---|
| Seedream 5 | 4 |
| FLUX Pro 1.1 | 5 |
| Nano Banana 2 | 7 |
| FLUX 2 Flex | 7 |
| Nano Banana Pro | 14 |
| GPT Image 2 | 22 |
Autres opérations :
| Opération | Crédits |
|---|---|
| Appliquer une technique à une image | Le coût par image du modèle choisi (14 sur le modèle par défaut) |
| Supprimer l'arrière-plan | 3 |
| Cinema studio | 2 par image |
| AI Character (9 poses) | 25 |
| Vidéo | Tarif du modèle par seconde, multiplié par la durée |
Demandez à votre assistant de lister les modèles d'image ou de vidéo si vous voulez connaître les coûts et les capacités actuels sans quitter la conversation. Consultez Abonnements, crédits et limites pour le tableau complet.
Délais de traitement
Certains outils se terminent dans la conversation, d'autres s'exécutent en arrière-plan :
- Les images se terminent dans la conversation. Une génération prend environ 30 secondes, et l'assistant renvoie l'image une fois qu'elle est prête.
- Les vidéos et les AI Characters s'exécutent en arrière-plan. Vous recevez immédiatement une référence de tâche, et l'assistant vérifie le statut jusqu'à ce qu'elle soit prête. Vous pouvez continuer à travailler, ou revenir plus tard et demander si elle est terminée.
Tout ce que vous générez est enregistré dans votre bibliothèque DesignerBox, c'est donc dans l'application, que la conversation soit encore ouverte ou non.
Limites
Les requêtes sont limitées en débit par compte. Un usage conversationnel normal reste largement dans les limites. Si un assistant boucle ou lance un gros lot de requêtes, il peut être brièvement ralenti et devrait réessayer.
Dépannage
L'assistant dit qu'il ne trouve pas le serveur. Vérifiez que l'URL se termine par /api. https://mcp.designerbox.ai/mcp n'est pas valide et renvoie une erreur not found.
La connexion réussit mais les outils échouent avec une erreur d'autorisation. Votre jeton a peut-être été révoqué, ou vous avez été retiré de l'équipe. Reconnectez le connecteur.
Une génération s'arrête et mentionne les crédits. Vos crédits mensuels sont épuisés (l'abonnement Free commence avec 112). Les outils de lecture continuent de fonctionner ; pour générer à nouveau, attendez le renouvellement de votre quota, achetez un pack de crédits ou passez à un abonnement supérieur. Vérifiez votre solde dans l'application, ou demandez votre abonnement à l'assistant.
L'assistant choisit le mauvais outil. Soyez précis sur le résultat attendu. "Applique le modèle flat lay en lin à cette photo" est plus efficace que "rends cette image plus jolie".
En relation
- API - l'API REST, pour le code plutôt que la conversation.
- Abonnements, crédits et limites - comment les générations consomment des crédits.
- Flux de travail et canevas - les pipelines que MCP peut exécuter.
- Techniques et modèles - le catalogue que votre assistant peut appliquer.