MCP · OAuth 2.1 · Streamable HTTP · Made in Germany

Boniforce MCP Connector für Claude und kompatible KI-Clients

Fragen Sie Ihren KI-Assistenten — erhalten Sie Boniscore (0–100), Kreditlimit in Euro, ein klares Ampelsystem und die aktuelle Branchen-Lage — direkt im Chat. Kein Tabwechsel, kein Copy-Paste.

✓In wenigen Schritten verbunden — Connector-URL einfügen, API-Key einsetzen, fertig.
✓Aktueller Tool-Katalog: Boniforce-Kreditdaten und Sectorbench-Brancheninformationen.
✓Pro Nutzer eigener Boniforce-API-Key — Daten sauber isoliert, jederzeit widerrufbar.

Mit Claude verbinden → ChatGPT-Verfügbarkeit prüfen →

Claude.ai Claude Desktop ChatGPT: registrierte App erforderlich OAuth 2.1 + PKCE DSGVO-konform Server in Deutschland ★ Open Source · GitHub

Claude · Boniforce MCP CONNECTED

mcp.boniforce.de

v0.4.0 · Streamable HTTP · OAuth 2.1

CALL create_report(„Müller GmbH“)

Tool Arguments

company_name„Müller GmbH“

register_type„HRB“

register_number„12345“

Response · Tool Result Hintergrundjob · Status bis zum fertigen Report

{

„company_name“: „Müller GmbH“,

„score“: 82,

„credit_limit“: 12000,

„recommendation“: „Freigabe“,

„sector_branch“: „construction“,

„sector_score“: 61

}

Tools (7 Boniforce + 9 Sectorbench)

OAuth 2.1

PKCE + DCR · keine geteilten Secrets

Dokumentiert

Setup-Schritte für Connector und API-Key

Funktioniert in

Claude.ai und Claude Desktop sind in der aktuellen Projektdokumentation beschrieben. Weitere MCP-fähige Clients benötigen passenden OAuth-Connector-Support. Für ChatGPT ist eine verfügbare registrierte Boniforce-App erforderlich; das direkte MCP-Paket ist laut aktueller Dokumentation Desktop-only.

Das Problem

Bonitätsprüfung passiert im falschen Fenster

Sie tippen die Frage in den Chat, aber für die Antwort brauchen Sie Browser, Login, Suchmaske, Copy-Paste — und am Ende landen die Zahlen doch wieder im Chat.

Ohne Connector

Mit Boniforce MCP

„Wie steht Müller GmbH?“

Tabwechsel → Boniforce-Login → Suchen → Bericht öffnen

Fertiger Report erscheint nach Abschluss im Chat

„Plus Branchen-Lage Bau?“

Zweiter Tab, Destatis durchklicken, ifo-Index googeln

Score, Trend, Insolvenzen — eine Frage

„Mail an den Kunden tippen“

Zahlen abtippen, Konjunktiv formulieren

KI tippt die Mail mit den Zahlen im Kontext

Team-Setup

Jeder muss Boniforce-UI lernen

URL teilen, jeder klebt seinen Key ein

Setup · Pro Nutzer

In wenigen Schritten verbunden — eigener API-Key bleibt eigener API-Key

Der MCP-Connector validiert Ihren Boniforce-API-Key gegen api.boniforce.de, verschlüsselt ihn dann at-rest (Fernet) und bindet ihn an Ihre Anthropic-/OpenAI-Identität. Ihre Kolleg:innen pflegen ihre eigenen Keys — kein Sharing, klare Audit-Trails.

1
API-Key im Boniforce-Dashboard erstellen dashboard.boniforce.de → API-Schlüssel → „Neuen Schlüssel erstellen“ — Name z. B. claude oder chatgpt. Format: sk_live_…
2
Connector-URL in den KI-Client einfügen Claude: Settings → Connectors → Add custom connector. ChatGPT: nur über eine verfügbare registrierte Boniforce-App; das direkte MCP-Paket ist laut aktueller Dokumentation Desktop-only.
3
OAuth-Login: API-Key einsetzen Es öffnet sich ein Browser-Tab auf mcp.boniforce.de/oauth/login. Einmalig den sk_live_… einfügen — der Connector validiert + verschlüsselt ihn.
4
Im Chat fragen „Erstelle einen Boniforce-Bericht für Müller GmbH und vergleich mit der Lage der Branche Bau.“ — Claude/ChatGPT ruft die richtigen Tools selbst auf.

Sicherheits-Hinweis

Der API-Key wird ausschließlich serverseitig auf mcp.boniforce.de gespeichert (Fernet/AES-128 verschlüsselt). Anthropic und OpenAI bekommen den Key nicht zu sehen — sie bekommen nur einen OAuth-Token, der den Nutzer identifiziert. Widerruf jederzeit im Boniforce-Dashboard; der Connector verliert sofort den Zugriff.

