Skill per Claude Code
La skill di Frihet per Claude Code trasforma il tuo terminale in un assistente di gestione aziendale. Non è solo accesso all'API — è intelligenza di business: contesto fiscale spagnolo, ricette di flussi di lavoro, report finanziari formattati e comandi in linguaggio naturale.
Requisiti
- Claude Code installato
- Account Frihet con accesso all'API (piani a pagamento)
- Server MCP di Frihet configurato (vedi istruzioni)
Installazione
Consigliato: Un comando (30+ agenti)
npx skills add Frihet-io/frihet-mcp
Installa la skill e la configura automaticamente. Funziona con Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI e altri 30+ agenti.
Alternativa: Copia manuale
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
Configurare il server MCP
Se non lo hai ancora, aggiungi questo al tuo ~/.claude/mcp.json:
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_tu_clave_aqui"
}
}
}
}
Ottieni chiave API: app.frihet.io > Configurazione > API > Crea chiave.
Comandi
| Comando | Descrizione |
|---|---|
/frihet status | Riepilogo account: ultime fatture, pagamenti in sospeso, spese del mese |
/frihet invoice | Crea, elenca o cerca fatture |
/frihet expense | Registra e consulta spese |
/frihet clients | Gestisci la base clienti |
/frihet quote | Crea e gestisci preventivi |
/frihet report | Riepiloghi finanziari (P&L, trimestrale, insolventi) |
/frihet webhooks | Configura trigger di automazione |
/frihet setup | Configurazione guidata e test di connessione |
Esempi di utilizzo
Crea una fattura
/frihet invoice "Acme SL, 40 ore di consulenza a 75 EUR/ora, scadenza 1 marzo"
Claude crea la fattura con le linee di dettaglio, calcola l'IVA al 21% e conferma il numero assegnato.
Registra spese velocemente
/frihet expense "47.50 benzina 15 feb"
/frihet expense "Adobe CC 59.99 software"
/frihet expense "Pasto cliente 23.40 ristorante"
La skill inferisce la categoria e indica se è deducibile secondo le regole fiscali spagnole.
Prepara l'IVA trimestrale
/frihet report quarterly
Calcola automaticamente:
- IVA a debito (riscosso nelle fatture)
- IVA a credito (pagato in spese deducibili)
- Risultato da versare o compensare
- Dati pronti per il Modello 303
Monitoraggio degli insolventi
/frihet report unpaid
Elenca le fatture scadute ordinate per importo, giorni di ritardo e suggerisce azioni di follow-up.
Chiusura mensile
/frihet report
Riepilogo completo del mese: ricavi fatturati, spese, risultato netto, IVA netta, fatture in sospeso.
Contesto fiscale integrato
La skill conosce il contesto fiscale spagnolo:
| Concetto | Dettaglio |
|---|---|
| IVA generale | 21% |
| IVA ridotta | 10% (alimentazione, trasporto) |
| IVA super-ridotta | 4% (pane, libri, medicinali) |
| IRPF professionisti | 15% (7% per i primi 3 anni) |
| Modello 303 | IVA trimestrale: apr, lug, ott, gen |
| Modello 130 | IRPF trimestrale (stima diretta) |
| Verifactu | Obbligatorio: società gen 2027, lavoratori autonomi lug 2027 |
Conosce anche le regole di deducibilità delle spese (benzina 50%, pasti max 26.67 EUR/giorno, ecc.) e le applica automaticamente al momento della registrazione delle spese.
Flussi di lavoro
La skill include ricette per operazioni comuni:
- Chiusura mensile — Riepilogo di ricavi, spese, IVA e risultato netto
- Preparazione 303 — Pre-calcolo dell'IVA trimestrale con dettaglio per riga
- Registrazione cliente — Crea cliente + prima fattura in un unico passaggio
- Preventivo a fattura — Converti un preventivo accettato in fattura
- Lotto di spese — Registra più spese contemporaneamente con categorizzazione automatica
- Insolventi — Fatture scadute, ordinate per importo, con giorni di ritardo
Differenza con il server MCP
| Server MCP | Skill | |
|---|---|---|
| Scopo | 52 strumenti CRUD | Strumenti + intelligenza di business |
| Contesto | Nessuno | Fiscale spagnolo, deducibilità, calendario |
| Flussi | Operazioni unitarie | Ricette multi-step (chiusura, 303, conversione) |
| Formato | JSON grezzo | Tabelle e riepiloghi leggibili |
| Prerequisito | Chiave API | Chiave API + server MCP |
La skill utilizza il server MCP sottostante. Non duplica la logica, aggiunge contesto.
Sicurezza
- La chiave API viene gestita esclusivamente tramite variabili d'ambiente nella configurazione MCP
- La skill non mostra, registra né memorizza mai la tua chiave API
- Tutti i dati viaggiano cifrati tra Claude Code, il server MCP e l'API di Frihet
- Il server MCP non memorizza nulla — ponte stateless