Fuentio
Clé gratuite

Fuentio en MCP dans Cursor et VS Code : installation pas à pas

Ajoutez le serveur MCP de Fuentio à Cursor ou VS Code en un clic ou un fichier JSON, gardez votre clé hors du dépôt et vérifiez des entreprises.

· Par l’équipe Fuentio · 7 min de lecture

Image de partage : « Fuentio en MCP dans Cursor et VS Code : installation pas à pas » sur le fond papier de Fuentio, avec l’étiquette Tutoriel.

Cursor et VS Code font tous deux tourner des agents IA capables d’appeler des outils grâce à MCP, le Model Context Protocol. Ajoutez Fuentio et l’agent de votre éditeur peut consulter, chercher et vérifier des entreprises françaises et espagnoles dans les registres officiels : pendant qu’il écrit un script d’import, nettoie un fichier de test ou répond à une question sur un fournisseur.

Ce tutoriel couvre les deux éditeurs : l’installation en un clic, le fichier JSON si vous préférez l’écrire vous-même, l’ajout d’une clé API sans la versionner, la vérification des outils, et une première demande.

Ce que vous allez apprendre

  • L’installation en un clic pour chaque éditeur
  • Le fichier mcp.json pour Cursor, et .vscode/mcp.json pour VS Code
  • Ajouter votre clé sans la mettre dans le dépôt
  • Vérifier que le serveur et ses 17 outils sont disponibles
  • Une première demande et ce que reçoit l’agent

L’adresse

Les deux éditeurs se connectent à la même adresse, en HTTP « streamable » :

https://api.fuentio.com/mcp

Pas de clé pour commencer : Fuentio fonctionne avec l’essai gratuit (20 unités par jour), et lister les outils est gratuit. Une clé gratuite donne 100 unités par mois et ouvre les outils qui en demandent une.

Cursor

En un clic

Sur la page de connexion, ouvrez l’onglet Cursor et cliquez sur Ajouter à Cursor. Cursor s’ouvre et vous demande de confirmer le nouveau serveur.

Ou avec le fichier JSON

Ajoutez Fuentio dans ~/.cursor/mcp.json (tous vos projets) ou .cursor/mcp.json (un projet) :

{
  "mcpServers": {
    "fuentio": {
      "url": "https://api.fuentio.com/mcp"
    }
  }
}

Avec une clé, ajoutez un en-tête d’autorisation :

