Fintusk MCP — Documentation

Démarrage rapide

Connecter Fintusk à Claude

Obtenir une clé API

Créez un compte sur app.fintusk.fr — une clé preview est générée automatiquement. Pour l'accès complet, souscrivez au plan Diagnostic (249€ HT) ou Copilote (399€ HT/mois). La clé est livrée par email immédiatement.

Ajouter le connecteur dans Claude

Dans Claude → Settings → Connectors → Add custom connector. Collez l'URL ci-dessous avec votre clé :

URL du connecteur

https://hxktqzpkupvlfyzifjfd.supabase.co/functions/v1/mcp-server?key=ft_VOTRE_CLE_API

Utiliser dans une conversation

Claude découvre automatiquement les outils. Demandez simplement :

Exemples de prompts

"Analyse ce FEC et dis-moi si la trésorerie est en risque."
"Normalise ce fichier SAF-T espagnol en format Fintusk."
"Génère un diagnostic complet pour ce FEC, secteur BTP."

Sans clé API, le connecteur retourne un preview gratuit — score global et signal dominant — avec un lien pour débloquer l'analyse complète.

Référence

Les 4 outils MCP

upload_file écriture

Génère une URL de pré-upload sécurisée (Supabase Storage, expiration 15 min) pour envoyer un fichier comptable. Appelez cet outil en premier.

filenamerequisNom du fichier (ex: FEC_2023_MartinSARL.txt)

mime_typeoptionnelType MIME — défaut : text/plain

normalize_accounting lecture seule

Normalise un fichier comptable source en JSON GFS standardisé. Détection automatique du format si non spécifié.

file_urlrequisURL issue de upload_file

country_coderequisISO 3166-1 alpha-2 (FR, ES, SN, MA...)

source_formatoptionnelfec · saft · ohada · csv · auto

fiscal_idoptionnelSIRET ou identifiant fiscal local

company_nameoptionnelNom de l'entreprise

fiscal_yearoptionnelExercice fiscal — défaut : 2023

generate_diagnosis lecture seule

Génère un diagnostic financier expert : score de santé Fintusk (0–100), EBITDA réel, cash-flow opérationnel, alertes de risque classées par criticité, benchmark sectoriel.

gfs_jsonrequisJSON normalisé issu de normalize_accounting

sectoroptionnelindustrie · btp · commerce · services · restauration · generique

report_langoptionnelfr · en · es · ar — défaut : fr

job_idoptionneljob_id issu de normalize_accounting

get_report lecture seule

Récupère un rapport finalisé par son job_id. Retourne le lien vers le dashboard Fintusk et le PDF exportable.

job_idrequisIdentifiant du rapport (format job_xxxxxxxx)

Authentification

Clé API Fintusk

La clé API s'ajoute en paramètre ?key= dans l'URL du connecteur. Elle est générée automatiquement à l'inscription et livrée par email après paiement.

Format de la clé

ft_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Plans et accès

Plan	Accès	Prix
Preview	Score global + 1 signal · sans paiement	Gratuit
Diagnostic	Analyse complète · 1 crédit	249€ HT one-shot
Copilote	Illimité · multi-pays · mode cabinet	399€ HT/mois

Référence

Codes d'erreur

Code	HTTP	Description
MISSING_KEY	401	Aucune clé API fournie dans l'URL ou le header
INVALID_KEY	402	Clé non reconnue ou inactive
EXPIRED	402	Clé expirée — renouvelez votre plan
NO_CREDITS	402	Plus de crédits disponibles sur ce compte
PREVIEW	200	Accès preview — résultat partiel retourné
OK	200	Analyse complète — accès autorisé

Toutes les réponses d'erreur 402 incluent un champ preview avec le score partiel et un champ cta.url pointant vers la page tarifaire.

Exemple réponse 402

{
  "error": "PAYMENT_REQUIRED",
  "code": "NO_CREDITS",
  "job_id": "job_a1b2c3d4",
  "preview": {
    "health_score": 67,
    "alerts_count": 4,
    "top_signal": "Tension de trésorerie détectée en Q3"
  },
  "cta": {
    "message": "Débloquez l'analyse complète — 4 alertes détaillées, EBITDA, cash-flow.",
    "url": "https://fintusk.fr/tarifs?ref=mcp&job=job_a1b2c3d4"
  },
  "disclaimer": "⚠️ Cette analyse est une aide à la décision."
}

Couverture

Pays et formats supportés

Formats d'entrée

FEC — Fichier des Écritures Comptables (France, obligation légale DGFiP)
SAF-T — Standard Audit File for Tax (27 pays UE)
OHADA — SYSCOHADA (zone UEMOA + Maghreb)
CSV — Format délimité local avec détection automatique des colonnes

Devises

EUR · XOF/XAF (CFA) · MAD (Dirham) · DZD (Dinar algérien) · TND (Dinar tunisien)

Pays couverts

FR France

ES Espagne

IT Italie

DE Allemagne

PT Portugal

BE Belgique

NL Pays-Bas

PL Pologne

SN Sénégal

CI Côte d'Ivoire

CM Cameroun

MA Maroc

DZ Algérie

TN Tunisie

+13 autres pays UE

Disclaimer légal

Chaque réponse de l'API inclut un champ disclaimer : "Cette analyse est une aide à la décision et ne remplace pas l'avis d'un expert-comptable ou d'un commissaire aux comptes." Ce champ doit être affiché à l'utilisateur final.

Support