MCP-Connector

FirmenData für Claude

Deutsche Unternehmen, Finanzdaten, Eigentümer und Originaldokumente — direkt aus Claude heraus.

Funktionsumfang

Der FirmenData-MCP-Server verbindet Claude mit dem deutschen Unternehmens- und Handelsregister. Aus jedem Claude-Chat heraus können Sie Millionen deutscher Unternehmen mit firmographischen Filtern durchsuchen, mehrjährige GuV- und Bilanzdaten abrufen, die chronologische Registerhistorie anzeigen, Gesellschafterlisten einsehen, die wirtschaftlich Berechtigten für KYC ermitteln und Original-Registerdokumente als presigned URLs herunterladen.

Alle Tools sind dünne Wrapper um dieselben Service-Funktionen, die unsere öffentliche REST-API antreiben — MCP- und REST-Aufrufe sehen exakt dieselben Daten.

Einrichtung

FirmenData-Konto erstellen. Registrieren Sie sich unter firmendata.com/signup. Sie benötigen einen aktiven Tarif mit API-Zugang — siehe Preise.
In Claude öffnen: Einstellungen → Connectors.
FirmenData-Connector hinzufügen. Wählen Sie einen der beiden Wege:
Variante A — Eigener Connector (jetzt verfügbar)
Im Connectors-Bereich auf Eigenen Connector hinzufügen klicken und die untenstehende Server-URL einfügen. Das ist der heute unterstützte Weg und funktioniert mit jedem Claude-Konto mit Zugriff auf eigene Connectors.
```
https://mcp.firmendata.com/mcp
```
Variante B — Claude Connectors Directory (demnächst)
Demnächst verfügbar
Sobald FirmenData im offiziellen Claude Connectors Directory veröffentlicht ist, lässt sich der Connector mit einem Klick direkt aus dem Directory installieren — ohne URL-Eingabe. Wir arbeiten am Listing; bis dahin bitte Variante A nutzen.
Autorisieren. Claude leitet zur OAuth-2.1-Einwilligung auf FirmenData (Auth0) weiter. Melden Sie sich mit dem Konto aus Schritt 1 an und genehmigen Sie den Zugriff.
Loslegen. Fragen Sie Claude nach einem beliebigen deutschen Unternehmen. Der Connector stellt 7 Tools bereit (siehe Tool-Referenz).

Authentifizierung

Der Server verwendet OAuth 2.1 mit PKCE (S256) über Auth0. Claude erkennt den Autorisierungsserver automatisch anhand der Protected Resource Metadata unter /.well-known/oauth-protected-resource. Eine manuelle Konfiguration von Client-IDs oder Redirect-URIs ist nicht erforderlich.

Das OAuth-Token ist an das FirmenData-Konto gebunden, das den Connector autorisiert hat. Alle Tool-Aufrufe werden diesem Konto in Rechnung gestellt und gegen dessen Rate Limits geprüft.

Tool-Referenz

Der Server stellt 7 Tools bereit. Alle unternehmensbezogenen Tools erwarten eine eu_id (FirmenData-Unternehmenskennung, z. B. DEF1103R.HRB279792B); rufen Sie zuerst autocomplete_companies oder search_companies auf, um einen Namen in eine eu_id aufzulösen.

autocomplete_companies

Schlanke Namensvorschläge zur Auswahl der richtigen Entität

Bis zu 25 Treffer für ein Namensfragment (≥3 Zeichen). Liefert gerade genug Kontext (Name + Registerreferenz) zur Abgrenzung. Vor jedem anderen Tool zu verwenden, wenn der Nutzer einen ungenauen Namen angibt.

search_companies

Filtersuche im deutschen Handelsregister mit Cursor-Pagination

Filter nach Name, eu_id, Registernummer/-art/-gericht, Stadt, Bundesland, Gründungsdatums-Bereich, Umsatz-/Gewinn-/Mitarbeiterzahl-Bereichen, WZ-2025-Codes, übergreifendem Industry-Slug, Rechtsform, Vorstands- oder Gesellschaftername, CPV-Beschaffungscode und Durchschnittsgeburtsjahr-Bereich. Bis zu 50 Treffer pro Seite; total_approx ist bei 10.000 gedeckelt — bei exaktem Bedarf Filter enger setzen.

