Pour qui est FlowZap ?

FlowZap est-il pour moi si je construis des agents IA ?

Absolument. Bien que FlowZap puisse être utilisé par tout Analyste d'affaires ou Développeur, il est conçu pour les solopreneurs et créateurs d'agents IA qui doivent visualiser des workflows d'agents — comme « extracteur de tendances → générateur de contenu → robot planificateur » — sans se battre avec la syntaxe Mermaid ou déplacer des boîtes dans Miro. Si vous codez « au feeling » dans Cursor, Windsurf, Bolt, Lovable, GPT, Claude, vous rencontrerez ce moment où les branches logiques s'emmêlent ou où vous ne pouvez pas expliquer vos passages multi-agents : FlowZap est votre bloc-notes IA ultra-rapide : demandez, obtenez des **diagrammes à triple vue** (Flux + Séquence + Architecture), ajustez le code, itérez.

Où FlowZap s’intègre‑t‑il dans mon flux de travail ?

Le « vibe coding » consiste à construire vite avec des outils IA (Lovable, Bolt, GPT, Claude, Windsurf, Cursor, etc.) en décrivant des apps en langage naturel pour obtenir des prototypes instantanés — la vitesse avant tout. FlowZap amplifie cela en visualisant le processus sous‑jacent : transformez un plan GPT comme « scheduler TikTok viral avec IA » en organigramme avec des couloirs pour « Analyseur IA » et « Robot planificateur », puis basculez en vue séquence pour voir les soucis de timing comme les réponses API retardées. C’est l’accélérateur créatif qui repère les inefficacités avant que votre prototype ne cale.

J'utilise Cursor/Claude/Windsurf — comment FlowZap s'intègre‑t‑il ?

Installez le package npm `flowzap-mcp` et ajoutez-le à la configuration MCP de votre assistant IA. Cela donne à votre IA 8 outils essentiels : `flowzap_validate` (valider la syntaxe), `flowzap_create_playground` (créer des URLs playground partageables), `flowzap_get_syntax` (obtenir la documentation DSL), `flowzap_export_graph` (analyser en un graphe JSON structuré), `flowzap_artifact_to_diagram` (convertir des logs HTTP / OpenAPI / code en diagrammes), `flowzap_diff` (comparer deux versions), `flowzap_apply_change` (appliquer des opérations de correctif structurées), et `flowzap_compliance_check` (audit SOC2 / GDPR / PIPL). Aucune authentification requise — utilise les APIs publiques de FlowZap avec limitation de débit intégrée (30 requêtes/minute).

Qu'est-ce que le format de fichier .fz ?

L'extension `.fz` est le format natif « Diagrammes en Code » de FlowZap — des fichiers texte UTF-8 contenant du FlowZap Code. Sauvegardez vos diagrammes en fichiers `.fz` pour les versionner dans Git, les partager avec vos coéquipiers, ou les charger dans n'importe quelle session FlowZap. C'est lisible par l'humain, compatible IA, et s'intègre parfaitement à votre workflow de développement. Cliquez sur « Sauvegarder en fichier .fz » dans la modale FlowZap Code pour télécharger votre diagramme actuel.

Comment utiliser FlowZap avec Claude, Cursor ou Windsurf (MCP) ?

Installez le package npm `flowzap-mcp` : ajoutez `{"mcpServers": {"flowzap": {"command": "npx", "args": ["-y", "flowzap-mcp"]}}}` à la config MCP de votre assistant IA. Cela donne à votre IA 8 outils essentiels : `flowzap_validate` (valider la syntaxe), `flowzap_create_playground` (créer des URLs playground partageables), `flowzap_get_syntax` (obtenir la documentation DSL), `flowzap_export_graph` (analyser en un graphe JSON structuré), `flowzap_artifact_to_diagram` (convertir des logs HTTP / OpenAPI / code en diagrammes), `flowzap_diff` (comparer deux versions), `flowzap_apply_change` (appliquer des opérations de correctif structurées), et `flowzap_compliance_check` (audit SOC2 / GDPR / PIPL). Aucune authentification requise — utilise les APIs publiques de FlowZap avec limitation de débit intégrée (30 requêtes/minute).

Quelles APIs publiques FlowZap offre-t-il ?

FlowZap fournit deux endpoints API publics : `POST /api/validate` valide la syntaxe FlowZap Code (30 requêtes/min par IP), et `POST /api/playground/create` génère des URLs playground éphémères avec TTL de 60 minutes (5 requêtes/min, 50/jour par IP). Les deux sont gratuits, ne nécessitent pas d'authentification, et sont conçus pour les assistants IA et outils d'automatisation. L'abus peut entraîner un blocage IP.

