Deine Buchhaltung, direkt im KI‑Assistenten.
Dieser Server verbindet Office Freund Faktura mit KI-Programmen, die das Model Context Protocol sprechen. Dein Assistent liest damit Mandanten, Kunden und Artikel und legt neue an.
https://staging-mcp-faktura.officefreund.de/mcp
Kein API-Schlüssel — die Anmeldung läuft über dein Office-Freund-Konto.
In drei Schritten verbunden.
Der Ablauf ist überall gleich: Adresse eintragen, anmelden, erlauben.
-
Adresse eintragen
Die Adresse oben in dein KI-Programm einfügen — als MCP-Server oder Connector.
-
Im Portal anmelden
Es öffnet sich das Office-Freund-Kundenportal. Melde dich an wie gewohnt.
-
Zugriff erlauben
Ein Klick auf „Erlauben“. Das Programm merkt sich die Verbindung.
Claude Code
Terminal
- Den Befehl im Terminal ausführen.
- In Claude Code
/mcpaufrufen. - Der Browser öffnet das Kundenportal — anmelden und erlauben.
$ claude mcp add --transport http faktura \
https://staging-mcp-faktura.officefreund.de/mcpClaude Chat
claude.ai und Desktop-App
- Einstellungen → Connectors öffnen.
- Custom connector hinzufügen wählen.
- Name
Faktura, darunter die Adresse einfügen. - Anmelden und erlauben.
https://staging-mcp-faktura.officefreund.de/mcpChatGPT
Browser und App
- Einstellungen → Connectors öffnen.
- Unter Erweitert den Entwicklermodus einschalten.
- Create wählen und die Adresse als MCP-Server eintragen.
- Anmelden und erlauben.
Eigene Connectors gibt es nur in den kostenpflichtigen Plänen.
https://staging-mcp-faktura.officefreund.de/mcpCodex
Terminal
- Den Eintrag in
~/.codex/config.tomlergänzen. - Codex neu starten.
- Beim ersten Zugriff anmelden und erlauben.
[mcp_servers.faktura]
url = "https://staging-mcp-faktura.officefreund.de/mcp"Antigravity
Editor
- Einstellungen → MCP Servers öffnen.
- Add server wählen oder die
mcp_config.jsondirekt bearbeiten. - Beim ersten Zugriff anmelden und erlauben.
{
"mcpServers": {
"faktura": {
"serverUrl": "https://staging-mcp-faktura.officefreund.de/mcp"
}
}
}Weitere KI-Programme
Cursor, Windsurf, VS Code, Zed …
Alles, was MCP über Streamable HTTP beherrscht, funktioniert. Trag die Adresse
in die MCP-Konfiguration des Programms ein — meist eine mcp.json.
Kein Schlüssel in der Konfiguration: die Anmeldung läuft über OAuth 2.1 mit PKCE.
{
"mcpServers": {
"faktura": {
"type": "http",
"url": "https://staging-mcp-faktura.officefreund.de/mcp"
}
}
}Einfach sagen, was du brauchst.
Sätze wie diese versteht dein Assistent, sobald die Verbindung steht.
Welche Mandanten habe ich?
Listet alle Firmen, für die du buchen darfst.
Leg die Bäckerei Kern als Kunden an, Hauptstr. 12 in 50667 Köln.
Legt den Kunden an und vergibt die nächste freie Debitorennummer.
Was kostet bei uns die Montagestunde netto?
Schlägt den Artikel nach — mit Preis, Steuersatz und Lohnanteil.
Ändere bei Müller Bau das Zahlungsziel auf 30 Tage.
Aktualisiert die Kundenstammdaten.
Zeig mir alle Kunden aus Köln.
Durchsucht die Kundenliste nach Ort, Name oder Nummer.
Trag einen neuen Artikel ein: Wartungspauschale, 149 € netto, 19 %.
Legt den Artikel mit Steuersatz und Erlöskonto an.
Häufige Fragen
Was ist ein MCP-Server überhaupt?
Das Model Context Protocol ist ein offener Standard, über den KI-Programme auf fremde Systeme zugreifen. Dieser Server stellt deine Faktura-Daten darüber bereit — dein Assistent kann sie lesen und Einträge anlegen, ohne dass du etwas installierst.
Brauche ich einen API-Schlüssel?
Nein. Die Anmeldung läuft über OAuth 2.1 mit PKCE gegen dein Office-Freund-Konto. Dein Programm schickt dich einmal ins Kundenportal, du erlaubst den Zugriff, fertig. In keiner Konfigurationsdatei stehen Zugangsdaten.
Welche Daten sieht mein Assistent?
Genau die Mandanten, für die dein Konto berechtigt ist — dieselben Regeln wie im Portal. Angebunden sind heute Mandanten, Kunden und Artikel. Rechnungen und Zahlungen kommen als Nächstes dazu.
Wie beende ich die Verbindung wieder?
Im Office-Freund-Kundenportal widerrufst du die Erlaubnis. Danach greift kein Programm mehr zu — an der Konfiguration musst du nichts ändern.
Technische Details
MCP über Streamable HTTP unter
https://staging-mcp-faktura.officefreund.de/mcp. Der Server ist eine reine
Ressource: ohne gültiges Bearer-Token antwortet er mit 401 und verweist per
WWW-Authenticate auf seine Metadaten.
Dein Programm findet den Anmeldeserver über
/.well-known/oauth-protected-resource/mcp (RFC 9728); dessen eigene
Metadaten liegen nach RFC 8414 beim Faktura-Backend. Für Monitoring gibt es
/health.