get_company

Vollständiges Detailprofil eines Unternehmens per eu_id

Identität, Geschäftssitz, Registerreferenz, Kennzahlen, Geschäftsführung, Beteiligungsgraph, Kontakt, Insolvenzstatus, AI-Insights und die Liste der herunterladbaren Registerdokumente. fetch_realtime=true aktualisiert den Register-Snapshot live aus den deutschen Registern vor der Antwort.

get_company_history

Chronologische Registerhistorie eines Unternehmens

Aggregierte Zeitleisten für jede Art Änderung — Firma, Sitz, Kapital, Vorstandsmitglieder, Unternehmensgegenstand etc. Enthält einen abgeleiteten current_board-Snapshot. fetch_realtime=true aktualisiert die chronologische Registerhistorie live aus den deutschen Registern vor der Antwort.

get_company_financials

Mehrjährige GuV, Bilanz, Mitarbeiterzahl und Konzernstruktur

Jährliche Top-Line-Kennzahlen, strukturierte GuV, Bilanzposten (AKTIVA / PASSIVA), Mitarbeiter-Zeitreihe, Konzernbeziehungen (Mutter / Tochter) und die Liste der eingereichten Bilanzen (Jahresabschluss / Konzernabschluss).

get_company_shareholders

Aktuelle Gesellschafterliste (Cap Table) einer GmbH oder UG

Abdeckungsstatus (available, not_applicable für Rechtsformen ohne Gesellschafterlisten oder not_filed, wenn erwartet aber fehlend) plus Liste der Gesellschafter mit Anteilszahl, -prozentsatz und -klasse. fetch_realtime=true scrapt die Liste der Gesellschafter (oder als Fallback das Musterprotokoll) und parst sie vor der Antwort neu.

get_company_ubo

Wirtschaftlich Berechtigte nach §3 GwG (Alles-oder-Nichts-Regel)

Durchläuft die Beteiligungskette des Unternehmens und identifiziert die natürlichen Personen, die letztlich davon profitieren. Liefert den Beteiligungsgraph (Knoten + Kanten), wirtschaftlich Berechtigte mit >25 % effektivem Anteil, potenzielle wirtschaftlich Berechtigte (ungelöste Organisationen, die einen UBO verbergen könnten) und einen Abdeckungsstatus. fetch_realtime=true ruft die Liste der Gesellschafter für jede besuchte deutsche GmbH/UG in der Kette neu ab, bevor der Graph erstellt wird — für KYC-Workflows, in denen die frischestmögliche Kette zählt.

Beispiel-Prompts

Beliebigen dieser Prompts in Claude einfügen, nachdem der Connector aktiviert ist — Claude wählt automatisch die passenden Tools.

M&A-Targetscreening

„Finde profitable deutsche Fertigungs-GmbHs mit 20–100 Mio. € Umsatz, 50–1.500 Mitarbeitern und einem Jahresüberschuss zwischen 10 und 15 Mio. €, sortiert nach Gewinn.“

M&A-Target-Tiefenanalyse

„Erstelle ein vollständiges Profil zur n8n GmbH — 3 Jahre GuV und Bilanz, aktuelle Eigentümerstruktur, Historie der Kapitalerhöhungen und Zeitleiste der Satzungsänderungen.“

KYC / Prüfung wirtschaftlich Berechtigter

„Wir onboarden die Cloudfleet GmbH (Berlin). Durchlaufe die Beteiligungskette zu den wirtschaftlich Berechtigten über 25 %, markiere ungelöste Gesellschafter-Organisationen und nutze Live-Registerdaten.“

Wettbewerbs-Benchmarking

„Zeige die größten profitablen Software-GmbHs in Berlin mit 30–100 Mio. € Umsatz — liste Umsatz, Jahresüberschuss und Sitz, sortiert nach Umsatz.“

Preise & Rate Limits

