Anleitung

Verbindung einrichten

Mit einem per E-Mail erhaltenen API-Key ist Agentic-Firmenbuch.at in wenigen Minuten im KI-Tool verbunden. In allen Beispielen DEIN_API_KEY durch den eigenen Schlüssel ersetzen.

Deine Abfragen werden nicht gespeichert. Keine Prompts, Firmennamen oder Suchbegriffe — pro Konto Aufruf-Zähler fürs Limit, dazu technische Messwerte je Aufruf zur Fehlererkennung (nie die Inhalte deiner Abfragen). Datenschutz.

Wähle deinen Client

Am einfachsten geht es mit Claude Cowork – ganz ohne API-Key. Tool wählen, die Schritte erscheinen darunter.

Für die Claude Desktop-App (Tabs Chat & Cowork) brauchst du keinen API-Key – die Verbindung läuft über einen Connector mit einmaliger Anmeldung per E-Mail.

In Claude: Einstellungen → Konnektoren → Benutzerdefinierten Connector hinzufügen.
Name Agentic-Firmenbuch, Adresse https://mcp.agentic-firmenbuch.at/mcp → hinzufügen.
In einem neuen Chat Agentic-Firmenbuch nutzen → Claude fragt einmalig nach der Verbindung → im Browser E-Mail eingeben → Bestätigungslink öffnen → Zugriff erlauben. Fertig.

Bebilderte Schritt-für-Schritt-Anleitung ansehen →

Pro gekauft? Einfach dieselbe E-Mail verwenden – Cowork und ein API-Key nutzen dasselbe Konto, Pro ist sofort aktiv.

Voraussetzung: dein API-Key aus der E-Mail (DEIN_API_KEY ersetzen). Ein Befehl, als eine Zeile einfügen – macOS, Linux, Windows/PowerShell identisch:

Terminal öffnen: macOS → ⌘ + Leertaste, „Terminal" · Windows → „PowerShell" · Linux → dein Terminal.

claude mcp add --scope user --transport http agentic-firmenbuch https://mcp.agentic-firmenbuch.at/mcp --header "X-API-Key: DEIN_API_KEY"

Testen: neuen Chat öffnen und fragen „Bist du mit dem Agentic-Firmenbuch-Server verbunden, welche Werkzeuge hast du?" – nennt der Agent die Firmenbuch-Werkzeuge, läuft es.

Jeder MCP-Client mit HTTP + Header-Authentifizierung (VS Code/Copilot, Cursor u. a.) verbindet sich mit denselben zwei Angaben (DEIN_API_KEY ersetzen):

Adresse: https://mcp.agentic-firmenbuch.at/mcp · Typ http
Header: X-API-Key: DEIN_API_KEY

Offizielle Doku: VS Code (MCP) · Cursor (MCP). Üblich als mcp.json-Eintrag:

{
  "mcpServers": {
    "agentic-firmenbuch": {
      "type": "http",
      "url": "https://mcp.agentic-firmenbuch.at/mcp",
      "headers": { "X-API-Key": "DEIN_API_KEY" }
    }
  }
}

4 Loslegen

Beispiel-Fragen, die sich direkt stellen lassen:

„Zeig mir aktive GmbHs in der Steiermark mit Bilanzsumme über 5 Mio. Euro."
„Welche Unternehmen wachsen seit Jahren und haben eine hohe Eigenkapitalquote?"
„Hol mir die Bilanzkennzahlen und den letzten Jahresabschluss von Firma XY."

Zum Ausprobieren ohne Einrichtung: Playground und Datenfelder.

Mehr Details – bei Bedarf aufklappen

Verfügbare Werkzeuge (MCP-Tools)

Der Server stellt dem KI-Tool diese Werkzeuge bereit. Der Agent wählt sie selbst passend zur Frage – ein direkter Aufruf ist nicht nötig.

search_companies – Unternehmen filtern (Region, Rechtsform, Größenklasse, Bilanzsumme, Eigenkapitalquote, Umsatz, Mitarbeiter, Wachstum, GF-Alter) → Liste kompakter Treffer-Karten.
get_company_details – kuratiertes Firmenprofil zu einer Firmenbuchnummer.
get_company_history – Mehrjahres-Zeitreihen je Kennzahl (Bilanzsumme, Eigenkapitalquote …).
get_full_record – vollständiger Datensatz inkl. aller Bilanzpositionen samt offizieller UGB-Codes.
get_document – Referenz/Link zum Original-Jahresabschluss.
list_sectors – Branchen-/Größen-Übersichten mit Anzahl.
get_cohort_summary – Aggregat-Kennzahlen einer Kohorte (z. B. alle GmbHs in der Steiermark).
find_peers – vergleichbare Unternehmen nach Größenklasse und Bilanzsumme.

Welche Daten geliefert werden

Pro Unternehmen, strukturiert und mit Herkunftsnachweis:

Identität – Firmenname, Firmenbuchnummer, Rechtsform, Status (aktiv/historisch/gelöscht).
Standort – Bundesland, Sitz, Firmenbuchgericht.
Größe – Größenklasse (Kleinst/Klein/Mittel/Groß), Bilanzsummen-Band.
Finanzen – Bilanz- und (wo veröffentlicht) GuV-Werte, mehrjährig; jede Position mit ihrem offiziellen UGB-Code (z. B. „§ 224 Abs 2 A II").
Kennzahlen – Eigenkapitalquote, Verschuldung, Deckungsgrade, EBIT/EBITDA, Margen, ROE/ROA – berechnet, mit Verlauf.
Wachstum – Profil (schrumpfend/stabil/wachsend/stark wachsend) + Raten.
Mitarbeiter – wo veröffentlicht.
Geschäftsführung – Name, Funktion, Vertretungsart sowie Alter bzw. Geburtsjahr (nur Jahr, kein Tag/Monat – DSGVO).
Originaldokumente & Herkunft – Liste der Jahresabschlüsse + Quelle und Lizenz (CC BY 4.0).

Datenquelle, Aktualität & Datenschutz

Quelle – Österreichisches Firmenbuch / JustizOnline (BMJ – Justiz), genutzt unter CC BY 4.0. Daten ohne Gewähr.
Aktualität – laufend aktualisiert über die offiziellen Änderungs-Feeds.
Datenschutz – Namen der Organe (z. B. Geschäftsführer) stammen aus dem öffentlichen Firmenbuch und werden für die Einzelabfrage ausgeliefert; Geburtsdaten nur jahresgenau (Alter/Geburtsjahr, kein Tag/Monat). Massenextraktion und Weiterverkauf sind untersagt.

Fair-Use, Key & Support

Free kostenlos mit Fair-Use-Limit; Pro (79 € / Monat inkl. USt, 14 Tage testen, monatlich kündbar) für den vollen Umfang.
Key verloren oder kompromittiert? Neuen Key anfordern – der alte wird sofort ungültig.
Der Key ist wie ein Passwort zu behandeln und nicht weiterzugeben (Nutzungsbedingungen).
Fragen oder Probleme? Schreib einfach an office@jngb.online – wir helfen gern.