Skill för Claude Code
Frihets skill för Claude Code förvandlar din terminal till en assistent för företagsledning. Det är inte bara API-åtkomst — det är affärsintelligens: spanskt skattesammanhang, recept för arbetsflöden, formaterade finansiella rapporter och kommandon på naturligt språk.
Krav
- Claude Code installerat
- Frihet-konto med API-åtkomst (betalplaner)
- Frihet MCP-server konfigurerad (se instruktioner)
Installation
Rekommenderat: Ett kommando (30+ agenter)
npx skills add Frihet-io/frihet-mcp
Installerar skillen och konfigurerar den automatiskt. Fungerar med Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI, och 30+ fler agenter.
Alternativ: Kopiera manuellt
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
Konfigurera MCP-servern
Om du inte redan har det, lägg till detta i din ~/.claude/mcp.json:
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_tu_clave_aqui"
}
}
}
}
Hämta API-nyckel: app.frihet.io > Inställningar > API > Skapa nyckel.
Kommandon
| Kommando | Beskrivning |
|---|---|
/frihet status | Kontosammanfattning: senaste fakturor, obetalda betalningar, månadens utgifter |
/frihet invoice | Skapa, lista eller sök fakturor |
/frihet expense | Registrera och konsultera utgifter |
/frihet clients | Hantera kundbas |
/frihet quote | Skapa och hantera offerter |
/frihet report | Finansiella sammanfattningar (P&L, kvartalsvis, förfallna) |
/frihet webhooks | Konfigurera automatiserings-triggers |
/frihet setup | Guidade inställningar och anslutningstest |
Användningsexempel
Skapa en faktura
/frihet invoice "Acme SL, 40 timmar konsultation till 75 EUR/timme, förfallodatum 1 mars"
Claude skapar fakturan med detaljraderna, beräknar moms på 21%, och bekräftar det tilldelade numret.
Registrera utgifter snabbt
/frihet expense "47.50 bensin 15 feb"
/frihet expense "Adobe CC 59.99 programvara"
/frihet expense "Kundmåltid 23.40 restaurang"
Skill-en härleder kategorin och markerar om den är avdragsgill enligt spanska skatteregler.
Förbered kvartalsvis moms
/frihet report quarterly
Beräknar automatiskt:
- Utgående moms (debiterad på fakturor)
- Ingående moms (betald på avdragsgilla utgifter)
- Resultat att betala in eller kompensera
- Data redo för blankett 303
Uppföljning av förfallna fakturor
/frihet report unpaid
Listar förfallna fakturor sorterade efter belopp, förseningsdagar, och föreslår uppföljningsåtgärder.
Månadsbokslut
/frihet report
Fullständig månadssammanfattning: fakturerade intäkter, utgifter, nettoresultat, nettomoms, obetalda fakturor.
Integrerad skattekonttext
Skill-en känner till den spanska skattekonttexten:
| Koncept | Detalj |
|---|---|
| Allmän moms | 21% |
| Reducerad moms | 10% (mat, transport) |
| Superreducerad moms | 4% (bröd, böcker, mediciner) |
| IRPF professionella | 15% (7% första 3 åren) |
| Blankett 303 | Kvartalsvis moms: apr, jul, okt, jan |
| Blankett 130 | Kvartalsvis IRPF (direkt beräkning) |
| Verifactu | Obligatoriskt: företag jan 2027, egenföretagare jul 2027 |
Den känner även till reglerna för avdragsgillhet av utgifter (bensin 50%, måltider max 26.67 EUR/dag, etc.) och tillämpar dem automatiskt vid registrering av utgifter.
Arbetsflöden
Skill-en innehåller recept för vanliga operationer:
- Månadsbokslut — Sammanfattning av intäkter, utgifter, moms och nettoresultat
- Förberedelse 303 — Förberäkning av kvartalsvis moms med radspecifikation
- Ny kund — Skapa kund + första fakturan i ett enda steg
- Offert till faktura — Omvandla en accepterad offert till faktura
- Utgiftsbatch — Registrera flera utgifter samtidigt med automatisk kategorisering
- Förfallna fakturor — Förfallna fakturor, sorterade efter belopp, med förseningsdagar
Skillnad mot MCP-servern
| MCP-server | Skill | |
|---|---|---|
| Omfattning | 52 CRUD-verktyg | Verktyg + affärsintelligens |
| Kontext | Ingen | Spansk skatt, avdragsgillhet, kalender |
| Flöden | Enskilda operationer | Flerstegsrecept (bokslut, 303, konvertering) |
| Format | Rå JSON | Läsbara tabeller och sammanfattningar |
| Förutsättning | API-nyckel | API-nyckel + MCP-server |
Skill-en använder MCP-servern under ytan. Den duplicerar inte logik, den lägger till kontext.
Säkerhet
- API-nyckeln hanteras exklusivt via miljövariabler i MCP-konfigurationen
- Skill-en visar, loggar eller lagrar aldrig din API-nyckel
- All data överförs krypterat mellan Claude Code, MCP-servern och Frihets API
- MCP-servern lagrar ingenting — statslös brygga