Handelsregister-Zugriff¶
Wer steht hinter einer Anzeige, und gibt es die Firma in der Form, die sie angibt? Das Handelsregister beantwortet das: Firmenname, Rechtsform, Sitz, Registernummer und Geschäftsführung. Der quelloffene Handelsregister-MCP-Server von lexdoudkin (Apache-2.0) lässt Claude eine Firma bei der Recherche im Registerportal nachschlagen, sodass du das Portal nicht von Hand durchsuchen musst.
Bevorzugter Weg zum Register, aber optional und nicht Teil dieses Plugins
Ist der Server verbunden und hast du zugestimmt, wird das Register über ihn gelesen und über
keinen anderen Weg; Websuche und Seitenabruf werden für handelsregister.de nicht genutzt,
weil sie deine Zustimmung und das Budget weiter unten umgehen. Das ist die Arbeitsregel des
Rechercheverfahrens (spec/job-application/recherche/en.md, RC-5.3). Kein Skill dieses Plugins
braucht den Server, und das Plugin installiert nichts. Ohne ihn funktioniert weiterhin alles:
Die Recherche sagt es, und du kannst die Registerdaten selbst eintragen oder die Punkte als
nicht ermittelt lassen. Der Server ist ein eigenständiges Projekt und steht weder mit diesem
Plugin noch mit dem Registerportal in Verbindung.
Die Regeln, die für alle optionalen Server gelten, stehen auf
Optionale MCP-Server.
Wann die Abfrage angeboten wird¶
- Nur in Recherchestufe 1 oder 2, nie in Stufe 0.
- Automatisch bei einem Vorgang, dessen Gegenpartei ein Vermittler ist (Personalberatung, Personalvermittlung, Zeitarbeit), und für die Firma des Personalvermittlers selbst.
- Bei einem direkten Arbeitgeber nur, wenn du es verlangst.
- Immer mit deinem Ja. Vor der ersten Abfrage eines Vorgangs nennt Claude die Grenzen und Risiken
weiter unten und wartet. Ein Nein lässt die übrigen Kanäle unberührt; die Registerpunkte bleiben
nicht ermittelt.
Was die Recherche nutzt¶
| Bedarf | Tool des Servers |
|---|---|
| Die Firma nach Name, Sitz oder Registernummer finden | search_company |
| Registereintrag: Name, Rechtsform, Sitz, Registernummer, Geschäftsführung | get_company |
Aktueller Auszug (nur Dokumenttyp AD) |
fetch_document |
| Ob und wann Jahresabschlüsse eingereicht wurden (nur Existenz und Datum) | list_filed_documents |
| Verbleibendes Stundenkontingent | rate_limit_status |
Die Recherche nutzt nicht get_shareholders, fetch_filed_document, fetch_document mit einem
anderen Typ als AD (HD, CD, SI, UT, VÖ) und keine Massen- oder Nachbarabfragen. Sie
dienen der Gesellschafterrecherche und dem Profiling, was eine Bewerbung nicht braucht
(RC-5.3 Regel 1).
Grenzen und Regeln¶
- Budget. Höchstens 4 Abrufe pro Vorgang in Recherchestufe 1 und höchstens 8 in Stufe 2
(
rate_limit_statuszählt nicht). Beide Stufen teilen sich ein Budget pro Vorgang, auch über Sitzungen hinweg: Der Stand wird aus der ZeileKanäleim Protokoll gelesen. Aufrufe laufen nacheinander. Claude erhöht nie die VariableHANDELSREGISTER_MAX_PER_HOURdes Servers (Standard 60); du kannst die Zahlen senken. Ist das Budget oder das Stundenkontingent aufgebraucht, bleiben die offenen Punktenicht ermitteltmit dem GrundAbrufgrenze erreicht. - Datensparsamkeit. Geburtsdaten und private Anschriften von Geschäftsführenden werden nicht
in
analyse.mdoder eine Firmendatei übernommen. Namen und Funktionen werden nur so weit festgehalten, wie die Identitätsprüfung sie braucht (RC-5.3 Regel 5). - Ein Treffer allein bestätigt nichts. Ein Registertreffer bestätigt die Identität der Firma
nur zusammen mit dem Impressum. Zwei Firmen mit gleichem Namen werden über Sitz und
Registernummer getrennt; klären Anzeige oder Impressum nicht, welche gemeint ist, lautet der
Status
Identität nicht bestätigt, und du entscheidest (RC-5.3 Regeln 6 und 8). - Ein Fehlschlag ist kein Abbruch. Eine fehlgeschlagene Abfrage, ein leeres Ergebnis oder
eine offene Mehrdeutigkeit lässt den Punkt
nicht ermitteltmit dem Grund, und die Recherche läuft weiter (Regel 8). - Protokoll. Die Zeile
Kanälenennt den Weg und die Zahl, etwaHandelsregister über handelsregister-mcp (2 Abrufe)(bei einem einzigen Abruf1 Abruf), oder warum keine Abfrage lief (RC-9 Regel 8).
Was er nicht abdeckt¶
Der Server liest das Handelsregister. Veröffentlichte Jahresabschlüsse (Unternehmensregister,
Bundesanzeiger) und amtliche Insolvenzbekanntmachungen bleiben Handarbeit: Die Recherche führt sie
als nicht ermittelt, oder du schlägst sie selbst nach. Kostenpflichtige Datenanbieter sind hier
ebenfalls nicht abgedeckt.
Risiken¶
- Bedingungen und Recht. Die README des Servers nennt, dass das Portal automatisierte Abrufe begrenzt, setzt eine Grenze von 60 Abrufen pro Stunde und gibt an, dass das Portal warnt, automatisierte Massenabfragen könnten strafbar sein. Das sind Aussagen der README, kein gesichertes Recht und von dieser Dokumentation nicht bestätigt. Der Einsatz ist deine Entscheidung und dein Risiko. Schlage einzelne Firmen nach und nur wenige.
- Personenbezogene Daten. Das Register enthält personenbezogene Daten der Geschäftsführung. Alles, was der Server liest, wird Teil der Claude-Sitzung und geht wie jeder andere Text darin an den Modellanbieter. Halte Geburtsdaten und private Anschriften aus deinen Dateien heraus.
- Ein junges Projekt. Das Repository wurde am 2026-06-21 angelegt und hat wenige Mitwirkende.
Bei der Prüfung am 2026-10-23 war es nicht auf PyPI (HTTP 404 auf pypi.org), es wird also aus
einem Klon installiert. Prüfe den Code, bevor du ihn ausführst, und pinne einen Commit. Der für
diese Seite geprüfte Commit ist
26e616beb808bc653ed0504c0c9cd525235082fc(2026-06-21). Nichts aktualisiert den Pin automatisch; lies das Diff, bevor du ihn verschiebst. - Änderungen am Portal. Der Server liest ein laufendes Portal aus. Ändert sich das Portal,
können Abfragen scheitern oder falsche Felder liefern. Die Recherche fällt dann auf
nicht ermitteltzurück. - Das Extra
[ocr]nicht installieren. Es zieht PyMuPDF nach (AGPL-3.0 oder kommerzielle Lizenz) und wird für die genannten Abfragen nicht gebraucht.
Einrichten¶
Maßgeblich für aktuelle Schritte und Optionen ist die
README des Servers. Kurz: Klone das
Repository, checke den geprüften Commit aus und installiere aus dem Klon ohne das Extra [ocr]:
git clone https://github.com/lexdoudkin/handelsregister-mcp
cd handelsregister-mcp
git checkout 26e616beb808bc653ed0504c0c9cd525235082fc
pip install -e .
Registriere ihn dann in Claude Code, wie die README es beschreibt:
claude mcp add handelsregister -- handelsregister-mcp
Prüfe mit /mcp, dass der Server verbunden ist. Lass HANDELSREGISTER_MAX_PER_HOUR auf dem
Standardwert.