MCP-Server
Der MCP-Server der Firmenakte stellt jeden Endpoint der API als Werkzeug für KI-Agenten bereit. Statt HTTP-Requests zu formulieren, ruft ein Agent in Claude Desktop, Cursor oder n8n die Werkzeuge direkt auf. Angemeldet wird mit dem Firmenakte-Konto über OAuth – ein API-Key wird im Client nicht hinterlegt.
Der Server auf einen Blick
| Endpoint | https://mcp.firmenakte.at/mcp |
| Transport | Streamable HTTP |
| Anmeldung | OAuth mit dem Firmenakte-Konto |
| Werkzeuge | Aus der OpenAPI-Spezifikation erzeugt, 36 Endpoints |
| Abrechnung | Zählt auf das Requestkontingent des angemeldeten Kontos |
Einrichten
In die Konfigurationsdatei des MCP-Clients – etwa .cursor/mcp.json im Projektverzeichnis oder die Benutzerkonfiguration von Claude Desktop – kommt der Server mit Namen und URL. Beim ersten Verbinden leitet der Client auf firmenakte.at weiter, wo der Zugriff mit dem eigenen Konto bestätigt wird. Danach stehen die Werkzeuge im Agenten bereit.
{
"mcpServers": {
"firmenakte": {
"url": "https://mcp.firmenakte.at/mcp"
}
}
}Ein API-Key muss im Client nicht hinterlegt werden – im Konto aber vorhanden sein: Der Server verwendet den Key des angemeldeten Kontos serverseitig, und ohne einen im Dashboard angelegten Key antwortet die API auf jeden Werkzeugaufruf mit 401.
Welche Werkzeuge der Server anbietet
Die Werkzeuge werden aus der OpenAPI-Spezifikation der Firmenakte-API erzeugt: Jeder der 36 Endpoints wird ein Werkzeug, die Namen spiegeln die Routen. Damit deckt der Server dieselben Bereiche ab wie die API selbst.
- Unternehmen: Screener, Firmenprofil, ähnliche Unternehmen, Treffermenge, Namensindex
- Personen: Suche nach Name oder Funktion, Personenprofil mit allen eingetragenen Funktionen
- Verflechtungen: Beteiligungs- und Funktionsgraph zu einem Unternehmen oder einer Person
- Gewerbe: GISA-Katalog, Berechtigungen einer Firma, Gewerbeauszug als Dokument
- Edikte und Dokumente: Ediktsdatei-Feed, Jahresabschlüsse und weitere Dokumente
- Änderungen: die Change-Feeds, einzeln und aggregiert
- Kataloge: ÖNACE, Rechtsformen, Firmenbuchgerichte, Funktionscodes, Orte und Postleitzahlen
| Werkzeug | Route |
|---|---|
| GET_apiv1businesses | GET /api/v1/businesses |
| GET_apiv1businessesfnr | GET /api/v1/businesses/{fnr} |
| GET_apiv1businessesfnrsimilar | GET /api/v1/businesses/{fnr}/similar |
Eine Einschränkung gegenüber der REST-API: Die punktierten Range-Filter auf einzelne Bilanz- und GuV-Kennzahlen sind aus den beiden Screener-Werkzeugen (/businesses und /businesses/aggregate) entfernt – rund hundert Parameter blähen das Eingabeschema so weit auf, dass Clients das Werkzeug stillschweigend verwerfen. Filter ohne Punkt bleiben: Ort, PLZ, ÖNACE-Code, Rechtsform, Mitarbeiteranzahl, Aktiv-Status. Wer nach einzelnen Kennzahlen filtern will, nimmt dafür die REST-API.
Dokumentation für Agenten
Soll ein Agent die Dokumentation lesen statt Werkzeuge aufzurufen, gibt es sie maschinenlesbar: llms.txt und openapi.json.
Häufige Fragen
Brauche ich einen API-Key für den MCP-Server?
Im Client nicht. Der Client meldet sich beim ersten Verbinden über OAuth mit dem Firmenakte-Konto an; der Server ermittelt den API-Key dieses Kontos selbst und verwendet ihn serverseitig. Ein Key muss im Konto aber existieren – ohne einen im Dashboard angelegten Key antwortet die API mit 401.
Zählen Werkzeugaufrufe auf mein Kontingent?
Ja. Der Server ruft die API mit dem Key des angemeldeten Kontos auf, also zählt ein Werkzeugaufruf genauso wie ein direkter API-Request auf das monatliche Requestkontingent des Plans.
Kann ein Agent nach Bilanzkennzahlen filtern?
Nur eingeschränkt. Die punktierten Range-Filter auf einzelne Bilanz- und GuV-Kennzahlen (etwa guv.Umsatzerloese_gte) sind aus den beiden Screener-Werkzeugen entfernt, weil das Eingabeschema sonst so groß wird, dass Clients das Werkzeug stillschweigend verwerfen. Filter ohne Punkt – Ort, PLZ, ÖNACE-Code, Rechtsform, Mitarbeiteranzahl, Aktiv-Status – bleiben. Über die REST-API sind alle 47 Kennzahlen filterbar.
Welche Clients funktionieren?
Jeder MCP-Client, der einen Server über streamable HTTP und OAuth einbinden kann – etwa Claude Desktop, Cursor oder n8n. Die Konfiguration ist in allen dieselbe: Name und URL des Servers.
Agenten an die Firmendaten
Konto anlegen, API-Key im Dashboard erstellen, https://mcp.firmenakte.at/mcp im Client eintragen. Wer lieber selbst Code schreibt, nimmt einen Client.