Skip to main content
Votre espace Firby est aussi accessible via le protocole MCP (Model Context Protocol) : chaque endpoint de l’API devient un outil utilisable par Claude ou ChatGPT. Vous pouvez alors demander « liste mes factures de juin en erreur » ou « crée une dépense de 45 € sur le studio Vieux-Port » — l’assistant interroge vos données et agit pour vous. L’authentification utilise vos clés API : mêmes permissions, même limite de débit que l’API. Créez d’abord une clé sur Réglages → API (voir L’API Firby), puis suivez le pas-à-pas de votre assistant — il est aussi affiché dans l’application, sur la carte Connecter un assistant IA de la page Clés API.

​
Claude (claude.ai et Claude Desktop)

  1. Ouvrez Paramètres → Connecteurs → Ajouter un connecteur personnalisé.
  2. Nommez-le Firby et collez l’URL :
    en remplaçant VOTRE_CLÉ par votre clé API.
  3. Laissez les champs OAuth vides et validez.
Votre clé API figure dans l’URL du connecteur : traitez cette URL comme un mot de passe. Ne la partagez pas, et révoquez la clé depuis Firby si elle fuite.

​
ChatGPT

  1. Ouvrez Réglages → Connecteurs → Paramètres avancés et activez le Mode développeur.
  2. Créez un connecteur avec l’URL :
  3. Authentification : choisissez Clé API et collez votre clé.

​
Claude Code

Dans un terminal :

​
Ce que l’assistant peut faire

Une fois connecté, l’assistant dispose de 23 outils, en phase avec l’API :
  • consulter vos factures (avec le détail des lignes), logements, propriétaires, réservations, dépenses, règles de facturation et tags ;
  • créer une dépense exceptionnelle ou un propriétaire ;
  • modifier un logement (nom, rattachement, tags), un propriétaire, une dépense ou un tag (nom, couleur, rôle, forfaits) ;
  • régler la règle de facturation et les tags posés d’office sur les nouveaux logements ;
  • supprimer une dépense ou un propriétaire (l’assistant vous demandera confirmation — l’action est signalée comme destructive).
L’assistant se connecte depuis le cloud de son éditeur (Anthropic, OpenAI) : votre instance Firby doit être accessible depuis Internet. C’est le cas de app.firby.fr.