MCP Server

Der Hosted MCP Server stellt Business OS — Banking + DATEV — als typisierte Tools für KI-Agenten bereit, die außerhalb der Shell laufen: claude.ai, Cursor, Windsurf und das Agent SDK. Er läuft remote (kein lokaler Prozess, keine Installation) und authentifiziert jede Sitzung per OAuth 2.1.

Remote & stateless — funktioniert im Web, auf Mobile und in Cloud-Agenten
OAuth 2.1 + PKCE — pro Nutzer-Sitzung eigene Autorisierung
Strukturierte Tool-Definitionen mit JSON Schema
Voller Funktionsumfang — Banking (PSD2) und DATEV (DUO, Rechnungswesen Lesen/Schreiben)

Für Claude Code (Shell vorhanden) ist die CLI + Skill der einfachere Weg — business-os init bringt Claude die Befehle bei. Der Hosted MCP ist für Agenten ohne Shell gedacht.

Setup

Der Server wird als Custom Connector eingebunden. Server-URL:

https://mcp.business-os.de

claude.ai

Einstellungen → Connectors → Custom Connector hinzufügen
URL https://mcp.business-os.de eintragen und speichern
Beim ersten Verbinden öffnet sich die Business-OS-Autorisierungsseite — dort deinen API Key aus dem Dashboard einfügen und bestätigen
Die Tools stehen danach in jeder Unterhaltung zur Verfügung

Cursor / Windsurf

