Brancher un agent

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.

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 :

   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 :

   {
     "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 :

   {
     "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.