Quelle est la différence entre les Ressources et les Tools dans le MCP ?

Les Tools exécutent des actions contre l'API (créer une facture, lister les dépenses). Les Ressources exposent des données de référence statiques que l'agent peut consulter sans faire d'appels API. Les taux d'imposition, les calendriers fiscaux ou les catégories de dépenses sont toujours disponibles comme contexte.

Que sont les prompts MCP et comment les utiliser ?

Les prompts sont des flux de travail guidés qui enchaînent plusieurs outils dans une séquence logique. Au lieu d'exécuter des opérations isolées, un prompt comme monthly-close guide l'agent étape par étape : réviser les factures en attente, catégoriser les dépenses, vérifier les obligations fiscales.

Dois-je mettre à jour quelque chose pour utiliser la v1.2 ?

Si vous utilisez npx @frihet/mcp-server, vous obtenez la dernière version automatiquement. Si vous avez une installation fixe, mettez à jour avec npm update @frihet/mcp-server. Il n'y a pas de changements disruptifs par rapport à la v1.1.0.

Serveur MCP v1.2 : ressources, prompts et sortie structurée

La version 1.2.1 du serveur MCP de Frihet n’ajoute pas plus d’outils. Elle ajoute de l’intelligence. Des ressources pour que les agents aient un contexte fiscal sans demander. Des prompts pour qu’ils exécutent des flux complets sans intervention. Une sortie structurée pour que chaque réponse soit parsable de manière déterministe.

Cette mise à jour transforme le serveur MCP d’un pont d’opérations CRUD en une interface de gestion d’entreprise complète pour les agents d’IA.

Ressources : données de référence toujours disponibles

Les Ressources MCP sont des données statiques que l’agent peut lire à tout moment sans faire d’appels à l’API de Frihet. Elles ne consomment pas de quota, ne nécessitent pas d’authentification supplémentaire et sont disponibles dès que le serveur se connecte.

La v1.2 introduit 5 ressources :

`frihet://api/schema`

Résumé de tous les endpoints disponibles, méthodes d’authentification et limites de débit. Lorsqu’un agent a besoin de savoir ce qu’il peut faire avec Frihet, il consulte cette ressource au lieu de le découvrir par essais et erreurs.

`frihet://tax/rates`

Taux d’imposition en vigueur en Espagne : TVA générale (21%), réduite (10%) et super-réduite (4%); IGIC canarien (7%, 3%, 0%); retenues IRPF. L’agent dispose de ce contexte avant de créer une facture ou d’enregistrer une dépense. Il n’a pas besoin de vous demander quelle TVA appliquer s’il sait déjà où votre entreprise opère.

`frihet://tax/calendar`

Dates de dépôt des déclarations trimestrielles : Modèle 303 (IVA), Modèle 130 (IRPF), Modèle 420 (IGIC). Lorsque l’agent prépare une clôture trimestrielle, il sait exactement quand chaque obligation est due.

`frihet://config/expense-categories`

Les 8 catégories de dépenses avec leurs règles de déductibilité. Matériel de bureau, fournitures, transport, frais de repas, formation, assurances, services professionnels, autres. Chaque catégorie inclut le pourcentage de déductibilité et les conditions applicables.

`frihet://config/invoice-statuses`

Le flux des statuts d’une facture : brouillon, émise, envoyée, encaissée, échue, annulée. Chaque statut inclut les transitions autorisées et les déclencheurs (webhooks, notifications) qui peuvent être activés. L’agent sait quelles actions sont valides à tout moment.

Prompts : flux de travail guidés

Un Tool exécute une opération. Un Prompt orchestre plusieurs opérations dans un flux cohérent. La différence est de passer de “créer cette dépense” à “traiter ces 15 tickets de dépense, les catégoriser, appliquer les taxes correctes et confirmer avant de créer”.

La v1.2 inclut 5 prompts :

`monthly-close`

Clôture mensuelle guidée. L’agent examine les factures en attente de paiement, catégorise les dépenses non attribuées, vérifie que les obligations fiscales de la période sont couvertes et génère un résumé. Un flux qui prend normalement une heure de révision manuelle, exécuté en une conversation.

`onboard-client`

Enregistrement d’un nouveau client. Détermine le type d’imposition selon l’emplacement du client (IVA péninsulaire, IGIC canarien, intracommunautaire), crée l’enregistrement avec les données fiscales correctes et génère un devis de bienvenue. Le tout en une séquence.