In der MCP-Konfiguration einen Remote-Server mit derselben URL (https://mcp.business-os.de) eintragen; der OAuth-Flow läuft identisch im Browser.

Es wird kein API Key in eine lokale Datei geschrieben — die Autorisierung läuft über den Browser-OAuth-Flow, und jede Sitzung erhält ihr eigenes Token.

Verfügbare Tools

Nach dem Verbinden stehen folgende Tools im Agenten zur Verfügung.

Banking AIS

Tool	Beschreibung
`list_connections`	Alle Banking-Connections auflisten
`get_connection`	Einzelne Connection abrufen
`delete_connection`	Connection löschen
`list_accounts`	Konten auflisten (inkl. aktuellem Saldo)
`get_account`	Einzelnes Konto abrufen
`list_balances`	Tägliche Saldenreihe eines Kontos
`list_transactions`	Transaktionen auflisten

Banking PIS

Tool	Beschreibung
`create_payment`	SEPA-Zahlung initiieren
`list_payment_templates`	Payment-Templates + unterstützende Provider
`list_payments`	Zahlungen auflisten
`get_payment`	Zahlungsdetails abrufen

Banking — Sonstige

Tool	Beschreibung
`get_webhook_url`	Aktuelle Webhook URL abrufen
`set_webhook_url`	Webhook URL setzen
`search_providers`	Banken nach Name suchen

DATEV — Allgemein & Unternehmen Online (DUO)

Tool	Beschreibung
`list_datev_companies`	Mandanten einer Verbindung (liefert companyId)
`list_duo_connections`	DUO-Verbindungen auflisten
`list_duo_belegtypen` / `list_duo_kassenbuecher` / `list_duo_rechnungsordner`	DUO-Stammdaten lesen
`upload_duo_beleg`	Beleg in DUO bereitstellen
`create_duo_kassenbuch_einfach` / `create_duo_kassenbuch_advanced`	Kassenbuch-Einträge anlegen
`create_duo_buchungsvorschlag`	Buchungsvorschlag anlegen

DATEV Rechnungswesen — Schreiben

Tool	Beschreibung
`list_rewe_connections`	ReWe-Write-Verbindungen auflisten
`list_rewe_belegtypen` / `list_rewe_steuersaetze`	Stammdaten lesen
`upload_rewe_beleg`	Beleg bereitstellen
`create_rewe_personenkonto`	Personenkonto anlegen (RVO „Rechnungsdatenservice 1.0”)
`create_rewe_buchung`	Buchung anlegen (RVO „Rechnungsdatenservice 1.0”)

DATEV Rechnungswesen — Lesen

Tool	Beschreibung
`list_rewe_read_connections`	ReWe-Read-Verbindungen auflisten
`get_rewe_read_permissions`	RVO-Rechte einer Verbindung prüfen
`list_rewe_read_geschaeftsjahre` / `get_rewe_read_geschaeftsjahr`	Geschäftsjahre
`get_rewe_read_kontenplan`	Kontenplan (Sachkonto-Nummern → Namen)
`get_rewe_read_susa`	Summen-und-Salden (SuSa / BWA)
`get_rewe_read_buchungsdaten`	Buchungsdaten (Journaleinträge)
`get_rewe_read_opos`	Offene Posten (Mahnwesen, Forderungen/Verbindlichkeiten)
`get_rewe_read_zahlungsbedingungen`	Zahlungsbedingungen

Beispiel-Interaktion

Nach der Konfiguration kannst du Claude direkt in natürlicher Sprache ansprechen:

User: Zeige mir alle Bankkonten der Musterbank

Claude: Nutzt list_connections → findet Musterbank (ID: 9182...)
        Nutzt list_accounts mit connection_id → zeigt 9 Konten mit IBANs und Salden

User: Wie hoch ist der Gesamtsaldo?

Claude: Berechnet aus den Account-Daten: 12.500,00 EUR

User: Überweise 500€ von DE89... an Mustermann GmbH, DE27...

Claude: Nutzt create_payment → gibt Widget-URL zurück
        "Bitte öffne diesen Link um die Zahlung per TAN zu autorisieren: ..."

Tool-Parameter

`create_payment`

{
  "provider_code": "musterbank_oauth_client_de",
  "template_identifier": "SEPA",
  "creditor_name": "Mustermann GmbH",
  "creditor_iban": "DE27100777770209299700",
  "debtor_iban": "DE89370400440532013000",
  "amount": "500.00",
  "end_to_end_id": "RE-2026-001",
  "currency_code": "EUR",
  "description": "Rechnung RE-2026-001",
  "custom_fields": {
    "invoice_id": "RE-2026-001"
  }
}

`list_transactions`

{
  "connection_id": "9182736450918273645",
  "account_id": "8273645091827364509",
  "from_date": "2026-01-01",
  "to_date": "2026-03-24"
}

CLI + Skill vs. Hosted MCP

Beide sprechen dasselbe API an — die Wahl hängt davon ab, wo der Agent läuft.

	CLI + Skill	Hosted MCP
Läuft	lokal, in der Shell (Claude Code, CI)	remote (claude.ai, Cursor, Windsurf, Agent SDK)
Setup	`business-os init`	Custom Connector auf `mcp.business-os.de`
Auth	API Key lokal / Env-Var	OAuth 2.1 pro Sitzung (Browser)
Wie der Agent es nutzt	Bash-Tool (`business-os …`)	typisierte MCP-Tools
Empfohlen für	Terminal, Scripting, Claude Code	Cloud-/Web-Agenten ohne Shell

Beide Oberflächen sind unabhängige Clients desselben REST-API und decken denselben Funktionsumfang ab (Banking + DATEV) — keine wrappt die andere.

​MCP Server

​Setup

​claude.ai

​Cursor / Windsurf

​Verfügbare Tools

​Banking AIS

​Banking PIS

​Banking — Sonstige

​DATEV — Allgemein & Unternehmen Online (DUO)

​DATEV Rechnungswesen — Schreiben

​DATEV Rechnungswesen — Lesen

​Beispiel-Interaktion

​Tool-Parameter

​create_payment

​list_transactions

​CLI + Skill vs. Hosted MCP

MCP Server

Setup

claude.ai

Cursor / Windsurf

Verfügbare Tools

Banking AIS

Banking PIS

Banking — Sonstige

DATEV — Allgemein & Unternehmen Online (DUO)

DATEV Rechnungswesen — Schreiben

DATEV Rechnungswesen — Lesen

Beispiel-Interaktion

Tool-Parameter

`create_payment`

`list_transactions`

CLI + Skill vs. Hosted MCP