Étape par étape : configurer le serveur MCP de génération d’images
Étape 1 : Obtenez votre clé API et protégez-la
Obtenez une clé API Freebeat sur le site de Freebeat. Conservez-la en lieu sûr pendant la préparation de la configuration du client ; le serveur la lit dans la variable d’environnement FREEBEAT_API_KEY.
Vous avez réussi si : Vous disposez d’une clé valide à ajouter au client MCP, sans la placer dans un fichier ou un message public.
Erreur courante à éviter : Laisser le texte d’exemple your-api-key-here dans la configuration finale.
Étape 2 : Vérifiez que le client peut exécuter le package
Utilisez un client MCP compatible, tel que Claude Desktop ou Cursor. Vérifiez que Node.js/npm et l’accès réseau sont disponibles dans l’environnement qui lance le client, car la commande documentée exécute le package avec npx.
Vous avez réussi si : L’environnement du client peut trouver la commande npx et accéder aux services en ligne.
Erreur courante à éviter : Tester npm dans un environnement différent de celui utilisé par le client de bureau.
Étape 3 : Ajoutez la configuration du serveur
Dans la section de configuration MCP de votre client, ajoutez un serveur nommé freebeat. La structure de configuration documentée est identique pour Claude Desktop et Cursor :
Vous avez réussi si : La configuration est un JSON valide et contient la commande, les arguments et la variable d’environnement.
Erreur courante à éviter : Ajouter des virgules finales ou modifier le nom du package, ce qui peut empêcher le client de lancer le serveur.
Étape 4 : Définissez la variable d’environnement
Remplacez la valeur fictive par votre clé API dans la configuration locale du client. Conservez le nom exact de la variable, tel qu’il est documenté : FREEBEAT_API_KEY.
Vous avez réussi si : La clé est présente dans l’environnement du serveur et l’entrée du serveur reste un JSON valide.
Erreur courante à éviter : Utiliser un autre nom de variable, ajouter des espaces à la clé ou exposer le secret dans des journaux partagés.
Étape 5 : Enregistrez la configuration et reconnectez-vous
Enregistrez les paramètres MCP. Si le client ne recharge pas automatiquement l’entrée du serveur, redémarrez-le ou actualisez-le, puis vérifiez que les outils MCP Freebeat sont disponibles dans le client.
Vous avez réussi si : Le client reconnaît le serveur Freebeat et affiche les outils disponibles.
Erreur courante à éviter : Chercher à résoudre des problèmes de génération avant d’avoir confirmé que le serveur est connecté et que ses outils sont visibles.
Étape 6 : Découvrez un modèle d’image et consultez ses consignes
Appelez list_models avec type: "image". Choisissez l’un des modèles renvoyés et, si nécessaire, appelez get_model_help avec son model_id numérique ou sa clé de modèle API pour consulter les exemples et les contraintes. Cette étape de découverte des modèles d’image évite de deviner les identifiants de modèle.
Vous avez réussi si : Vous disposez d’un modèle d’image valide et connaissez les exigences spécifiques à ce modèle qui s’appliquent à votre demande.
Erreur courante à éviter : Inscrire en dur un nom de modèle supposé au lieu d’en choisir un dans la réponse actuelle.
Étape 7 : Générez une image et interrogez le lot
Appelez generate_image avec le modèle sélectionné et un prompt descriptif. Après suppression des espaces de début et de fin, le prompt doit compter entre 1 et 2 000 caractères. Les champs facultatifs comprennent size, resolution, quality et count ; la valeur par défaut de count est 1. Pour GPT-Image 2 (ID de modèle 108), si quality et resolution ne sont pas indiqués, leurs valeurs par défaut sont medium et 1024x1024. Si resolution est omis et que size est fourni, le serveur envoie également size comme résolution pour assurer la compatibilité.
Vous avez réussi si : La requête renvoie un ID de lot que vous pouvez utiliser pour vérifier le statut de la tâche et récupérer les URL des images une fois le traitement terminé.
Erreur courante à éviter : Envoyer un prompt vide, trop long ou composé uniquement d’espaces ; respectez les contraintes relatives aux prompts et consultez l’aide du modèle avant de réessayer.
Étape 8 : Vérifiez le statut et examinez le résultat
Interrogez get_task_status en fournissant le batch_id renvoyé comme task_id. Pour un lot d’images Open RPC, vous pouvez également transmettre serial_no pour vérifier un élément en particulier. Recherchez un statut final tel que completed ou failed ; les lots d’images terminés incluent les URL des images dans la réponse de statut, avec des champs tels que image_url ou edit_images.
Vous avez réussi si : La tâche atteint un statut final et, si elle est terminée, la réponse contient un résultat d’image.
Erreur courante à éviter : Appeler get_task_result pour un lot d’images Open RPC ; les résultats des images terminées sont renvoyés directement par get_task_status.