Skill für Claude Code
Der Frihet Skill für Claude Code verwandelt Ihr Terminal in einen Unternehmensverwaltungsassistenten. Es ist nicht nur API-Zugriff – es ist Business Intelligence: spanischer Steuerkontext, Workflow-Rezepte, formatierte Finanzberichte und Befehle in natürlicher Sprache.
Voraussetzungen
- Claude Code installiert
- Frihet-Konto mit API-Zugriff (kostenpflichtige Pläne)
- Frihet MCP-Server konfiguriert (Anweisungen ansehen)
Installation
Empfohlen: Ein Befehl (30+ Agenten)
npx skills add Frihet-io/frihet-mcp
Installiert den Skill und konfiguriert ihn automatisch. Funktioniert mit Claude Code, Cursor, Copilot, Codex, Windsurf, Gemini CLI und 30+ weiteren Agenten.
Alternative: Manuell kopieren
curl -sL https://raw.githubusercontent.com/Frihet-io/frihet-mcp/main/skill/SKILL.md \
-o ~/.claude/skills/frihet-mcp/SKILL.md --create-dirs
MCP-Server konfigurieren
Falls Sie ihn noch nicht haben, fügen Sie dies zu Ihrer ~/.claude/mcp.json hinzu:
{
"mcpServers": {
"frihet": {
"command": "npx",
"args": ["-y", "@frihet/mcp-server"],
"env": {
"FRIHET_API_KEY": "fri_tu_clave_aqui"
}
}
}
}
API-Schlüssel erhalten: app.frihet.io > Einstellungen > API > Schlüssel erstellen.
Befehle
| Befehl | Beschreibung |
|---|---|
/frihet status | Kontoübersicht: letzte Rechnungen, ausstehende Zahlungen, Ausgaben des Monats |
/frihet invoice | Rechnungen erstellen, auflisten oder suchen |
/frihet expense | Ausgaben erfassen und abfragen |
/frihet clients | Kundenstamm verwalten |
/frihet quote | Angebote erstellen und verwalten |
/frihet report | Finanzübersichten (GuV, vierteljährlich, säumige Zahler) |
/frihet webhooks | Automatisierungs-Trigger konfigurieren |
/frihet setup | Geführte Konfiguration und Verbindungstest |
Anwendungsbeispiele
Eine Rechnung erstellen
/frihet invoice "Acme SL, 40 Stunden Beratung zu 75 EUR/Stunde, Fälligkeit 1. März"
Claude erstellt die Rechnung mit den Detailpositionen, berechnet 21% Mehrwertsteuer und bestätigt die zugewiesene Nummer.
Ausgaben schnell erfassen
/frihet expense "47.50 Benzin 15. Feb"
/frihet expense "Adobe CC 59.99 Software"
/frihet expense "Kundenessen 23.40 Restaurant"
Der Skill leitet die Kategorie ab und kennzeichnet, ob sie gemäß den spanischen Steuervorschriften abzugsfähig ist.
Die vierteljährliche Mehrwertsteuer vorbereiten
/frihet report quarterly
Berechnet automatisch:
- Abgeführte Mehrwertsteuer (auf Rechnungen erhoben)
- Abziehbare Mehrwertsteuer (auf abzugsfähigen Ausgaben gezahlt)
- Ergebnis zum Einzahlen oder Verrechnen
- Daten bereit für das Modell 303
Überwachung von säumigen Zahlern
/frihet report unpaid
Listet überfällige Rechnungen auf, sortiert nach Betrag, Verzugstagen, und schlägt Folgeaktionen vor.
Monatsabschluss
/frihet report
Vollständige Monatsübersicht: fakturierte Einnahmen, Ausgaben, Nettoergebnis, Netto-Mehrwertsteuer, offene Rechnungen.
Integrierter Steuerkontext
Der Skill kennt den spanischen Steuerkontext:
| Konzept | Detail |
|---|---|
| Allgemeine Mehrwertsteuer | 21% |
| Ermäßigte Mehrwertsteuer | 10% (Nahrungsmittel, Transport) |
| Super-ermäßigte Mehrwertsteuer | 4% (Brot, Bücher, Medikamente) |
| IRPF für Freiberufler | 15% (7% erste 3 Jahre) |
| Modell 303 | Vierteljährliche Mehrwertsteuer: Apr, Jul, Okt, Jan |
| Modell 130 | Vierteljährliche IRPF (direkte Schätzung) |
| Verifactu | Obligatorisch: Unternehmen Jan 2027, Selbstständige Jul 2027 |
Er kennt auch die Regeln zur Abzugsfähigkeit von Ausgaben (Benzin 50%, Mahlzeiten max. 26,67 EUR/Tag usw.) und wendet diese beim Erfassen von Ausgaben automatisch an.
Workflows
Der Skill enthält Rezepte für gängige Operationen:
- Monatsabschluss — Übersicht über Einnahmen, Ausgaben, Mehrwertsteuer und Nettoergebnis
- Vorbereitung 303 — Vorab-Berechnung der vierteljährlichen Mehrwertsteuer mit Aufschlüsselung pro Position
- Kundenanlage — Kunde erstellen + erste Rechnung in einem Schritt
- Angebot zur Rechnung — Ein angenommenes Angebot in eine Rechnung umwandeln
- Ausgabenstapel — Mehrere Ausgaben auf einmal mit automatischer Kategorisierung erfassen
- Säumige Zahler — Überfällige Rechnungen, nach Betrag geordnet, mit Verzugstagen
Unterschied zum MCP-Server
| MCP-Server | Skill | |
|---|---|---|
| Umfang | 52 CRUD-Tools | Tools + Business Intelligence |
| Kontext | Keiner | Spanischer Steuerkontext, Abzugsfähigkeit, Kalender |
| Workflows | Einzeloperationen | Mehrschritt-Rezepte (Abschluss, 303, Umwandlung) |
| Format | Roher JSON | Lesbare Tabellen und Zusammenfassungen |
| Voraussetzung | API-Schlüssel | API-Schlüssel + MCP-Server |
Der Skill nutzt den MCP-Server im Hintergrund. Er dupliziert keine Logik, sondern fügt Kontext hinzu.
Sicherheit
- Der API-Schlüssel wird ausschließlich über Umgebungsvariablen in der MCP-Konfiguration verwaltet
- Der Skill zeigt, protokolliert oder speichert Ihren API-Schlüssel niemals
- Alle Daten werden verschlüsselt zwischen Claude Code, dem MCP-Server und der Frihet-API übertragen
- Der MCP-Server speichert nichts — stateless Brücke