Skill pour Claude Code
La skill de Frihet pour Claude Code transforme votre terminal en un assistant de gestion d'entreprise. Ce n'est pas seulement un accès à l'API — c'est de l'intelligence métier : contexte fiscal espagnol, recettes de flux de travail, rapports financiers formatés et commandes en langage naturel.
Prérequis
- Claude Code installé
- Compte Frihet avec accès à l'API (plans payants)
- Serveur MCP de Frihet configuré (voir instructions)
Installation
Recommandé : Une commande (30+ agents)
npx skills add Frihet-io/frihet-mcp
Installe la skill et la configure automatiquement. Fonctionne avec Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, et 30+ autres agents.
Alternative : Copier manuellement
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
Configurer le serveur MCP
Si vous ne l'avez pas encore, ajoutez ceci à votre ~/.claude/mcp.json :
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_votre_cle_ici"
}
}
}
}
Obtenir la clé API : app.frihet.io > Configuration > API > Créer clé.
Commandes
| Commande | Description |
|---|---|
/frihet status | Résumé du compte : dernières factures, paiements en attente, dépenses du mois |
/frihet invoice | Créer, lister ou rechercher des factures |
/frihet expense | Enregistrer et consulter les dépenses |
/frihet clients | Gérer la base de clients |
/frihet quote | Créer et gérer des devis |
/frihet report | Résumés financiers (P&L, trimestriel, débiteurs) |
/frihet webhooks | Configurer des déclencheurs d'automatisation |
/frihet setup | Configuration guidée et test de connexion |
Exemples d'utilisation
Créer une facture
/frihet invoice "Acme SL, 40 heures de conseil à 75 EUR/heure, échéance 1er mars"
Claude crée la facture avec les lignes de détail, calcule la TVA à 21 %, et confirme le numéro attribué.
Enregistrer rapidement des dépenses
/frihet expense "47.50 essence 15 fév"
/frihet expense "Adobe CC 59.99 logiciel"
/frihet expense "Repas client 23.40 restaurant"
La skill déduit la catégorie et indique si elle est déductible selon les règles fiscales espagnoles.
Préparer la TVA trimestrielle
/frihet report quarterly
Calcule automatiquement :
- TVA collectée (facturée)
- TVA déductible (payée sur les dépenses déductibles)
- Résultat à payer ou à compenser
- Données prêtes pour le Formulaire 303
Suivi des débiteurs
/frihet report unpaid
Liste les factures échues triées par montant, jours de retard, et suggère des actions de suivi.
Clôture mensuelle
/frihet report
Résumé complet du mois : revenus facturés, dépenses, résultat net, TVA nette, factures en attente de paiement.
Contexte fiscal intégré
La skill connaît le contexte fiscal espagnol :
| Concept | Détail |
|---|---|
| TVA générale | 21% |
| TVA réduite | 10% (alimentation, transport) |
| TVA super-réduite | 4% (pain, livres, médicaments) |
| IRPF professionnels | 15% (7% les 3 premières années) |
| Formulaire 303 | TVA trimestrielle : avr, juil, oct, janv |
| Formulaire 130 | IRPF trimestriel (estimation directe) |
| Verifactu | Obligatoire : sociétés janv 2027, indépendants juil 2027 |
Elle connaît également les règles de déductibilité des dépenses (essence 50%, repas max 26,67 EUR/jour, etc.) et les applique automatiquement lors de l'enregistrement des dépenses.
Flux de travail
La skill inclut des recettes pour les opérations courantes :
- Clôture mensuelle — Résumé des revenus, dépenses, TVA et résultat net
- Préparation 303 — Pré-calcul de la TVA trimestrielle avec ventilation par ligne
- Création de client — Créer un client + première facture en une seule étape
- Devis en facture — Convertir un devis accepté en facture
- Lot de dépenses — Enregistrer plusieurs dépenses à la fois avec catégorisation automatique
- Débiteurs — Factures échues, triées par montant, avec jours de retard
Différence avec le serveur MCP
| Serveur MCP | Skill | |
|---|---|---|
| Portée | 52 outils CRUD | Outils + intelligence métier |
| Contexte | Aucun | Fiscal espagnol, déductibilité, calendrier |
| Flux | Opérations unitaires | Recettes multi-étapes (clôture, 303, conversion) |
| Format | JSON brut | Tableaux et résumés lisibles |
| Prérequis | Clé API | Clé API + serveur MCP |
La skill utilise le serveur MCP en dessous. Elle ne duplique pas la logique, elle ajoute du contexte.
Sécurité
- La clé API est gérée exclusivement via des variables d'environnement dans la configuration MCP
- La skill n'affiche, n'enregistre ni ne stocke jamais votre clé API
- Toutes les données transitent chiffrées entre Claude Code, le serveur MCP et l'API de Frihet
- Le serveur MCP ne stocke rien — pont stateless