API-Key holen → Quellcode auf GitHub

claude.ai / chat

Connector aktiv Boniforce MCP · aktueller Tool-Katalog

+ Frage stellen

search_companies

Müller GmbH

HRB 12345 · München

create_report

Hintergrundjob · typischerweise etwa 120s bis zum fertigen Report

Boniscore 82 · APPROVE

get_branch

construction

Score 61 · trend ↓

get_branch_news

Bau · Mai 2026

Briefing eingebettet

📘 Connector-Doku

Dieser Seite — plus FAQ und Code-Beispiele weiter unten.

🔐 Widerruf

API-Key im Boniforce-Dashboard sperren — Connector verliert sofort den Zugriff.

Zwei Daten-Quellen, ein Connector

Bonitätsprüfung und Branchen-Intelligenz

Der MCP-Connector exponiert zwei Datensätze. Boniforce-Tools brauchen Ihren persönlichen API-Key. Sectorbench läuft auf einem Operator-Token — keine zusätzliche Anmeldung.

🏢

Boniforce — Firmen-Bonität

Per-Nutzer-Authentifizierung mit dem persönlichen sk_live_… Key. Alle Aufrufe gehen verschlüsselt an api.boniforce.de und liefern aktuelle Bundesanzeiger-Daten.

✓ Boniscore 0–100 + Ampel
✓ Kreditlimit in Euro
✓ Bilanz-Verlauf (Eigenkapital, Verbindlichkeiten…)
✓ Per-Jahr-Kennzahlen + Sub-Scores

📈

Sectorbench — Branchen-Lage

Operator-Token im Hintergrund — Nutzer brauchen keinen Sectorbench-Account. Quellen: Destatis (Insolvenzen), ifo, S&P Global PMI, Eurostat, Bundesbank.

✓ 10 deutsche Branchen, Score 0–100
✓ 12–24 Monate Score-Verlauf
✓ Monatliches KI-Briefing pro Branche
✓ Destatis-Insolvenzen + Einzel-Indikatoren

Setup-Snippets

Setup für Claude; ChatGPT nach veröffentlichter App-Verfügbarkeit

Drei Standard-Wege, den Connector hinzuzufügen. Wähle den Client.

Claude.ai Claude Desktop ChatGPT MCP Inspector

# Claude.ai (Pro / Max / Team / Enterprise)
# Settings → Connectors → Add custom connector

URL:  https://mcp.boniforce.de/mcp
Auth: OAuth (Auto-Discovery)

# → Browser-Tab öffnet sich auf mcp.boniforce.de/oauth/login
# → Boniforce-API-Key (sk_live_…) einfügen
# → Der aktuelle Tool-Katalog erscheint in der Seitenleiste

Claude.ai Claude Desktop ChatGPT MCP Inspector

# ChatGPT
# Kundennutzung erst nach Verfügbarkeit einer registrierten Boniforce-App.
# Das direkte MCP-Paket ist laut aktueller Projektdokumentation Desktop-only.
# Konto-, Workspace- und Regionsfreigaben im jeweiligen Client prüfen.

Claude.ai Claude Desktop ChatGPT MCP Inspector

# MCP Inspector (Debugging / Selbsttest)
$ npx @modelcontextprotocol/inspector https://mcp.boniforce.de/mcp

# → OAuth-Flow durchlaufen, API-Key einsetzen
# → tools/list zeigt den aktuellen Tool-Katalog mit Annotations

Tool-Katalog

Auswahl dokumentierter Tools, die Ihr KI-Assistent passend auswählt

Sie fragen in Alltagssprache — das Modell entscheidet, welches Tool es aufruft. Die vollständige aktuelle Liste steht in der verlinkten GitHub-Dokumentation.

🏢 Boniforce — Firmen-Bonität

search_companies — Firma finden
create_report — Bericht starten
get_report — Boniscore + Kreditlimit
get_job_status — Long-Polling
list_reports — frühere Berichte
get_report_financial_data — Bilanz-Verlauf
get_report_financial_analysis — Kennzahlen + Sub-Scores

📈 Sectorbench — Branchen-Lage

list_branch_scores — alle 10 Branchen
get_branch_ranking — Ranking + Delta
get_branch — Branchen-Score + Risk
get_branch_history — 1–24 Monate
get_branch_news — monatliches KI-Briefing
get_branch_insolvency_history — Destatis 1–36 Monate
get_branch_indicator_history — ifo / PMI / ZEW…
list_branch_indicators — Indikator-Katalog
get_sectorbench_meta — Daten-Aktualität

Anwendungsfälle

Was Vertrieb, Credit-Management und M&A im Chat machen

💼

B2B-Vertrieb · Lead-Qualifizierung

Ein Lead schreibt rein. Vertrieb fragt im Chat: „Lead Müller GmbH — Boniscore + Sektor.“ Nach dem fertigen Report folgt der Vorschlag zum nächsten Schritt.