Jeder erfolgreiche Tool-Aufruf zieht Credits von Ihrem FirmenData-Konto ab. Fehlgeschlagene Aufrufe (4xx / 5xx und Rate-Limit-Ablehnungen) sind kostenlos — Sie zahlen nur für tatsächlich gelieferte Daten. Credits sind mit der öffentlichen REST-API geteilt, sodass MCP- und REST-Nutzung in Ihrem Nutzungsdashboard sauber aggregiert werden.

Rate Limits gelten pro FirmenData-Konto mit demselben Sliding-Window-Throttle wie die REST-API. Beim Erreichen liefert das Tool einen Fehler mit Fensterlänge und Retry-After-Dauer; der abgelehnte Aufruf verbraucht keine Credits.

Siehe die Tarifseite für tarifabhängige Credit-Kontingente und Rate-Limit-Stufen.

Einschränkungen

Nur deutsche Entitäten. Die Abdeckung beschränkt sich auf Entitäten im Unternehmens- / Handelsregister und angrenzenden deutschen Registern (Genossenschaftsregister, Partnerschaftsregister, Vereinsregister, Gesellschaftsregister).
Suchsummen sind bei 10.000 gedeckelt. search_companies liefert total_approx bis maximal 10.000 — bei exaktem Bedarf Filter enger setzen.
fetch_realtime erhöht die Latenz. Live-Registerabfragen verlängern die Antwortzeit typischerweise um mehrere Sekunden, gelegentlich länger. Bei Upstream-Fehlern fällt die Antwort auf indizierte Daten zurück und meldet den Status in freshness.realtime_fetching_status.
Gesellschafterliste-Abdeckung variiert nach Rechtsform. Nur GmbHs und UGs reichen Gesellschafterlisten ein. Kleine GmbHs nach vereinfachtem Verfahren (§2 Abs. 1a GmbHG) reichen ein Musterprotokoll statt separatem Gesellschaftsvertrag und Liste ein — get_company_shareholders fällt transparent darauf zurück.
Lücken in der Registerhistorie. get_company_history kann einen Fehler liefern für Entitäten außerhalb der chronologischen Registerabdeckung (manche Vereine und Genossenschaften).

Fehlerbehebung

„OAuth-Weiterleitung fehlgeschlagen“ / „Verbindung nicht möglich“

Stellen Sie sicher, dass Sie sich mit demselben FirmenData-Konto anmelden, das Ihren API-Tarif hält. Falls der Browser das Popup blockt, Popups für claude.ai zulassen und erneut versuchen.

„Rate Limit überschritten“

Sie haben den Request-Window-Throttle Ihres Tarifs überschritten. Die Fehlermeldung enthält Fensterlänge und Retry-After in Sekunden. Abwarten oder Tarif upgraden; abgelehnte Aufrufe sind kostenlos.

„Kein Unternehmen mit ID ...“

Die eu_id wurde nicht erkannt. Zuerst autocomplete_companies oder search_companies aufrufen, um die Entität anhand des Namens aufzulösen, dann die zurückgegebene eu_id wörtlich übergeben.

Tool liefert „not_filed“ oder „not_applicable“

Dies ist ein Abdeckungsstatus, kein Fehler. not_applicable bedeutet, dass die Rechtsform des Unternehmens das angeforderte Dokument nicht einreicht (z. B. hat eine AG keine Gesellschafterliste). not_filed bedeutet, das Dokument wurde erwartet, fehlt aber im Register — fetch_realtime=true versuchen, um aus der Quelle zu aktualisieren.

Authentifizierung schlägt nach erfolgreichem Betrieb plötzlich fehl

Das Auth0-Token ist abgelaufen und Claude konnte es nicht still erneuern. Connector in den Claude-Connector-Einstellungen trennen und neu verbinden.

Support

E-Mail an [email protected] für Hilfe zum Connector, Abrechnungsfragen oder Meldung von Datenqualitätsproblemen. Bitte Konto-E-Mail und, falls relevant, eu_id und Tool-Name angeben.

Für programmatischen Zugriff außerhalb Claudes siehe die REST-API-Referenz.