Was ist der Unterschied zwischen Ressourcen und Tools in MCP?

Tools führen Aktionen gegen die API aus (Rechnung erstellen, Ausgaben auflisten). Ressourcen stellen statische Referenzdaten bereit, die der Agent abfragen kann, ohne API-Aufrufe zu tätigen. Steuersätze, Steuerkalender oder Ausgabenkategorien sind immer als Kontext verfügbar.

Was sind MCP Prompts und wie werden sie verwendet?

Prompts sind geführte Workflows, die mehrere Tools in einer logischen Reihenfolge verketten. Anstatt einzelne Operationen auszuführen, leitet ein Prompt wie 'monthly-close' den Agenten Schritt für Schritt an: Überprüfung offener Rechnungen, Kategorisierung von Ausgaben, Überprüfung steuerlicher Verpflichtungen.

Muss ich etwas aktualisieren, um v1.2 zu verwenden?

Wenn Sie npx @frihet/mcp-server verwenden, erhalten Sie die neueste Version automatisch. Wenn Sie eine feste Installation haben, aktualisieren Sie mit npm update @frihet/mcp-server. Es gibt keine Breaking Changes im Vergleich zu v1.1.0.

MCP Server v1.2: Ressourcen, Prompts und strukturierter Output

Die Version 1.2.1 des Frihet MCP-Servers fügt keine weiteren Tools hinzu. Sie fügt Intelligenz hinzu. Ressourcen, damit Agenten steuerlichen Kontext haben, ohne zu fragen. Prompts, damit sie komplette Abläufe ohne Eingriff ausführen. Strukturierter Output, damit jede Antwort deterministisch parsbar ist.

Dieses Update verwandelt den MCP-Server von einer Brücke für CRUD-Operationen in eine vollständige Business-Management-Schnittstelle für KI-Agenten.

Ressourcen: Referenzdaten immer verfügbar

MCP-Ressourcen sind statische Daten, die der Agent jederzeit lesen kann, ohne API-Aufrufe an Frihet zu tätigen. Sie verbrauchen kein Kontingent, erfordern keine zusätzliche Authentifizierung und sind verfügbar, sobald der Server verbunden ist.

v1.2 führt 5 Ressourcen ein:

`frihet://api/schema`

Zusammenfassung aller verfügbaren Endpunkte, Authentifizierungsmethoden und Ratenbegrenzungen. Wenn ein Agent wissen muss, was er mit Frihet tun kann, konsultiert er diese Ressource, anstatt es durch Versuch und Irrtum herauszufinden.

`frihet://tax/rates`

Aktuelle Steuersätze in Spanien: allgemeine IVA (21%), reduzierte (10%) und superreduzierte (4%); kanarische IGIC (7%, 3%, 0%); IRPF-Einbehaltungen. Der Agent hat diesen Kontext, bevor er eine Rechnung erstellt oder eine Ausgabe erfasst. Er muss Sie nicht fragen, welche IVA anzuwenden ist, wenn er bereits weiß, wo Ihr Unternehmen tätig ist.

`frihet://tax/calendar`

Fristen für die Einreichung vierteljährlicher Erklärungen: Modell 303 (IVA), Modell 130 (IRPF), Modell 420 (IGIC). Wenn der Agent einen Quartalsabschluss vorbereitet, weiß er genau, wann jede Verpflichtung fällig ist.

`frihet://config/expense-categories`

Die 8 Ausgabenkategorien mit ihren Abzugsfähigkeitsregeln. Büromaterial, Verbrauchsmaterialien, Transport, Spesen, Schulungen, Versicherungen, professionelle Dienstleistungen, Sonstiges. Jede Kategorie enthält den Abzugsfähigkeitsprozentsatz und die geltenden Bedingungen.

`frihet://config/invoice-statuses`

Der Statusfluss einer Rechnung: Entwurf, ausgestellt, gesendet, bezahlt, fällig, storniert. Jeder Status umfasst die zulässigen Übergänge und die Auslöser, die aktiviert werden können (webhooks, Benachrichtigungen). Der Agent weiß, welche Aktionen jederzeit gültig sind.

Prompts: Geführte Workflows

Ein Tool führt eine Operation aus. Ein Prompt orchestriert mehrere Operationen in einem kohärenten Fluss. Der Unterschied besteht darin, von “erstelle diese Ausgabe” zu “verarbeite diese 15 Belege, kategorisiere sie, wende die korrekten Steuern an und bestätige vor dem Erstellen” zu wechseln.

v1.2 enthält 5 Prompts:

`monthly-close`

Geführter Monatsabschluss. Der Agent überprüft offene Rechnungen, kategorisiert unzugeordnete Ausgaben, verifiziert, dass die steuerlichen Verpflichtungen des Zeitraums erfüllt sind, und generiert eine Zusammenfassung. Ein Workflow, der normalerweise eine Stunde manueller Überprüfung erfordert, wird in einer Konversation ausgeführt.

`onboard-client`

Onboarding eines neuen Kunden. Bestimmt den Steuersatz basierend auf dem Standort des Kunden (peninsulare IVA, kanarische IGIC, innergemeinschaftlich), erstellt den Datensatz mit den korrekten Steuerdaten und generiert ein Willkommensangebot. Alles in einer Sequenz.