`quarterly-tax-prep`

Préparation trimestrielle des impôts. Recueille toutes les factures de la période, calcule les bases imposables de l’IVA ou de l’IGIC, applique les retenues IRPF et génère un aperçu du Modèle 303 ou 130. L’agent fait le travail ; vous ou votre expert-comptable validez le résultat.

`overdue-followup`

Suivi des factures échues. Identifie toutes les factures en retard, les regroupe par client, calcule le montant total dû par chacun et rédige des messages de recouvrement personnalisés. De “je dois vérifier ce qu’ils me doivent” à “voici les brouillons prêts à être envoyés”.

`expense-batch`

Traitement des dépenses par lots. Reçoit une liste de dépenses, les catégorise selon les règles configurées, applique les taxes correspondantes, vérifie la déductibilité de chacune et les crée avec confirmation préalable. Idéal pour traiter les tickets accumulés d’une semaine ou d’un voyage.

Sortie structurée : réponses parsables

Jusqu’à présent, les réponses du serveur MCP étaient du texte formaté. Utile pour la lecture humaine, mais les agents ont besoin de données structurées pour prendre des décisions programmatiques.

La v1.2 ajoute outputSchema et structuredContent à chaque outil. Chaque réponse inclut un schéma JSON qui décrit exactement la structure des données renvoyées. L’agent sait avant d’appeler quels champs il va recevoir, de quel type ils sont et lesquels sont optionnels.

C’est ce qui permet à un prompt comme quarterly-tax-prep d’enchaîner 4 opérations de manière fiable : chaque étape produit des données avec une structure connue que l’étape suivante peut consommer sans ambiguïté.

Pour les développeurs qui construisent des intégrations sur le serveur MCP, cela élimine le besoin d’analyser du texte libre. La réponse a toujours la même forme.

Annotations de sécurité

Chaque outil du serveur MCP inclut désormais des annotations qui indiquent si l’opération est en lecture seule ou destructive. Un list-invoices est marqué comme lecture. Un delete-expense est marqué comme destructif.

Cela permet aux agents de mettre en œuvre des politiques de confirmation. Un agent peut exécuter des opérations de lecture sans demander, mais demander une confirmation explicite avant de supprimer ou de modifier des données. La sécurité ne dépend pas de l’agent — elle est définie par le serveur.

Installation universelle

Le serveur s’installe avec une seule commande sur n’importe quel agent compatible :

npx @frihet/mcp-server

Il fonctionne sur Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex et tout client MCP. Pour les agents qui supportent l’installation via des skills :

npx skills add Frihet-io/frihet-mcp

Les deux méthodes donnent accès aux plus de 30 outils, aux 5 ressources, aux 5 prompts et à la sortie structurée.

Dépôt sous Frihet-io

Le serveur MCP a été transféré à l’organisation Frihet-io sur GitHub. L’URL du dépôt est maintenant github.com/Frihet-io/frihet-mcp. Les liens précédents redirigent automatiquement.

Le package npm reste @frihet/mcp-server. Il n’y a pas de changements dans l’installation.

Pour qui est cette mise à jour

Les professionnels qui utilisent déjà le serveur MCP bénéficient de Ressources comme contexte fiscal automatique et de Prompts comme des flux qu’ils exécutaient auparavant manuellement étape par étape.

Les développeurs qui construisent sur Frihet bénéficient d’une sortie structurée pour des intégrations déterministes et d’annotations de sécurité pour des politiques de confirmation.

Les cabinets de gestion et les conseillers fiscaux bénéficient de prompts spécifiques pour leurs flux de travail : clôture mensuelle, préparation trimestrielle, suivi des recouvrements.

Toute entreprise utilisant des agents d’IA bénéficie d’un serveur MCP qui non seulement exécute des opérations, mais sait aussi comment les enchaîner dans des flux d’affaires réels.

Comment mettre à jour

Si vous utilisez npx @frihet/mcp-server, vous avez déjà la dernière version. Si vous avez une installation fixe :

npm update @frihet/mcp-server

Il n’y a pas de changements disruptifs. Tous les outils existants conservent leur interface. Les Ressources, les Prompts et la sortie structurée sont des ajouts purs.

La documentation complète est sur docs.frihet.io/développeurs. Le code source sur GitHub (Frihet-io/frihet-mcp). Le package sur npm comme @frihet/mcp-server.