Connecter Hermes Agent à Finaxis
Hermes Agent, l'agent IA open source de Nous Research, se branche sur Finaxis par son serveur MCP. Il lit vos clients, vos factures, vos paiements et l'âge de vos comptes, prépare des dossiers clients et des plans, et peut répartir le travail entre des sous-agents, jamais au-delà des droits de l'accès que vous lui donnez.
Avant de commencer
- Hermes Agent installé, avec un modèle connecté. Ces étapes ont été testées avec Hermes Agent 0.23.
- Pour choisir entre votre propre accès et un compte de service, lisez Choisir comment un agent IA se connecte à Finaxis.
Se brancher avec votre propre accès
- Dans un terminal, ajoutez le serveur MCP de Finaxis à Hermes avec OAuth. Donnez-lui cinq minutes pour se connecter : Hermes attend pendant que vous approuvez la connexion, et il abandonne après 30 secondes par défaut.
hermes mcp add finaxis --url https://api.finaxis.ai/mcp --auth oauth --connect-timeout 300
- Ouvrez l'adresse que Hermes affiche. Si Hermes tourne sur une autre machine que votre navigateur, suivez ses instructions pour coller l'adresse où votre navigateur aboutit.
- Si Finaxis vous demande de vous connecter, connectez-vous comme d'habitude. Une page nommée Connecter Hermes Agent à Finaxis s'ouvre.
- Sous Portail, choisissez l'instance où l'agent travaillera. Une connexion ne fonctionne que sur une instance.
- Sous Ce qu'elle pourra faire, décochez les portées que l'agent ne doit pas avoir, par exemple toutes les écritures pour commencer. L'agent ne dépasse jamais vos droits, quoi que vous cochiez.
- Cliquez sur Connecter, puis revenez à votre terminal.
- Hermes liste les outils de Finaxis qu'il a trouvés (huit avec les seules portées de lecture) et demande s'il doit les activer. Répondez Y.
- Testez la connexion.
hermes mcp test finaxis
Posez ensuite une question à Hermes, dans une discussion ou en une commande :
hermes chat -q "Quels clients sont les plus en retard dans Finaxis, et de combien?"
À noter : Hermes peut confier des parties d'une tâche à des sous-agents qui travaillent en parallèle, par exemple un dossier client par sous-agent. Chaque sous-agent passe par la même connexion à Finaxis, dans les mêmes portées.
Prendre un compte de service pour les tâches planifiées
Pour une tâche qui tourne seule, comme un bulletin des payeurs chaque semaine, prenez un compte de service. Son jeton dure une heure et Hermes le lit au démarrage : une commande de secrets lui en fournit donc un nouveau chaque fois.
- Créez un compte de service avec les portées dont la tâche a besoin, puis enregistrez son identifiant client et son secret dans un fichier que vous seul pouvez lire.
# ~/.config/finaxis/service-account.env (lisible par vous seul : chmod 600)
FINAXIS_CLIENT_ID=fxc_...
FINAXIS_CLIENT_SECRET=fxs_...
- Créez le script qui renvoie le jeton sous la forme que Hermes attend, puis rendez-le exécutable avec chmod 700.
#!/bin/sh
# Renvoie FINAXIS_TOKEN=<jeton> à Hermes, qui lance ce script à chaque démarrage.
. "$HOME/.config/finaxis/service-account.env"
token=$(curl -sf -u "$FINAXIS_CLIENT_ID:$FINAXIS_CLIENT_SECRET" \
-d grant_type=client_credentials https://api.finaxis.ai/v1/oauth/token \
| python3 -c 'import sys, json; print(json.load(sys.stdin)["access_token"])')
echo "FINAXIS_TOKEN=$token"
- Déclarez le serveur et la commande de secrets dans ~/.hermes/config.yaml.
# ~/.hermes/config.yaml
mcp_servers:
finaxis_sa:
url: https://api.finaxis.ai/mcp
headers:
Authorization: "Bearer ${FINAXIS_TOKEN}"
secrets:
command:
enabled: true
command: "/home/utilisateur/.hermes/finaxis-token.sh"
helper_timeout_seconds: 10
override_existing: true
- Lancez hermes mcp test finaxis_sa : il doit trouver les outils des portées choisies.
À noter : Si FINAXIS_TOKEN manque, Hermes ignore le serveur et continue avec les autres, sans erreur. Hermes ne lit la variable que dans son propre fichier .env ou dans sa source de secrets, pas dans votre terminal. Vérifiez le serveur avec hermes mcp test avant de planifier une tâche.
Une session Hermes de plus d'une heure garde son premier jeton : démarrez une nouvelle session pour chaque exécution planifiée.
Dépannage
| Situation | Que faire |
|---|---|
| Hermes dit que la connexion a expiré | Ajoutez --connect-timeout 300 : les 30 secondes par défaut ne suffisent pas pour approuver la connexion. |
| Hermes répond avec votre propre accès au lieu du compte de service | Le serveur du compte de service n'a pas démarré, souvent parce que FINAXIS_TOKEN manque. Lancez hermes mcp test finaxis_sa. |
| Un outil attendu manque | Les portées approuvées ne l'incluent pas. Modifiez la connexion dans Finaxis, ou rebranchez-vous en cochant la portée. |
| Le script du jeton renvoie une erreur | Le secret a expiré ou a été remplacé : faites-en la rotation et mettez le fichier à jour. |
Besoin d'aide pour brancher votre agent? Écrivez à support@finaxis.ai avec l'identifiant de requête du journal des requêtes, et notre équipe vous aidera.
Articles liés
Vous ne trouvez pas ce que vous cherchez?
Notre équipe de soutien est là pour vous aider.