Fuentio dans Claude Code : installer le serveur MCP pas à pas et vérifier ses premières entreprises

Claude Code peut appeler des outils externes grâce à MCP, le Model Context Protocol. Connectez Fuentio et il peut consulter, chercher et vérifier des entreprises françaises et espagnoles dans les registres officiels pendant qu’il travaille : contrôler une liste de fournisseurs que vous importez, écrire une intégration à partir de vraies réponses, ou répondre à « cette entreprise est-elle toujours active ? » sans quitter le terminal.

Ce tutoriel couvre l’installation en une commande, l’ajout d’une clé, le partage avec votre équipe sans exposer la clé, la vérification du bon fonctionnement, et quelques premières demandes avec les réponses obtenues.

Ce que vous allez apprendre

• Ajouter Fuentio à Claude Code, avec ou sans clé API
• Partager la configuration avec votre équipe en toute sécurité
• Vérifier que le serveur et ses outils sont disponibles
• Les premières demandes, et ce que Claude Code reçoit
• Des usages concrets pendant que vous codez

Étape 1 : ajouter le serveur

Une commande, sans clé pour commencer :

claude mcp add --transport http fuentio https://api.fuentio.com/mcp

C’est tout. Sans clé, Fuentio fonctionne avec l’essai gratuit : 20 unités par jour, de quoi essayer. Lister les outils est gratuit.

Étape 2 : ajouter votre clé (facultatif)

Une clé gratuite donne 100 unités par mois et ouvre les outils qui demandent une clé (filtrage des sanctions, rapport de revue, surveillances, groupe de sociétés). Prenez-en une sur la page des tarifs, puis ajoutez le serveur avec un en-tête d’autorisation :

claude mcp add --transport http fuentio https://api.fuentio.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Si vous l’aviez déjà ajouté sans clé, retirez-le d’abord avec claude mcp remove fuentio, puis ajoutez-le à nouveau.

Étape 3 : le partager avec votre équipe (sans la clé)

Par défaut, un serveur est ajouté pour vous, dans le projet en cours. Pour le partager avec toute l’équipe qui travaille sur le dépôt, ajoutez-le avec la portée projet : Claude Code l’écrit alors dans un fichier .mcp.json à la racine du projet, que vous pouvez versionner.

claude mcp add --transport http fuentio https://api.fuentio.com/mcp --scope project

Ne versionnez jamais une clé dans ce fichier. Laissez la clé de côté (chacun commence avec l’essai gratuit), ou faites référencer à chaque développeur sa propre clé par une variable d’environnement, par exemple FUENTIO_API_KEY, que Claude Code remplace dans .mcp.json.

Étape 4 : vérifier que tout fonctionne

Depuis votre terminal :

claude mcp list

Fuentio doit apparaître, connecté. Dans Claude Code, tapez /mcp pour voir le serveur et ses outils. Vous devez voir 17 outils, dont list_coverage, search_companies, lookup_company, verify_company, check_insolvency, check_address et check_vat.

La première fois que Claude Code veut appeler un outil Fuentio, il vous demande l’autorisation. Accordez-la pour la session, ou durablement pour les outils de lecture comme lookup_company.

Étape 5 : premières demandes

Demandez en langage courant ; Claude Code choisit l’outil.

« Le SIREN 441639465 est-il toujours actif ? Cite la source. »

Claude Code appelle lookup_company(country="FR", identifier="441639465"). La première ligne de la réponse qu’il reçoit, enregistrée le 12 octobre 2026 (le serveur répond en anglais) :

