Claude Code
Diese Seite richtet den Server in Claude Code ein: als lokalen Server, als Plugin sevdesk mit
seinem Buchhaltungs-Skill oder verbunden mit einem Server, den du selbst betreibst. Die anderen
Clients findest du unter Clients.
Was funktioniert
- Werkzeuge und Prompts. Die Prompts des Servers erscheinen im
/-Menü als/sevdesk:month_end_close (MCP);/mcp__sevdesk__month_end_close 2026-10führt einen mit einem Argument aus. Mit/mcpsiehst du den Server und seine Werkzeuge. - Bestätigungen erscheinen in interaktiven Sitzungen als Dialog, mit der Voreinstellung
SEVDESK_CONFIRM=elicit(Bestätigungsarten). Im Print-Modus (claude -p) kann niemand antworten: Verwende Probeläufe oderSEVDESK_CONFIRM=browser. - Fernzugriff: OAuth und Bearer-Modus funktionieren beide (Fernzugriff einrichten).
Lokal einrichten
Claude Code braucht Node.js 22.12 oder neuer für npx. Trage den Server für alle deine Projekte
ein (--scope user), mit dem Token aus dem Schlüsselbund:
npx -y mcp-server-sevdesk token set workclaude mcp add --env SEVDESK_API_TOKEN_KEYCHAIN=work --scope user sevdesk -- npx -y mcp-server-sevdeskWeitere Einstellungen sind weitere --env NAME=value-Optionen vor --scope. Alles nach -- ist
der Befehl, den Claude Code ausführt. Den Schlüsselbund erklärt
Profile und Schlüsselbund.
In die gemeinsame .mcp.json eines Projekts gehört nie ein Token. Verweise stattdessen auf eine
Variable, die Claude Code aus der Umgebung einsetzt, in der es gestartet wurde; jede Person
exportiert dann die Bezeichnung ihres eigenen Schlüsselbund-Eintrags:
{ "mcpServers": { "sevdesk": { "command": "npx", "args": ["-y", "mcp-server-sevdesk"], "env": { "SEVDESK_API_TOKEN_KEYCHAIN": "${SEVDESK_API_TOKEN_KEYCHAIN}" } } }}Das Plugin
Das Repository ist zugleich ein Plugin-Marktplatz für Claude Code. Das Plugin sevdesk startet
diesen Server und bringt einen Buchhaltungs-Skill mit: deutsche Steuerregeln und die passenden
Steuerregeln in sevDesk (einschließlich §13b Reverse Charge und §19 Kleinunternehmer), gängige
SKR03- und SKR04-Konten, GoBD, die E-Rechnungspflichten und Abläufe Schritt für Schritt für
Belege, E-Rechnungen, den Bankabgleich, die Umsatzsteuer-Vorprüfung, den Monats- und
Jahresabschluss.
/plugin marketplace add jaylann/mcp-server-sevdesk/plugin install sevdesk@mcp-server-sevdeskAb Claude Code 2.1.275 genügt ein Schritt:
/plugin install sevdesk --marketplace jaylann/mcp-server-sevdesk.
Das Plugin startet das Release, zu dem es gehört (npx -y mcp-server-sevdesk@<version>), damit
nie eine neue npm-Version läuft, bevor du das Plugin aktualisierst. Es übergibt die
SEVDESK_*-Variablen der Umgebung, in der Claude Code gestartet wurde, zum Beispiel aus deinem
Shell-Profil. Es braucht mindestens eine Token-Variable und bleibt nur lesend, solange du
SEVDESK_ALLOW nicht setzt:
export SEVDESK_API_TOKEN_KEYCHAIN=work # oder SEVDESK_API_TOKEN / SEVDESK_API_TOKEN_FILEexport SEVDESK_ALLOW=write # optional; ohne die Variable nur lesendDas Plugin übergibt jede Variable, die nicht verwendeten kommen also leer an; ein leerer Wert gilt als nicht gesetzt (Konfiguration).
Fernzugriff einrichten
Verbinde Claude Code mit einem Server, den du im Fernzugriff betreibst. Der
MCP-Endpunkt ist immer <public URL>/mcp.
Mit OAuth:
claude mcp add --transport http sevdesk https://<host>/mcpFühre dann /mcp in Claude Code aus und wähle die Authentifizierung: Die Zustimmungsseite öffnet
sich in deinem Browser und leitet dich zu Claude Code zurück. Claude Code weist sich mit einem
eigenen Metadaten-Dokument aus, das wie das von claude.ai unter claude.ai liegt (der Standardwert
von SEVDESK_OAUTH_CLIENTS deckt es also ab), und mit einer Loopback-Weiterleitung, auf die die
Zustimmungsseite hinweist.
Mit einem Bearer-Geheimnis (lies es aus einer Datei oder deinem Passwortmanager, statt es einzutippen):
claude mcp add --transport http sevdesk https://<host>/mcp \ --header "Authorization: Bearer $MCP_BEARER_SECRET"Welchen Modus du wählst: Bearer oder OAuth. Über HTTP braucht
eine Bestätigung im Chat außerdem einen Client, der das Protokoll 2026-07-28 mit
Formular-Elicitation spricht; sonst setzt du SEVDESK_CONFIRM=browser auf dem Server und gibst in
seinem Freigabe-Postfach frei.
Stolperfallen
- Shell-Historie. Vermeide
--env SEVDESK_API_TOKEN=<token>auf der Kommandozeile: Das Token bleibt sonst in deiner Shell-Historie. Verwende den Schlüsselbund oder eine Token-Datei. - Der Print-Modus kann keine Bestätigungen beantworten (siehe Was funktioniert).
- Plugin-Einstellungen kommen aus der Umgebung, in der Claude Code gestartet wurde, nicht aus einer Konfigurationsdatei: Starte Claude Code neu, nachdem du dein Shell-Profil geändert hast.