`quarterly-tax-prep`

Vierteljährliche Steuererklärungsvorbereitung. Sammelt alle Rechnungen des Zeitraums, berechnet die Bemessungsgrundlagen für IVA oder IGIC, wendet die IRPF-Einbehaltungen an und generiert eine Vorschau des Modells 303 oder 130. Der Agent erledigt die Arbeit; Sie oder Ihr Steuerberater validieren das Ergebnis.

`overdue-followup`

Nachverfolgung überfälliger Rechnungen. Identifiziert alle überfälligen Rechnungen, gruppiert sie nach Kunden, berechnet den ausstehenden Gesamtbetrag pro Kunde und erstellt personalisierte Mahnungen. Von “ich muss prüfen, wer mir etwas schuldet” zu “hier sind die Entwürfe versandbereit”.

`expense-batch`

Stapelverarbeitung von Ausgaben. Erhält eine Liste von Ausgaben, kategorisiert sie gemäß den konfigurierten Regeln, wendet die entsprechenden Steuern an, überprüft die Abzugsfähigkeit jeder einzelnen und erstellt sie mit vorheriger Bestätigung. Ideal für die Verarbeitung gesammelter Belege einer Woche oder einer Reise.

Strukturierter Output: parsbarer Output

Bisher waren die Antworten des MCP-Servers formatierter Text. Nützlich für menschliches Lesen, aber Agenten benötigen strukturierte Daten, um programmatische Entscheidungen zu treffen.

v1.2 fügt outputSchema und structuredContent zu jedem Tool hinzu. Jede Antwort enthält ein JSON-Schema, das die Struktur der zurückgegebenen Daten genau beschreibt. Der Agent weiß vor dem Aufruf, welche Felder er empfangen wird, welchen Typ sie haben und welche optional sind.

Dies ermöglicht es einem Prompt wie quarterly-tax-prep, 4 Operationen zuverlässig zu verketten: Jeder Schritt erzeugt Daten mit einer bekannten Struktur, die der nächste Schritt eindeutig konsumieren kann.

Für Entwickler, die Integrationen auf dem MCP-Server aufbauen, entfällt dadurch die Notwendigkeit, freien Text zu parsen. Die Antwort hat immer die gleiche Form.

Sicherheitsanmerkungen

Jedes Tool des MCP-Servers enthält jetzt Anmerkungen, die anzeigen, ob die Operation schreibgeschützt oder destruktiv ist. Ein list-invoices ist als Leseoperation markiert. Ein delete-expense ist als destruktiv markiert.

Dies ermöglicht es den Agenten, Bestätigungsrichtlinien zu implementieren. Ein Agent kann Leseoperationen ohne Nachfrage ausführen, muss aber eine explizite Bestätigung anfordern, bevor er Daten löscht oder ändert. Die Sicherheit hängt nicht vom Agenten ab – sie wird vom Server definiert.

Universelle Installation

Der Server wird mit einem einzigen Befehl auf jedem kompatiblen Agenten installiert:

npx @frihet/mcp-server

Funktioniert mit Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex und jedem MCP-Client. Für Agenten, die die Installation über Skills unterstützen:

npx skills add Frihet-io/frihet-mcp

Beide Methoden ermöglichen den Zugriff auf über 30 Tools, die 5 Ressourcen, die 5 Prompts und den strukturierten Output.

Repository unter Frihet-io

Der MCP-Server wurde an die Organisation Frihet-io auf GitHub übertragen. Die Repository-URL ist jetzt github.com/Frihet-io/frihet-mcp. Die vorherigen Links leiten automatisch weiter.

Das npm-Paket ist weiterhin @frihet/mcp-server. Es gibt keine Änderungen bei der Installation.

Für wen ist dieses Update gedacht?

Professionelle Anwender, die den MCP-Server bereits nutzen, erhalten Ressourcen als automatischen Steuerkontext und Prompts als Workflows, die sie zuvor manuell Schritt für Schritt ausgeführt haben.

Entwickler, die auf Frihet aufbauen, erhalten strukturierten Output für deterministische Integrationen und Sicherheitsanmerkungen für Bestätigungsrichtlinien.

Buchhaltungsbüros und Steuerberater erhalten spezifische Prompts für ihre Workflows: Monatsabschluss, Quartalsvorbereitung, Nachverfolgung von Forderungen.

Jedes Unternehmen, das KI-Agenten nutzt, erhält einen MCP-Server, der nicht nur Operationen ausführt, sondern auch weiß, wie diese in realen Geschäftsprozessen verkettet werden.

So aktualisieren Sie

Wenn Sie npx @frihet/mcp-server verwenden, haben Sie bereits die neueste Version. Wenn Sie eine feste Installation haben:

npm update @frihet/mcp-server

Es gibt keine Breaking Changes. Alle bestehenden Tools behalten ihre Schnittstelle bei. Die Ressourcen, Prompts und der strukturierte Output sind reine Ergänzungen.

Die vollständige Dokumentation finden Sie unter docs.frihet.io/desarrolladores. Der Quellcode ist auf GitHub (Frihet-io/frihet-mcp). Das Paket ist auf npm als @frihet/mcp-server verfügbar.