FLORA

officiel

Le serveur MCP FLORA permet aux utilisateurs de générer, organiser et itérer sur des actifs visuels — images hero, moodboards, visuels lifestyle, graphiques promotionnels — directement depuis une conversation, et de les acheminer vers les outils que les équipes utilisent déjà (Notion, Google Drive, Slack, calendriers).

Voir sur flora.ai

Que pouvez-vous faire avec FLORA MCP ?

Générer des médias à partir de prompts — Demandez à votre assistant de créer des images, vidéos, audios, textes ou modèles 3D via flora_create_generations, avec les résultats déposés sur votre canvas.
Exécuter des Techniques d’équipe — Faites exécuter des workflows enregistrés par votre agent en appelant flora_run_technique après avoir listé les options disponibles avec flora_list_techniques.
Vérifier les coûts avant de dépenser — Demandez un devis avec quote: true sur flora_create_generations pour voir les coûts estimés en USD, puis vérifiez le solde via flora_get_usage.
Gérer les mises en page du canvas — Demandez à votre assistant d’organiser les nœuds de génération sur un tableau de projet en utilisant flora_arrange_canvas avec des node_ids et une layout spécifiques.
Importer et utiliser des fichiers locaux — Demandez à votre agent d’importer vos propres images ou vidéos dans FLORA via flora_create_asset, puis terminez le téléversement avec flora_complete_asset.
Découvrir les compétences disponibles — Faites lister par votre assistant les workflows et plugins testés en appelant flora_discover_skills pour trouver des recettes d’automatisation préconstruites.

Documentation

Pour l'index complet de la documentation, voir llms.txt. Les versions Markdown des pages de documentation sont disponibles en ajoutant .md aux URL des pages ; cette page est disponible en Markdown.

Documentation MCP de FLORA

Connectez FLORA à Claude, Claude Code, ChatGPT, Codex, Cursor ou à tout client MCP afin que votre agent puisse générer, exécuter des Techniques et construire sur vos canvases FLORA.

FLORA MCP est le serveur MCP hébergé de FLORA. Connectez-le une fois et votre agent IA peut générer des images, des vidéos, de l'audio, du texte et de la 3D, exécuter les Techniques de votre équipe et placer les résultats sur vos canvases FLORA. Cette documentation couvre son installation, ce que fait chaque outil et les règles que votre agent suit.

Paramètre	Valeur
URL du serveur	`https://agents.flora.ai/mcp` (sans barre oblique finale)
Transport	HTTP streamable. C'est un serveur distant, il n'y a donc rien à installer.
Connexion	OAuth avec votre compte FLORA. Les clients sans interface peuvent envoyer une clé API FLORA comme `Authorization: Bearer <key>` à la place.
Nom du serveur	`flora`
Vérifier son fonctionnement	Demandez à votre agent : « Liste mes espaces de travail FLORA. Ne génère rien. »