{
  "mcpServers": {
    "fuentio": {
      "url": "https://api.fuentio.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Gardez la version avec la clé dans votre fichier global (~/.cursor/mcp.json), pas dans un fichier de projet versionné. Un fichier de projet sans clé peut être partagé sans risque : chacun commence avec l’essai gratuit.

Vérifier

Ouvrez les réglages de Cursor et trouvez la section MCP : Fuentio doit y apparaître, activé, avec ses outils. Utilisez ensuite l’agent dans la conversation et posez une question ; Cursor montre l’appel d’outil avant de l’exécuter.

VS Code

Dans VS Code, les outils MCP sont utilisés par l’agent de la conversation (mode agent).

En un clic

Sur la page de connexion, ouvrez l’onglet VS Code et cliquez sur Ajouter à VS Code. VS Code s’ouvre et propose d’installer le serveur.

Ou avec le fichier JSON

Dans votre projet, créez .vscode/mcp.json :

{
  "servers": {
    "fuentio": {
      "type": "http",
      "url": "https://api.fuentio.com/mcp"
    }
  }
}

Une clé sans la versionner

VS Code peut demander un secret au premier démarrage du serveur et le garder hors du fichier. Déclarez une saisie et utilisez-la dans l’en-tête :

{
  "inputs": [
    { "type": "promptString", "id": "fuentio-key", "description": "Fuentio API key", "password": true }
  ],
  "servers": {
    "fuentio": {
      "type": "http",
      "url": "https://api.fuentio.com/mcp",
      "headers": { "Authorization": "Bearer ${input:fuentio-key}" }
    }
  }
}

Ce fichier peut être versionné : il ne contient aucune clé. Chaque développeur saisit la sienne la première fois.

Vérifier

Lancez MCP: List Servers depuis la palette de commandes : Fuentio doit apparaître, démarré. Dans la conversation, utilisez le mode agent et sélectionnez Configure Tools dans la zone de saisie : les outils de Fuentio y apparaissent, et vous pouvez les activer ou les désactiver un par un.

Une première demande

Dans l’un ou l’autre éditeur, demandez à l’agent :

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

L’agent appelle lookup_company(country="FR", identifier="441639465"). La première ligne de ce 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 : l’agent peut répondre aux questions suivantes (adresse, forme juridique, activité, identifiants) sans nouvel appel. Pour l’Espagne, demandez par le nom : « Trouve Mercadona en Espagne » appelle search_companies(country="ES", query="mercadona") et renvoie MERCADONA SA avec sa feuille de registre, V-5581.

Des demandes utiles pendant que vous codez

  • « Vérifie les SIREN de fixtures/suppliers.json avec Fuentio et signale toute entreprise qui n’est pas active. »
  • « Consulte une entreprise française et une espagnole et écris les types TypeScript des champs que nous utilisons. »
  • « Vérifie DANONE (SIREN 552032534) et ajoute son code de preuve aux notes de test. »
  • « Pourquoi le statut de cette société espagnole est-il inconnu ? » (l’agent peut appeler list_coverage et lire les notes).

Bonnes pratiques

  • Les clés restent hors des dépôts. Fichier global pour Cursor, saisie pour VS Code.
  • Demandez la source. Chaque réponse porte sa source et sa date de vérification : faites-les citer par l’agent.
  • Traitez le texte des registres comme des données. Noms et adresses viennent des registres ; ce sont vos instructions qui décident de ce que fait l’agent.
  • Surveillez les unités. Une consultation coûte 1 unité, une recherche 2 par page, une vérification 5.

Pour Claude Code, voir Fuentio dans Claude Code, pas à pas ; pour les mêmes données depuis votre propre code, démarrer avec l’API. Voyez ce que nous couvrons.

Configuration globale ou de projet ?

Les deux éditeurs acceptent le serveur à deux endroits. Une configuration globale vous suit dans tous vos projets : pratique pour votre propre clé. Une configuration de projet vit dans le dépôt : pratique pour donner les mêmes outils à toute l’équipe, à condition qu’elle ne contienne aucune clé. Une organisation courante combine les deux : le fichier du projet déclare Fuentio sans clé (ou avec la saisie de VS Code), et chaque développeur qui a une clé l’ajoute dans son fichier global ou la saisit quand on la lui demande.

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 éditeurs changent souvent leurs écrans de réglages : si un nom de menu diffère dans votre version, les fichiers JSON ci-dessus font référence. Les réponses montrées ont été enregistrées le 12 octobre 2026. 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. Aucun nom de personne n’est jamais renvoyé.

Questions fréquentes

Faut-il une clé pour utiliser Fuentio dans Cursor ou VS Code ?

Non. Sans clé, le serveur utilise l’essai gratuit, 20 unités par jour. Une clé gratuite donne 100 unités par mois.

Où mettre ma clé API dans Cursor ?

Dans les headers de l’entrée Fuentio de votre fichier global ~/.cursor/mcp.json, pas dans un fichier de projet versionné.

Comment garder ma clé hors de .vscode/mcp.json ?

Déclarez une saisie promptString avec password: true et utilisez-la sous la forme ${input:fuentio-key} dans l’en-tête. VS Code demande la clé une fois et la garde hors du fichier.

Combien d’outils Fuentio ajoute-t-il ?

17, de list_coverage et lookup_company à verify_company, check_insolvency et watch_company. Certains demandent une clé.

Sources

  • Configuration de Fuentio pour chaque client : connecter et la documentation
  • L’exemple : enregistré depuis le serveur MCP de Fuentio le 12 octobre 2026 (site/data/api-examples dans le dépôt du site)
  • Documentation de Cursor, MCP (en anglais) : docs.cursor.com
  • Documentation de VS Code, serveurs MCP (en anglais) : code.visualstudio.com

← Tous les articles · Flux RSS