Connecter Claude Code à Finaxis
Claude Code, l'agent IA qui travaille dans votre terminal, se branche sur Finaxis par son serveur MCP. Une fois branché, il lit vos clients, vos factures, vos paiements et l'âge de vos comptes, puis répond à vos questions ou prépare votre travail, jamais au-delà des droits de l'accès que vous lui donnez.
Avant de commencer
- Claude Code installé sur votre ordinateur.
- 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 à Claude Code.
claude mcp add --transport http finaxis https://api.finaxis.ai/mcp
Le serveur est ajouté pour le dossier courant. Ajoutez --scope user pour l'avoir dans tous vos projets.
- Lancez la connexion. Claude Code ouvre votre navigateur sur Finaxis.
claude mcp login finaxis
Sur une machine sans navigateur, ajoutez --no-browser : Claude Code affiche l'adresse à ouvrir, puis vous demande de coller l'adresse où votre navigateur aboutit. La commande demande un terminal interactif.
- Si Finaxis vous demande de vous connecter, connectez-vous comme d'habitude. Une page nommée Connecter Claude Code à 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.
- Vérifiez la connexion. Son statut indique Connected.
claude mcp get finaxis
Posez une question sur vos comptes à recevoir à Claude Code, par exemple : Quels clients sont les plus en retard dans Finaxis, et de combien? Avec les seules portées de lecture, Claude Code voit les huit outils de lecture de Finaxis.
À noter : Dans Finaxis, la connexion s'affiche sous le nom Claude Code dans Applications connectées, avec son accès et sa dernière utilisation. Voyez Choisir comment un agent IA se connecte à Finaxis pour la suivre ou la révoquer.
Se brancher avec un compte de service
Pour une tâche qui tourne sans vous, comme un script lancé chaque matin avec claude -p, prenez un compte de service. Son jeton dure une heure : Claude Code en demande un nouveau chaque fois qu'il se connecte, par un petit script.
- Créez un compte de service avec les portées dont la tâche a besoin, puis copiez son identifiant client et son secret.
- Enregistrez-les 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 demande un nouveau jeton à Finaxis et le renvoie sous forme d'en-tête, puis rendez-le exécutable avec chmod 700.
#!/usr/bin/env bash
# Demande un jeton à Finaxis et le renvoie en en-tête Authorization.
# Le jeton dure une heure : l'agent lance ce script chaque fois qu'il se connecte.
set -euo pipefail
. "$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"])')
printf '{"Authorization": "Bearer %s"}\n' "$token"
- Déclarez le serveur avec le script comme headersHelper, dans le fichier .mcp.json de votre dossier ou avec claude mcp add-json.
{
"mcpServers": {
"finaxis": {
"type": "http",
"url": "https://api.finaxis.ai/mcp",
"headersHelper": "/home/utilisateur/.config/finaxis/finaxis-headers.sh"
}
}
}
Les appels faits ainsi portent le nom du compte de service dans le journal des requêtes. Ne versionnez jamais le fichier qui contient le secret.
Dépannage
| Situation | Que faire |
|---|---|
| claude mcp get affiche Needs authentication | Lancez claude mcp login finaxis et approuvez la connexion dans Finaxis. |
| claude -p ne peut pas se connecter | Une exécution non interactive ne peut pas approuver une connexion. Connectez-vous une fois dans un terminal interactif, ou prenez un compte de service. |
| La page dit que l'application n'est pas enregistrée | Vérifiez que vous avez ajouté l'adresse exacte https://api.finaxis.ai/mcp. |
| 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 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.