# Brancher un agent

> Brancher Claude Code, Cursor ou Claude Desktop sur Fransys par le MCP, avec une clé d'agent en lecture seule.

Source : https://docs.fransys.cloud/agents/brancher-un-agent/ Vérifié sur la console le 2026-10-23.

## Ce que votre agent pourra faire

Branché sur Fransys, votre agent lit vos projets, services, réglages, clusters, journaux et mesures, et prépare des plans. Chaque plan attend qu'une personne de l'équipe le valide dans **Plans** : l'agent n'exécute rien lui-même. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/).

## Les étapes

Tout se passe dans la page **Brancher** de la console.

1. **Vérifier le serveur MCP**

   En haut de la page, **Le serveur MCP répond.** confirme que tout est prêt, avec le nombre d'outils disponibles et l'adresse du serveur.

2. **Créer une clé d'agent**

   Donnez-lui un nom (par exemple « Claude Code – Kevin ») et choisissez ce qu'elle permet de lire. Cochez **Lire aussi la facturation** si l'agent doit voir vos coûts. Cliquez sur **Créer la clé**.

   Le secret ne s'affiche qu'une fois : copiez-le maintenant. Il est aussi déjà dans les commandes de l'étape suivante. La clé devient active 10 à 15 secondes après sa création.

3. **Ajouter Fransys à votre agent**

   Copiez la commande ou la configuration de votre outil depuis la page : l'adresse du serveur et votre clé y sont déjà.

   **Claude Code**

   Dans votre terminal, à la racine du projet :

   ```sh
   claude mcp add --transport http fransys <adresse du serveur> --header "Authorization: Bearer <votre clé>"
   ```

   Vérifiez ensuite avec `claude mcp list` : « fransys » doit apparaître comme connecté.

   **Cursor**

   Dans `.cursor/mcp.json` à la racine du projet, ou dans `~/.cursor/mcp.json` pour tous vos projets :

   ```json
   {
     "mcpServers": {
       "fransys": {
         "url": "<adresse du serveur>",
         "headers": { "Authorization": "Bearer <votre clé>" }
       }
     }
   }
   ```

   Rouvrez les réglages MCP de Cursor : « fransys » doit afficher ses outils.

   **Claude Desktop**

   Dans Claude Desktop, ouvrez **Réglages › Développeur › Modifier la configuration**, puis ajoutez le serveur dans `claude_desktop_config.json` :

   ```json
   {
     "mcpServers": {
       "fransys": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "<adresse du serveur>", "--header", "Authorization:${AUTH_HEADER}"],
         "env": { "AUTH_HEADER": "Bearer <votre clé>" }
       }
     }
   }
   ```

   Redémarrez Claude Desktop. Le pont `mcp-remote` est lancé par `npx` : il faut Node.js sur la machine.

   Puis cliquez sur **J'ai copié, masquer le secret**.

4. **Essayer**

   Demandez-lui par exemple :
   - « Fais le tour de mes projets et dis-moi quels services sont désactivés. »
   - « Lis les logs de mon API de la dernière heure et explique-moi les erreurs. »
   - « Ajoute un Redis à mon projet et prépare le plan. »

   Quand l'agent prépare un plan, il arrive dans **Plans**, à valider ou refuser.

## Une clé par agent

Créez une clé par agent ou par personne. La page liste les clés de l'organisation : qui l'a créée, quand elle a servi pour la dernière fois. Le journal dit quelle clé a fait quoi.

**Retirer la clé** coupe l'accès de l'agent tout de suite. Les plans qu'il a préparés restent dans **Plans**.

Ne partagez pas une clé : elle donne accès à vos données en lecture. Si vous avez perdu un secret, créez une nouvelle clé et retirez l'ancienne.

## Ce que les agents ont fait

En bas de la page **Brancher**, **Derniers gestes des agents** liste les plans préparés, modifiés ou annulés et les outils utilisés. **Tout le journal** ouvre la page **Journal**.