> ## Documentation Index
> Fetch the complete documentation index at: https://help.firby.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecter un assistant IA (MCP)

> Brancher Claude ou ChatGPT sur votre espace Firby pour interroger vos factures et saisir des dépenses en langage naturel.

Votre espace Firby est aussi accessible via le protocole **MCP** (Model Context
Protocol) : chaque endpoint de l’[API](/api/vue-ensemble) 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](/api/vue-ensemble)), 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 :
   ```
   https://app.firby.fr/api/mcp?key=VOTRE_CLÉ
   ```
   en remplaçant `VOTRE_CLÉ` par votre clé API.
3. Laissez les champs OAuth vides et validez.

<Warning>
  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.
</Warning>

## ChatGPT

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

## Claude Code

Dans un terminal :

```bash theme={null}
claude mcp add firby --transport http https://app.firby.fr/api/mcp \
  --header "x-api-key: VOTRE_CLÉ"
```

## Ce que l’assistant peut faire

Une fois connecté, l’assistant dispose de 13 outils, en phase avec l’API :

* **consulter** vos factures (avec le détail des lignes), logements, propriétaires,
  réservations et dépenses ;
* **créer** une dépense exceptionnelle ou un propriétaire ;
* **modifier** un logement (nom, rattachement) ou un propriétaire ;
* **supprimer** un propriétaire (l’assistant vous demandera confirmation — l’action
  est signalée comme destructive).

<Note>
  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`.
</Note>