Welcome to FlowZap dear Business Process Maniacs!

Présentation du serveur MCP FlowZap : la voie la plus rapide entre un agent LLM et des diagrammes interactifs

07/09/2025

Tags: MCP, Agents, JSON-RPC, API, Claude, Perplexity, Connecteurs

Jules Kovac

Jules Kovac

Business Analyst, Founder

Présentation du serveur MCP FlowZap : la voie la plus rapide entre un agent LLM et des diagrammes interactifs

Je viens de lancer un serveur MCP (Model Context Protocol) public et robuste sur https://flowzap.xyz/api/mcp. Désormais, n’importe quel agent — Claude, ChatGPT (fonctions personnalisées), DeepSeek, Qwen, Grok, etc. — peut générer, mettre à jour et transmettre des diagrammes de processus métier via une API JSON‑RPC 2.0 ultra simple sur HTTP. C’est sécurisé, rapide et universel.

Pourquoi construire un MCP distant pour FlowZap ?

La cartographie de processus est collaborative, itérative et (avouons‑le) souvent fastidieuse. FlowZap permet déjà de créer, d’ajuster et de collaborer sur des flux avec une UI moderne et un DSL orienté code. Mais avec la montée des agents LLM dans l’automatisation, la friction d’intégration devenait un goulot d’étranglement — pour nous et pour toutes les équipes qui veulent connecter leur agent à un véritable backend de diagrammes.

Nous voulions résoudre ça pour tout le monde, pas seulement pour notre stack. Pas de verrouillage propriétaire, pas de « attendez notre plugin ». Juste : si votre agent parle JSON‑RPC sur HTTP, il parle FlowZap — point.

Ajouter FlowZap à Claude

Claude gère les « Custom Connectors » via MCP distant pour les offres Pro, Max, Team et Enterprise. Note : en septembre 2025, certains utilisateurs rencontrent des problèmes d’OAuth avec Claude Desktop. Si la connexion ne persiste pas après avoir cliqué sur « Connect », il s’agit d’un problème connu côté Claude Desktop. Nous suivons les mises à jour d’Anthropic.

  • Ouvrez Claude → Settings → Connectors → Add custom connector, collez l’URL de base du MCP FlowZap https://flowzap.xyz/api/mcp/sse (transport SSE), puis cliquez sur Add.
  • Laissez vides « OAuth Client ID » et « OAuth Client Secret » sauf si vous êtes sur un plan Claude for Work disposant d’un client provisionné.
  • Après l’ajout, activez les outils du connecteur pour la conversation ; Claude pourra les invoquer en chat et en mode Research lorsque vous l’y autorisez.
  • Les « custom connectors » sont des serveurs MCP distants : aucune installation locale n’est requise ; le modèle appelle en toute sécurité les outils JSON‑RPC de FlowZap via HTTPS.
  • Anthropic recommande d’activer uniquement les outils nécessaires, de revoir les demandes d’appel d’outils, et d’utiliser des serveurs de confiance — des bonnes pratiques que FlowZap MCP applique par conception.
  • Pour vos évolutions, Claude prend aussi en charge les workflows développeurs autour des MCP distants, afin que les équipes itèrent sans changer la configuration côté utilisateur.

Astuce : concentrez le parcours utilisateur sur « URL + FlowZap Code » : les utilisateurs obtiennent un bon aperçu, puis se rendent sur FlowZap pour s’inscrire et sauvegarder — ce qui alimente le tunnel de conversion présenté dans cet article.

Dépannage : connexion Claude Desktop

Si le connecteur affiche « Disconnected » après la configuration :

  1. Il s’agit d’un problème connu lié à la gestion OAuth de Claude Desktop.
  2. Votre navigateur peut brièvement afficher « success », mais la connexion ne persiste pas.
  3. Ce n’est pas un problème du serveur MCP FlowZap.
  4. Alternative : utilisez directement l’API avec d’autres clients LLM compatibles JSON‑RPC.

État Perplexity (ce qui marche aujourd’hui)

Perplexity indique clairement que les « connectors » MCP locaux sont disponibles sur l’app Mac aujourd’hui, et que le MCP distant (serveurs personnalisés hébergés) arrive bientôt, avec un déploiement prioritaire pour les abonnés payants — la prise en charge large des connecteurs personnalisés sur Windows/Web n’est donc pas encore générale.

  • Le MCP local sur Mac nécessite d’installer l’helper Perplexity (PerplexityXPC), puis d’ajouter le MCP dans Connectors ; cette voie est documentée et déjà en production pour macOS.
  • Pour les clients entreprise, Perplexity propose des « App/File Connectors » (ex. Google Drive, OneDrive, Box) en intégration managée ; ce sont des connecteurs first‑party, pas des serveurs arbitraires.
  • En attendant le MCP distant sur davantage de plateformes, les utilisateurs Windows/Web ne voient que la liste intégrée — conforme à ce que beaucoup observent dans l’UI actuelle.

L’API MCP FlowZap en bref

Exemple health check :

curl -s https://flowzap.xyz/api/mcp/health | jq
  • OpenAPI + Postman :
  • Expérience de session :
    Les liens Playground retournés sont toujours publics, propres, et expirent après 5 minutes pour les diagrammes non sauvegardés — vos flows restent frais, stateless et sécurisés.

Flots principaux (exemples prêts à copier/coller)

{{ ... }}

Aucun aperçu d’image. Aucun binaire. Vous recevez toujours une URL propre + le FlowZap Code — rien d’inutile, juste du flux de travail.

Astuce Dépannage (Desktop)

  • Si « Connect » ouvre une nouvelle conversation et ne touche pas votre URL :

    • Le problème vient souvent du client Desktop. Essayez dans Claude Web avec la même URL https://flowzap.xyz/api/mcp/sse ou utilisez l’API Messages avec mcp_servers.

  • En SSH/stdio, si un service HTTP écoute déjà le port 3001, lancez votre session stdio avec MCP_HTTP_PORT=0 pour éviter EADDRINUSE.

Authentification

  • OAuth 2.0 : le serveur MCP prend en charge OAuth 2.0 avec enregistrement dynamique de client.
  • Claude Desktop : le parcours OAuth est automatique (lorsqu’il fonctionne correctement).
  • Accès API direct : enregistrez‑vous via l’endpoint d’enregistrement, puis authentifiez‑vous pour obtenir les jetons.
  • Tests : une authentification simulée (mock) est disponible à des fins de test.

Conçu pour le contrôle et la croissance

  • Pour vous : orientez les utilisateurs vers vos apps, pas vers des bacs à sable sans fin. Sans sauvegarde par défaut, le tunnel de conversion reste actif.
  • Pour l’écosystème : bâtissons des ponts, pas des silos. Nous soutenons les agents ouverts, pas le gatekeeping.
  • Pour les partenaires : besoin d’un flux dédié, brandé, à fort volume ? Parlons‑en.

Conclusion

FlowZap MCP est votre voie rapide vers des diagrammes de workflow, avec un passage sans friction des LLMs vers une UI interactive et, au final, vers des utilisateurs payants en collaboration. Branchez‑le, testez‑le et dites‑nous ce que vous construisez.

Des questions ? Un retour ? Si vous connectez, testez ou déployez via /api/mcp, dites‑le moi !

FlowZap MCP : le pont ouvert et « agent‑friendly » vers des diagrammes métier réels. Construisez les workflows que vous voulez, comme vous voulez.

Retour à tous les articles du blogue