Connecter Claude Code à Finaxis

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

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

Se brancher avec votre propre accès

  1. Dans un terminal, ajoutez le serveur MCP de Finaxis à Claude Code.
Terminal
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.

  1. Lancez la connexion. Claude Code ouvre votre navigateur sur Finaxis.
Terminal
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.

  1. Si Finaxis vous demande de vous connecter, connectez-vous comme d'habitude. Une page nommée Connecter Claude Code à 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 Claude Code à Finaxis, avec le portail AgentKB choisi et la liste des portées, l'identité publiée par claude.ai, et l'avertissement que l'application tourne sur votre ordinateur.
  1. Vérifiez la connexion. Son statut indique Connected.
Terminal
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.

  1. Créez un compte de service avec les portées dont la tâche a besoin, puis copiez son identifiant client et son secret.
  2. Enregistrez-les 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 demande un nouveau jeton à Finaxis et le renvoie sous forme d'en-tête, puis rendez-le exécutable avec chmod 700.
finaxis-headers.sh
#!/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"
  1. Déclarez le serveur avec le script comme headersHelper, dans le fichier .mcp.json de votre dossier ou avec claude mcp add-json.
.mcp.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.