Connecter Hermes Agent à Finaxis

Mis à jour le S'applique à : Tous les forfaits
Read in English

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

Se brancher avec votre propre accès

  1. 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.
Terminal
hermes mcp add finaxis --url https://api.finaxis.ai/mcp --auth oauth --connect-timeout 300
  1. 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.
  1. Si Finaxis vous demande de vous connecter, connectez-vous comme d'habitude. Une page nommée Connecter Hermes Agent à Finaxis s'ouvre.
  2. Sous Portail, choisissez l'instance où l'agent travaillera. Une connexion ne fonctionne que sur une instance.
  3. 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.
  4. Cliquez sur Connecter, puis revenez à votre terminal.
La page Finaxis Connecter Hermes Agent à Finaxis, avec le portail AgentKB choisi et la liste des portées, l'identité publiée par nousresearch.github.io, et l'avertissement que l'application tourne sur votre ordinateur.
  1. 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.
  2. Testez la connexion.
Terminal
hermes mcp test finaxis

Posez ensuite une question à Hermes, dans une discussion ou en une commande :

Terminal
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.

  1. 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.
service-account.env
# ~/.config/finaxis/service-account.env (lisible par vous seul : chmod 600)
FINAXIS_CLIENT_ID=fxc_...
FINAXIS_CLIENT_SECRET=fxs_...
  1. Créez le script qui renvoie le jeton sous la forme que Hermes attend, puis rendez-le exécutable avec chmod 700.
finaxis-token.sh
#!/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"
  1. Déclarez le serveur et la commande de secrets dans ~/.hermes/config.yaml.
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
  1. 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.