C'est quoi la triple vue et pourquoi c'est génial ?

Un seul FlowZap Code bascule entre **trois vues** : Workflow (couloirs horizontaux), Séquence (chronologie verticale d'interactions), et Architecture (diagrammes système avec formes et connexions) — éditez dans l'un, les autres se mettent à jour instantanément. Pour les systèmes multi-agents, le workflow montre les voies parallèles GPT/Claude ; la séquence expose les délais de relais API ; l'architecture visualise la conception de votre système avec composants et connexions. Repérez les problèmes, ajoutez une gestion asynchrone, itérez sans tout reconstruire.

Pour les agents IA

Comment les agents IA découvrent-ils FlowZap ?

FlowZap publie un ensemble complet de surfaces de découverte well-known afin qu'un agent puisse le trouver et le comprendre de façon autonome, sans aucune configuration humaine. Les points d'entrée sont la carte d'agent A2A à l'adresse https://flowzap.xyz/.well-known/agent-card.json, le manifeste de capacités à l'adresse https://flowzap.xyz/.well-known/capabilities.json, les fichiers de contexte LLM à l'adresse https://flowzap.xyz/llms.txt et https://flowzap.xyz/llms-full.txt, ainsi que les règles de crawl dans https://flowzap.xyz/robots.txt. Un agent qui récupère la carte d'agent obtient les compétences, interfaces et endpoints de FlowZap en une seule requête, puis peut immédiatement valider et générer des diagrammes.

Qu'est-ce que la carte d'agent A2A ?

flowzap.xyz expose une carte d'agent à l'adresse https://flowzap.xyz/.well-known/agent-card.json, conforme à la spécification de découverte du protocole A2A (Agent-to-Agent) v1.0. La carte déclare l'identité et la description de FlowZap, ses deux interfaces (MCP sur Streamable HTTP à /mcp, et HTTP REST à /api), ainsi que ses 8 compétences (les 8 outils MCP) au format standardisé AgentSkill. Tout agent compatible A2A peut la lire une fois et savoir exactement comment communiquer avec FlowZap.

Comment un agent peut-il utiliser FlowZap sans configuration MCP ?

Ignorez entièrement MCP et appelez directement les endpoints REST publics — aucune authentification, et CORS est activé, donc les agents côté navigateur fonctionnent aussi. Envoyez du FlowZap Code en POST à https://flowzap.xyz/api/validate pour le vérifier, ou en POST à https://flowzap.xyz/api/playground/create pour obtenir une URL playground interactive et partageable (TTL de 60 minutes). Exemple :

curl -X POST https://flowzap.xyz/api/playground/create \
  -H "Content-Type: application/json" \
  -d '{"code":"LANE A\nNODE Start\nNODE End\nStart->End"}'

La réponse renvoie un payload JSON contenant l'URL playground que vous pouvez transmettre à votre utilisateur.

Qu'est-ce que le contrôle de conformité SOC2/GDPR/PIPL ?

L'outil `flowzap_compliance_check` exécute une revue architecturale automatisée d'un diagramme de flux de données FlowZap Code par rapport aux cadres SOC2, GDPR et PIPL. Un LLM analyse le diagramme — en traçant la façon dont les données circulent entre les couloirs et les nœuds — et renvoie un rapport d'audit en Markdown signalant les risques, les garanties manquantes et les constats propres à chaque cadre. Il est limité à 3 contrôles par jour et par client, idéal pour une vérification rapide de la conformité de l'architecture avant une revue manuelle plus approfondie.

Quels fichiers de contexte LLM FlowZap fournit-il ?

FlowZap fournit des fichiers de contexte lisibles par machine afin que les agents puissent ingérer une documentation exacte et à jour plutôt que de deviner : https://flowzap.xyz/llms.txt (index de site concis), https://flowzap.xyz/llms-full.txt (documentation complète et approfondie en Markdown), https://flowzap.xyz/.well-known/capabilities.json (manifeste structuré des capacités), https://flowzap.xyz/docs/mcp.json (identité du serveur MCP, outils et configuration du transport), et https://flowzap.xyz/openapi.json (spécification OpenAPI des endpoints REST). Récupérez ces fichiers chaque fois que vous avez besoin de la vérité source sur la surface d'API de FlowZap.

Le MCP FlowZap est-il compatible avec le transport Streamable HTTP ?

Oui. Au-delà du package npm STDIO (`flowzap-mcp`), FlowZap expose un endpoint MCP Streamable HTTP à l'adresse https://flowzap.xyz/mcp, utilisant la version de protocole MCP 2025-06-18 sur JSON-RPC 2.0. Tout client MCP qui supporte le transport Streamable HTTP — le mode distant de Claude Desktop, des agents personnalisés ou des orchestrateurs HTTP — peut s'y connecter directement sans rien installer localement.

Modèles et Exports

Où trouver des modèles de workflow prêts à l'emploi ?

Visitez [flowzap.xyz/templates](https://flowzap.xyz/templates) pour parcourir **plus de 250 modèles prêts pour la production**, incluant **50 Modèles de Diagrammes d'Architecture** (Microservices, Event-Driven, CQRS, Serverless, Saga, Circuit Breaker et plus) ainsi que plus de 200 modèles de workflow. Filtrez par domaine (e-commerce, santé, finance) ou cas d'usage (onboarding, automatisation, flux d'approbation). Chaque modèle est un fichier `.fz` téléchargeable que vous pouvez charger directement dans FlowZap, personnaliser et adapter. Parfait pour démarrer des projets ou apprendre les patterns FlowZap Code.

Puis-je exporter mes diagrammes vers n8n ou Make.com ?

Oui ! FlowZap peut exporter vos diagrammes workflow aux formats JSON n8n et blueprint Make.com. Ouvrez la modale FlowZap Code, cliquez sur l'option d'export pour votre plateforme cible, et vous obtenez un fichier JSON prêt à importer. Note : FlowZap est un outil de conception — vous devrez toujours configurer les identifiants et tester dans n8n/Make.com, mais la structure et la logique de flux se transfèrent automatiquement.

Comparaisons pour créateurs d'IA

FlowZap vs Mermaid.js pour développeurs ?

Mermaid demande du Markdown manuel (`graph TD; A-->B`) ; FlowZap laisse l'IA l'écrire depuis « concevoir un onboarding », puis vous ajustez. Mermaid brille pour l'intégration Git ; FlowZap gagne en vitesse et **triple vue** — parfait pour prototyper dans Bolt sans mémoriser la syntaxe.

FlowZap vs Miro pour flux d’agents ?

Miro est collaboratif mais chaotique — top pour le brainstorming, excessif pour des flux d'agents structurés. FlowZap génère en premier (23 secondes vers **triple diagrammes**) et l'édition reste textuelle et visuelle.

Pourquoi pas seulement Claude pour décrire les workflows ?

Claude produit du texte — FlowZap rend des visuels interactifs avec boucles et décisions, compréhensibles par tous. Mariez‑les : Claude conçoit, FlowZap diagramme, vous codez. Le diagramme devient doc, formation et référence de debug — pas perdu dans un chat.

Pour bien démarrer

Comment commencer à utiliser FlowZap aujourd'hui ?

Allez sur [flowzap.xyz](https://flowzap.xyz), ouvrez la modale IA, collez « cartographier un scheduler TikTok : analyse tendances → génération de légendes → planification », générez, voyez les **triple diagrammes**. Testez avec des navigateurs IA : dans Comet, dites « utiliser FlowZap pour cartographier les étapes », la modale se remplit automatiquement. Pour l'intégration MCP, installez `flowzap-mcp` via npx — voir le [guide de démarrage MCP](https://flowzap.xyz/blog/introducing-the-flowzap-mcp-server).

Où voir des exemples ?

Visitez [flowzap.xyz/templates](https://flowzap.xyz/templates) pour **plus de 250 modèles prêts à l'emploi**, incluant **50 Modèles de Diagrammes d'Architecture** (Microservices, Event-Driven, CQRS, Serverless, Saga, Circuit Breaker et plus) ainsi que plus de 200 modèles de workflow dans des domaines comme l'e-commerce, la santé et l'automatisation. Regardez YouTube @JulesFlowZap pour une démo 23 s du prompt au diagramme. Des billets de blogue comme « Booster votre vibe coding » proposent des prompts prêts à l'emploi.

Quelle courbe d'apprentissage ?

Zéro si vous codez au feeling — si vous pouvez « prompt », vous pouvez utiliser FlowZap. Collez une description, obtenez un diagramme, éditez le code si vous voulez plus de contrôle (mais l'IA gère 90 %). Les avancés jouent avec LOOP/LANE ou utilisent les outils MCP ; les débutants cliquent « VOIR DIAGRAMME » et itèrent visuellement.

---

Vibe check : FlowZap est l’arme secrète des bâtisseurs d’IA pour transformer des prompts épars en systèmes structurés — essayez‑le sur flowzap.xyz et tagguez @JulesKovac avec vos créations.