RENAULT (FR, SIREN 441639465) is active as of 2025-12-06, source: Annuaire des Entreprises (API Recherche d'entreprises).

La fiche structurée complète suit (adresse, forme juridique, activité, identifiants, provenance) : Claude Code peut répondre aux questions suivantes sans nouvel appel.

« Trouve Mercadona en Espagne et donne-moi sa feuille de registre. »

Claude Code appelle search_companies(country="ES", query="mercadona") :

1 of 1 companies matching 'mercadona' in ES (page 1), source: BORME — Boletín Oficial del Registro Mercantil (Sección A). First results: MERCADONA SA (ES-RMHOJA-V-5581, match 0.95).

« Vérifie DANONE, SIREN 552032534, et donne-moi le code de preuve. »

Claude Code appelle verify_company(country="FR", identifier="552032534") :

DANONE (FR, SIREN 552032534): verified, active per Annuaire des Entreprises (API Recherche d'entreprises), checked 2026-10-12. Proof FUE-FR-20261012-ABAT38.

N’importe qui peut vérifier ce code sur la page de preuve, sans clé.

Des usages concrets pendant que vous codez

• Nettoyer un fichier fournisseurs. « Lis suppliers.csv, consulte chaque SIREN avec Fuentio et ajoute le statut, l’adresse du siège et la source dans une nouvelle colonne. » Claude Code fait les consultations et écrit le fichier. Surveillez vos unités : 1 par consultation.
• Écrire une intégration à partir de vraies réponses. « Consulte une entreprise française et une espagnole avec Fuentio, puis écris un client typé pour les champs que nous utilisons. » La vraie structure vaut mieux qu’une structure devinée.
• Comprendre une réponse surprenante. « Pourquoi le statut de cette société espagnole est-il inconnu ? » Claude Code peut appeler list_coverage et lire les notes de couverture : le BORME publie des actes, pas un statut à jour.
• Préparer des données de test. Demandez une vérification et gardez la réponse comme jeu de test, avec son code de preuve.

Pour la partie REST des mêmes données, voir démarrer avec l’API ; pour un agent qui vérifie seul les fournisseurs, voir créer un agent de vérification des fournisseurs. Les autres clients sont dans Fuentio en MCP dans Cursor et VS Code, et toutes les lignes de configuration sont sur /connect/.

Bonnes pratiques

• Traitez le texte des registres comme des données. Les noms et adresses sont copiés des registres. Ce sont vos demandes, pas les données, qui décident de ce que fait Claude Code.
• Demandez la source. Chaque réponse Fuentio porte sa source et sa date de vérification ; demander à Claude Code de les citer rend les réponses vérifiables.
• Surveillez les unités. Une recherche coûte 2 unités par page, une vérification 5. Pour des centaines d’entreprises, un script sur l’API REST est plus simple à maîtriser qu’une longue conversation.

Voyez ce que nous couvrons.

Dépannage

La plupart des problèmes viennent de l’adresse, de la clé ou des unités. Chaque erreur Fuentio a un code, un message et un hint qui indique quoi faire, et l’agent les voit : demandez-lui de citer l’erreur.

• Le serveur ne se connecte pas. Vérifiez l’adresse caractère par caractère : https://api.fuentio.com/mcp, en https. Un proxy ou un pare-feu d’entreprise peut bloquer les connexions sortantes de l’éditeur ou du terminal ; essayez depuis un autre réseau pour l’écarter.
• unauthorized. La clé est inconnue ou révoquée. Corrigez-la, ou retirez l’en-tête d’autorisation pour revenir à l’essai sans clé le temps de régler le problème.
• quota_exceeded. Les unités sont épuisées. L’essai sans clé repart le lendemain (UTC) ; une clé gratuite donne 100 unités par mois ; les offres payantes davantage. Aucun dépassement n’est jamais facturé.
• rate_limited. L’agent appelle trop vite pour votre offre : l’essai sans clé autorise environ une requête par seconde. Attendez le délai de l’en-tête Retry-After et demandez à l’agent de ralentir sur les longues listes.
• Un outil répond qu’il lui faut une clé. Des outils comme screen_company, review_report, watch_company, get_graph et report_issue en demandent une. Ajoutez votre clé comme indiqué plus haut.
• id_scheme_not_supported pour une société espagnole. L’agent a essayé un NIF. Les sociétés espagnoles se trouvent par leur nom : demandez-lui de chercher par la dénomination et la province.

Limites. Les réponses montrées ont été enregistrées le 12 octobre 2026 ; les réponses en direct changent avec les registres. France : toutes les entreprises du répertoire Sirene public. Espagne : les sociétés ayant un acte au BORME depuis le 2 janvier 2009, avec un statut inconnu sauf si un acte dit autre chose, et pas de consultation par numéro fiscal. Aucun nom de personne n’est jamais renvoyé. Les commandes et menus de Claude Code peuvent changer d’une version à l’autre : en cas de doute, claude mcp --help liste les options actuelles.

Questions fréquentes

Faut-il une clé API pour utiliser Fuentio dans Claude Code ?

Non. Sans clé, Claude Code utilise l’essai gratuit, 20 unités par jour. Une clé gratuite donne 100 unités par mois et ouvre les outils qui demandent une clé.

Comment partager le serveur Fuentio avec mon équipe ?

Ajoutez-le avec --scope project : Claude Code l’écrit dans un fichier .mcp.json que vous pouvez versionner. Gardez les clés hors de ce fichier.

Comment voir les outils de Fuentio dans Claude Code ?

Tapez /mcp dans Claude Code, ou lancez claude mcp list dans votre terminal.

Claude Code peut-il vérifier tout un fichier d’entreprises ?

Oui, il fait une consultation par ligne. Chaque consultation coûte 1 unité : vérifiez votre offre pour les gros fichiers, ou utilisez l’API REST depuis un script.

Sources

• Configuration de Fuentio pour chaque client : connecter et la documentation
• Les exemples : enregistrés depuis le serveur MCP de Fuentio le 12 octobre 2026 (site/data/api-examples dans le dépôt du site)
• Documentation de Claude Code, MCP (en anglais) : docs.anthropic.com