search_companies → create_report → get_branch → Antwort im Chat

Tool-Sequenz · vom Modell automatisch

⚖️

Credit-Controlling · Limit-Review

Quartalsweise Review der Top-Kunden. Im Chat: „Vergleich Eigenkapitalquote der letzten 3 Jahre — und wie steht die Branche?“

list_reports → get_report_financial_analysis → get_branch_history

Tool-Sequenz · plus KI-Zusammenfassung

🔎

M&A · Due-Diligence-Briefing

Vor dem Erstgespräch: „Brief mich kurz auf die Solar Bau GmbH — Bonität, Bilanz-Trend, plus Lage Erneuerbare Energien.“

search_companies → create_report → get_report_financial_data → get_branch_news

Tool-Sequenz · Dauer abhängig vom Report-Status

FAQ

Häufige Fragen zum MCP-Connector

Auth, Datenschutz, Pricing, Tier-Support.

Was ist der Unterschied zur REST API?

Die REST API ist der Server-zu-Server-Weg — die dokumentierte Server-zu-Server-Basis. Eine konkrete ERP-, CRM-, Shopware- oder Salesforce-Anbindung erfordert eine Prüfung von Systemversion, API-Zugang, Feldern und Workflow. Der MCP-Connector ist die Variante für KI-Assistenten: Claude und andere kompatible Clients rufen die Tools auf. Für ChatGPT ist eine verfügbare registrierte Boniforce-App erforderlich. Die Laufzeit wurde hier nicht getestet.

Brauche ich für den Connector einen neuen Account?

Nein. Ihr bestehender sk_live_… aus dem Boniforce-Dashboard reicht. Wenn Sie noch keinen haben: dashboard.boniforce.de → API-Schlüssel → „Neuen Schlüssel erstellen“.

Bekommt Anthropic / OpenAI meinen API-Key zu sehen?

Nein. Der Key wird ausschließlich auf mcp.boniforce.de gespeichert (Fernet/AES-128 verschlüsselt at rest). Anthropic und OpenAI erhalten nur einen kurzlebigen OAuth-Token (RS256-JWT, 1h gültig, audience-gebunden an die MCP-URL). Die Tools rufen den eigentlichen Key serverseitig nach Identifizierung des Nutzers ab.

Wird mein Chat-Verlauf an Boniforce gesendet?

Nein. Der Connector erhält ausschließlich die strukturierten Argumente, die das KI-Modell für den Tool-Aufruf wählt — z. B. Firmenname, Registernummer, Branchenschlüssel. Freitext-Chat-Inhalte verlassen Anthropic/OpenAI nicht.

Was kostet der Connector?

Der Connector selbst ist kostenlos. Es werden nur die regulären Boniforce-Credits Ihres Plans verbraucht — create_report verbraucht ein Credit pro Live-Bericht (gleich wie über die REST API). Sectorbench-Aufrufe sind im Plan enthalten und verbrauchen keine Boniscore-Credits.

Funktioniert es auf Free-Claude oder Free-ChatGPT?

Für Claude nennt die aktuelle Projektdokumentation Pro, Max, Team und Enterprise. Für ChatGPT ist die Boniforce-App-Verfügbarkeit noch nicht allgemein belegt; sie hängt von Veröffentlichung sowie Konto-, Workspace- und Regionsfreigaben ab. Free-Plan-Support ist nicht verifiziert.

Wie lange dauert ein Bericht?

Ein neuer Report ist typischerweise nach etwa 120 Sekunden fertig. create_report startet zunächst einen Hintergrundjob; die erste Antwort bzw. der Job-Status ist noch nicht der fertige Report. Das Modell prüft den Status und meldet, sobald der Report abgeschlossen ist.

Kann mein Team einen Connector teilen?

Ja. Jede:r im Team fügt dieselbe URL https://mcp.boniforce.de/mcp im eigenen Claude- oder ChatGPT-Account hinzu und setzt seinen eigenen Boniforce-Key ein. Daten sind per sha256(api_key) isoliert — keine gemeinsamen Sitzungen.

Wie widerrufe ich den Zugriff?

Im Boniforce-Dashboard den API-Key sperren oder rotieren — der Connector verliert sofort den Zugriff. Optional kann der OAuth-Datensatz auf Anfrage gelöscht werden.

Ist der Connector Open Source?

Ja — Quellcode unter MIT-Lizenz auf github.com/Caohung77/boniforce-mcp. Self-Hosting ist via Docker-Compose dokumentiert; eigene OAuth-Issuer und private Routing-Setups sind möglich.

Open Source · MIT

Quellcode auf GitHub — Self-Hosting möglich

Der MCP-Connector ist vollständig Open Source. Self-Host für private Routing-Setups, eigene OAuth-Issuer, Air-Gapped-Umgebungen — der Docker-Compose-Setup ist im Repository dokumentiert.

github.com