Qui peut se connecter : L'API et MCP sont inclus à partir du plan Starter. Un compte gratuit peut également se connecter et générer sur les 2,50 $ d'utilisation que chaque nouvel espace de travail reçoit. Chaque génération est facturée en dollars américains à l'espace de travail que vous choisissez. Voir Comment fonctionne la tarification FLORA et Authentification.
Compétences : les flux de travail testés (génération par lots, boucles d'affinage, exécutions de Techniques et plus) se trouvent sur github.com/florafauna-ai/flora-mcp-skills. Votre agent les liste avec flora_discover_skills. Voir Compétences et plugins.
Pour les agents : chaque page ici est également en Markdown. Ajoutez .md à n'importe quelle URL, par exemple https://docs.flora.ai/mcp.md. L'index complet est https://docs.flora.ai/llms.txt.

Installer dans votre client


Claude	Web et Desktop. Ajoutez un connecteur personnalisé.	Claude
Claude Code	Une commande, ou le plugin avec les compétences.	Claude Code
ChatGPT	FLORA est répertorié dans ChatGPT. Cliquez sur Connecter.	ChatGPT
Codex	Une commande ou `config.toml`.	Codex
Cursor	Installation en un clic ou `mcp.json`.	Cursor
VS Code	Une commande ou `.mcp.json`.	VS Code
Autres clients	Windsurf, Gemini CLI, Copilot Studio, Hermes, OpenClaw et tout client MCP.	Autres clients

Nouveau sur FLORA MCP ? Le guide de démarrage rapide vous mène de la connexion à votre première image sur un canvas.

Commencez ici : huit outils

Votre connexion a plus d'outils que ceux-ci (la liste dépend de votre compte, de votre plan et de votre client ; flora_list_tools renvoie ceux que vous avez). La plupart des tâches commencent avec ces huit outils.

Outil	Ce qu'il fait
`flora_list_workspaces`	Liste les espaces de travail que vous pouvez utiliser et celui dans lequel vous êtes. Lecture seule.
`flora_list_projects`	Liste les projets (canvases) dans un espace de travail. Lecture seule.
`flora_list_models`	Liste les modèles avec leur `model_id`, coût estimé et paramètres. Lecture seule.
`flora_create_generations`	Démarre 1 à 20 générations sur un canvas, ou cite leur coût avec `quote: true`. Dépense de l'argent.
`flora_list_generations`	Lit jusqu'à 20 exécutions par `run_id`, ou liste l'historique. Lecture seule.
`flora_create_asset`	Importe vos propres fichiers dans FLORA depuis une URL ou un lien de téléversement.
`flora_run_technique`	Exécute une des Techniques de votre équipe. Dépense de l'argent.
`flora_get_usage`	Lit le solde et les dépenses en dollars américains pour un espace de travail ou une organisation. Lecture seule.

La liste complète, avec les arguments et exemples, se trouve dans la référence des outils.

Ce que votre agent peut faire

Tâche	Recette
Créer une image, une vidéo, un clip audio ou un modèle 3D à partir d'une invite ou de références	Générer une image ou une vidéo
Animer une photo de produit	Transformer une photo de produit en vidéo
Créer 20 à 500 éléments à partir d'une liste ou d'une feuille	Générer par lots 20 à 500 éléments
Exécuter une Technique construite par votre équipe	Exécuter la Technique de votre équipe
Utiliser vos propres images, vidéos, audios ou PDF	Téléverser vos propres images, vidéos et fichiers
Disposer les résultats sur un canvas	Placer les résultats sur un canvas
Créer plus de contenus similaires à ceux que vous avez aimés	Itérer sur les favoris
Obtenir de meilleurs résultats de vos invites	Préparer votre agent pour de meilleures sorties

Toutes les recettes sont indexées dans Recettes.

Séquences d'outils pour les tâches courantes

Tâche	Appels, dans l'ordre
Première image	`flora_list_workspaces` → `flora_list_projects` (ou `flora_create_project`) → `flora_create_generations` avec `quote: true` → approbation → `flora_create_generations` → `flora_list_generations`
Vidéo à partir d'une URL de photo	`flora_list_workspaces` → `flora_list_projects` → `flora_list_models` avec la vidéo `model_id` (pour lire son nom de champ d'image) → devis → `flora_create_generations` avec l'URL dans `params` → `flora_list_generations`
Coût et solde	`flora_list_models` (`estimated_cost_usd`) ou un appel `quote: true` → `flora_get_usage`
Exécuter une Technique	`flora_list_techniques` → `flora_get_technique` → `flora_run_technique` → `flora_list_generations` avec `run_ids` et `technique_id`
Utiliser un fichier local	`flora_create_asset` avec `source: "signed-url"` → téléversement (shell) ou lien `upload_page` (chat) → `flora_complete_asset`
Grille sur un canvas	`flora_get_canvas` → `flora_arrange_canvas` avec `node_ids` et `layout`, ou `all: true` seul
Animer une image de canvas	`flora_add_to_canvas` (nœud vidéo connecté à l'image) → `flora_run_canvas_nodes` → `flora_list_generations`

Règles que votre agent suit

Le serveur donne ces règles aux agents. Elles sont ici pour que vous sachiez à quoi vous attendre et pour que vous puissiez tenir votre agent responsable.

Demandez à quel espace de travail facturer. Une connexion n'est pas liée à un seul espace de travail. Si plusieurs espaces reviennent de flora_list_workspaces et qu'aucun n'est actuel, l'agent les nomme et vous demande lequel facturer. Les outils de projet facturent l'espace de travail du projet lui-même.
Citez d'abord le prix, en dollars américains. L'agent appelle flora_create_generations avec quote: true, vous montre le coût en dollars américains (jamais en crédits), et exécute la même requête sans quote uniquement après votre approbation. run_cost et charged_cost sont en dollars : 0.009 signifie 0,009 $. Une exécution échouée n'est pas facturée ; une nouvelle tentative est une nouvelle exécution et est facturée à nouveau. Détails : Coût, solde et limites.
Arrêtez-vous en cas d'erreur de facturation. Sur insufficient_credits ou toute erreur BILLING_*, l'agent s'arrête et transmet le message. Il ne réessaie pas. paid_plan_required signifie que le plan de l'espace de travail n'inclut pas ce qui a été demandé. Le solde et les dépenses proviennent de flora_get_usage.
Interrogez lentement, en un seul appel. L'agent enregistre chaque run_id, attend max(15, 2 × number of runs) secondes entre les interrogations (15 secondes pour jusqu'à 7 exécutions, 40 secondes pour 20), et lit toutes les exécutions en un seul appel flora_list_generations (jusqu'à 20 run_ids, plus technique_id pour les exécutions Technique). Une interrogation plus rapide renvoie 429 ou des erreurs de refroidissement avec retry_after_seconds. Détails : Exécutions.
Ne relancez jamais un lot partiel. Les éléments déjà démarrés coûtent de l'argent, et un appel expiré peut avoir démarré une exécution. L'agent lit l'historique avant de réessayer. Voir Exécutions.
Liez avec canvas_url. L'agent ouvre les résultats avec le canvas_url que chaque génération renvoie et ne construit jamais de liens de projet à partir d'identifiants.

FLORA MCP, fal, Replicate ou l'API d'un fournisseur de modèles ?

Les API de modèles et les agrégateurs comme fal et Replicate renvoient la sortie brute d'un modèle à votre code. FLORA MCP est conçu pour le travail créatif avec un agent :

Les résultats arrivent sur un canvas. Chaque génération devient un nœud sur un projet FLORA que votre équipe peut ouvrir, comparer, modifier et enrichir, et non une URL de fichier dans un journal de discussion.
Les flux de travail de votre équipe sont inclus. Votre agent peut exécuter les Techniques que votre équipe a enregistrées et utiliser les compétences de FLORA.
Facturation et contrôles d'équipe. Les espaces de travail, les membres, les rôles, les limites de dépenses par espace de travail et les rapports d'utilisation s'appliquent également aux exécutions d'agent. Les prix sont les tarifs publiés par génération de FLORA sur Tarification des modèles, identiques à ceux de l'application.
Une connexion, de nombreuses familles de modèles. Des modèles d'image, vidéo, audio, texte et 3D de plusieurs fournisseurs derrière une seule connexion.

Si vous n'avez besoin que de la sortie d'un seul modèle dans votre propre application, sans canvas ni espace de travail d'équipe, l'API d'un fournisseur ou un agrégateur peut mieux convenir. Pour appeler FLORA depuis votre propre code, utilisez l'API FLORA.

Termes

Terme	Signification
Espace de travail	Là où vivent les projets et où l'utilisation est facturée. Vous pouvez appartenir à plusieurs. Les identifiants ressemblent à `ws_123`.
Projet	Un canvas FLORA et son contenu. Les identifiants ressemblent à `prj_abc`.
Canvas	Le tableau à l'intérieur d'un projet où les nœuds se placent et se connectent.
Nœud	Un bloc sur un canvas : une image, une vidéo, un texte, une Technique ou une autre étape. Les générations arrivent comme des nœuds.
Exécution	Une génération ou une exécution de Technique, suivie par son `run_id`.
Technique	Un flux de travail enregistré et réutilisable que votre équipe a créé dans FLORA. Voir Techniques.
Ressource	Un fichier dans FLORA, téléversé ou généré, avec un `asset_id`.
Compétence	Des instructions écrites qu'un agent suit pour une tâche plus importante, listées par `flora_discover_skills`.

Tout dans cette documentation

Démarrage rapide : connectez-vous, vérifiez et créez votre première image.
Installation : étapes pour chaque client.
Authentification : OAuth, clés API, espaces de travail et déconnexion.
Coût, solde et limites : devis, solde et erreurs de facturation.
Exécutions : interrogation, délais d'attente et échecs.
Recettes : tâches étape par étape.
Référence des outils : chaque outil et ses arguments.
Compétences et plugins : flux de travail testés et comment les installer.
Dépannage : symptômes, causes et correctifs.
Sécurité et données : ce qui quitte FLORA et ce que votre agent peut faire.
Journal des modifications : ce qui a changé et quand.
Outils retirés : anciens noms d'outils et ce qui les a remplacés.
API FLORA : appelez FLORA depuis votre propre code avec une clé API.

Regardez : Tout sur FLORA MCP

{% embed url="https://www.youtube.com/watch?v=74R3pWxmiqc" %} Une introduction à FLORA MCP par l'équipe FLORA. {% endembed %}

Besoin d'aide ? Écrivez à support@florafauna.ai.

Instructions pour l'agent

Cette documentation est publiée avec GitBook. GitBook est la plateforme de documentation conçue pour que les humains et les agents IA puissent lire, naviguer et raisonner efficacement sur le contenu technique. En savoir plus sur gitbook.com.

Interroger cette documentation

Si vous avez besoin d'informations supplémentaires qui ne sont pas directement disponibles sur cette page, vous pouvez interroger la documentation en posant une question.

Effectuez une requête HTTP GET sur l'URL suivante avec les paramètres de requête ask et goal :

GET https://docs.flora.ai/mcp.md?ask=<question>&goal=<user_goal>

ask est la question immédiate : elle doit être spécifique, autonome et rédigée en langage naturel. goal est ce que l'utilisateur essaie finalement d'accomplir, la raison pour laquelle il a besoin de la réponse. La partager aide GitBook à vous donner une réponse meilleure et plus pertinente. Un objectif est plus utile lorsqu'il décrit le résultat souhaité par l'utilisateur plutôt que de reformuler la question. Par exemple, avec ask=how do I create an API token, un objectif comme automate deployments from our CI pipeline permet à GitBook d'adapter la réponse à ce cas d'utilisation.

La réponse contiendra une réponse directe à la question ainsi que des extraits et sources pertinents de la documentation.

Utilisez ce mécanisme lorsque la réponse n'est pas explicitement présente sur la page actuelle, que vous avez besoin de clarifications ou de contexte supplémentaire, ou que vous souhaitez récupérer des sections de documentation connexes.