Skip to main content

​
MCP Server

Der Business OS MCP Server stellt die Banking API als typisierte Tools für Claude Code, Claude Desktop und das Agent SDK bereit. Im Vergleich zur CLI bietet der MCP Server:
  • Strukturierte Tool-Definitionen mit JSON Schema
  • Automatische Parametererkennung durch Claude
  • Direkte Integration ohne Bash-Zwischenschritt

​
Setup

​
Claude Code

Füge folgendes in deine .mcp.json ein (im Projektverzeichnis oder ~/.claude/.mcp.json für global): 
{
  "mcpServers": {
    "business-os": {
      "command": "npx",
      "args": ["business-os", "mcp"],
      "env": {
        "BUSINESS_OS_API_KEY": "bo_xxxxx..."
      }
    }
  }
}
Ersetze bo_xxxxx... mit deinem API Key aus dem Dashboard.

​
Claude Desktop

Füge folgendes in deine Claude Desktop MCP-Konfiguration ein: 
{
  "mcpServers": {
    "business-os": {
      "command": "npx",
      "args": ["business-os", "mcp"],
      "env": {
        "BUSINESS_OS_API_KEY": "bo_xxxxx..."
      }
    }
  }
}

​
API Type

Standardmäßig wird die Partner API (regulierte Banken) verwendet. Für Open Banking: 
{
  "mcpServers": {
    "business-os": {
      "command": "npx",
      "args": ["business-os", "mcp"],
      "env": {
        "BUSINESS_OS_API_KEY": "bo_xxxxx...",
        "BUSINESS_OS_API_TYPE": "openbanking"
      }
    }
  }
}

​
Verfügbare Tools

Nach der Konfiguration stehen folgende Tools in Claude zur Verfügung:

​
Banking AIS

ToolBeschreibung
list_connectionsAlle Banking-Connections auflisten
get_connectionEinzelne Connection abrufen
delete_connectionConnection löschen
list_accountsKonten auflisten (optional gefiltert)
get_accountEinzelnes Konto abrufen
list_transactionsTransaktionen auflisten

​
Banking PIS

ToolBeschreibung
create_paymentSEPA-Zahlung initiieren
list_paymentsZahlungen auflisten
get_paymentZahlungsdetails abrufen

​
Sonstige

ToolBeschreibung
get_webhook_urlAktuelle Webhook URL abrufen
set_webhook_urlWebhook URL setzen
search_providersBanken nach Name suchen

​
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 vs. MCP

CLI + SkillMCP Server
Setupbusiness-os init.mcp.json konfigurieren
Wie Claude es nutztBash-Tool (business-os ...)Eigene MCP-Tools
ParameterCLI-FlagsJSON Schema (typisiert)
OutputText/JSON via stdoutStrukturiertes JSON
Empfohlen fürSchneller Einstieg, ScriptingTiefe AI-Integration
Du kannst beide Ansätze parallel verwenden — sie nutzen denselben API Key.