Plugin d’agent

Bêta publique. Tout ce que décrit cette page fonctionne aujourd’hui et son usage est gratuit. Les noms d’outils, le contenu des skills et la surface de la CLI peuvent encore changer d’une version à l’autre — nous les versionnons et annonçons chaque changement dans le journal des modifications, mais n’attachez pas encore un flux de production à un nom d’outil précis. Voir Ce que bêta veut dire.

Donnez à votre agent de code les outils Flowie Exchange, le savoir-faire pour s’en servir correctement, et un compte qu’il peut ouvrir seul. Trois surfaces, une seule installation :

Les outils et les skills sont faits pour être installés ensemble. Un serveur MCP seul oblige votre agent à redécouvrir chaque piège de la facturation électronique transfrontalière ; les skills, c’est là que nous les avons écrits.

Démarrage rapide

Choisissez votre agent. Toutes les commandes ci-dessous pointent vers le bac à sable — aucune clé, aucune inscription, et rien de ce que vous lancez ne peut atteindre une administration fiscale.

Claude Code

claude mcp add flowie-exchange https://back.flowie.ink/exchange/mcp

Cursor, VS Code, Codex & tout client qui parle MCP

Ajoutez le serveur à la configuration MCP de votre client :

{
  "mcpServers": {
    "flowie-exchange": {
      "url": "https://back.flowie.ink/exchange/mcp"
    }
  }
}

Obtenir une clé sans quitter l’agent

Votre agent peut ouvrir son propre compte bac à sable — sans humain, sans formulaire :

curl -X POST https://back.flowie.ink/exchange/v1/sandbox/bootstrap \
  -H 'Content-Type: application/json' -d '{}'

Cela renvoie une clé flw_test_…, une organisation et une entreprise. Envoyez-la en Authorization: Bearer <key> sur tous les appels suivants. Pour la production, ou pour agir sur le compte réel d’un utilisateur, lisez Onboarding d’agent.

Serveur MCP

Deux endpoints, la même authentification :

L’authentification est un jeton bearer sur chaque appel — un JWT utilisateur ou une clé d’API flw_* — et l’organisation du jeton délimite toutes les lectures et écritures. Aucun mouvement d’argent : les champs de paiement sont des métadonnées de facture, rien de plus.

Le serveur se décrit lui-même sur /.well-known/mcp/server-card.json, et nomme son serveur d’autorisation sur /.well-known/oauth-authorization-server. Un agent qui suit la chaîne de découverte trouve les deux sans qu’on les lui donne. Catalogue complet des outils et scénarios détaillés : référence du serveur MCP.

Skills d’agent

Un skill est un fichier Markdown qui apprend à un agent comment faire une chose précise avec cette API — quel endpoint répond, ce que les champs veulent dire, et l’erreur qui ressemble à un succès. Ils n’exécutent rien, ne coûtent donc rien à l’exécution, et ce sont eux qui empêchent un agent d’inventer un champ que l’API n’a pas.

Le catalogue est découvrable et adressé par contenu :

curl https://docs.get-flowie.com/.well-known/agent-skills/index.json

Chaque entrée porte une url et une empreinte sha256, de sorte qu’un client peut mettre un skill en cache et savoir quand il a changé. Quatorze sont publiés aujourd’hui :

La plupart des clients MCP chargent les skills depuis l’index dès que le serveur est connecté. Si le vôtre ne le fait pas, pointez-le sur le fichier brut — par exemple https://docs.get-flowie.com/skills/send-invoice/SKILL.md.

CLI

Bêta privée. La CLI n’est pas encore publiée. Écrivez-nous à [email protected] et nous vous ajoutons.

La CLI couvre le même terrain depuis un terminal, pour les cas où un modèle dans la boucle est un risque plutôt qu’une aide — un job de CI, une procédure, une migration que vous devez pouvoir rejouer et comparer. Elle lance aussi un serveur MCP en local sur stdio, si vous préférez que votre agent parle à un processus que vous avez démarré plutôt qu’à un endpoint que nous hébergeons.

Nous documenterons ici l’installation et les commandes quand elle sortira de bêta privée. D’ici là, le serveur MCP hébergé ci-dessus est le chemin supporté, et tout ce qu’un agent peut y faire reste accessible en HTTP simple : voir la référence de l’API.

Vérifier que ça marche

Une seule requête valide toute la chaîne — transport, découverte et liste des outils :

curl -X POST https://back.flowie.ink/exchange/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2024-11-05","capabilities":{},
        "clientInfo":{"name":"my-agent","version":"0"}}}'

Un result portant serverInfo.name: "flowie-exchange" signifie que vous êtes connecté. Un 404 signifie que vous avez atteint un déploiement plus ancien — dites-le nous, car c’est un bug de notre côté, pas un problème de configuration du vôtre.

Ce que bêta veut dire

Concrètement, pour que vous puissiez décider sur quoi bâtir :

• Assez stable pour bâtir dessus : les endpoints, le modèle d’authentification, le bootstrap bac à sable, et l’URL de l’index des skills. Ils sont couverts par notre politique de dépréciation comme le reste de l’API.
• Encore mouvant : les noms et arguments d’outils pris un par un, la composition de l’ensemble sélectionné, et le contenu des skills. Un outil renommé casse un prompt et non un compilateur : nous annonçons donc chaque changement dans le journal des modifications — lisez-le avant de figer quoi que ce soit.
• Pas encore couvert : la CLI, en bêta privée, qui ne porte aucune promesse de compatibilité.
• Les changements incompatibles de l’API sous-jacente ne sortent toujours que dans une nouvelle version majeure, sous un nouveau préfixe d’URL. La bêta n’y change rien.

Vous construisez quelque chose là-dessus ? Dites-le nous — pendant la bêta, c’est le moyen le plus rapide de faire renommer un outil, corriger un skill ou ajouter une capacité manquante.