MCP Server

Business OS als MCP Server für Claude Code, Claude Desktop und Agent SDK

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

Tool	Beschreibung
list_connections	Alle Banking-Connections auflisten
get_connection	Einzelne Connection abrufen
delete_connection	Connection löschen
list_accounts	Konten auflisten (optional gefiltert)
get_account	Einzelnes Konto abrufen
list_transactions	Transaktionen auflisten

Banking PIS

Tool	Beschreibung
create_payment	SEPA-Zahlung initiieren
list_payments	Zahlungen auflisten
get_payment	Zahlungsdetails abrufen

Sonstige

Tool	Beschreibung
get_webhook_url	Aktuelle Webhook URL abrufen
set_webhook_url	Webhook URL setzen
search_providers	Banken 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 + Skill	MCP Server
Setup	business-os init	.mcp.json konfigurieren
Wie Claude es nutzt	Bash-Tool (business-os ...)	Eigene MCP-Tools
Parameter	CLI-Flags	JSON Schema (typisiert)
Output	Text/JSON via stdout	Strukturiertes JSON
Empfohlen für	Schneller Einstieg, Scripting	Tiefe AI-Integration

Du kannst beide Ansätze parallel verwenden — sie nutzen denselben API Key.