apifirme in deinem KI-Assistenten
Du fragst in deinen eigenen Worten; der Assistent sucht in den amtlichen Registern und sagt dir, woher er die Antwort hat. Es funktioniert mit Claude, ChatGPT, Perplexity, Mistral, Grok, Copilot, Cursor und jedem anderen Assistenten, der das Model Context Protocol (MCP) spricht.
Eine einzige Adresse
https://api.apifirme.dev/mcp
- Du fügst die Adresse in deinem Assistenten dort ein, wo ein Connector oder MCP-Server hinzugefügt wird.
- Der Assistent schickt dich zu apifirme: Du meldest dich mit deiner E-Mail-Adresse an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
- Du fragst. Der Assistent entscheidet selbst, was er nachschlägt.
Du kopierst keinen Schlüssel und installierst nichts. Der kostenlose Tarif reicht für 100 Fragen im Monat; das Verbinden zählt nicht.
Du kannst das Konto auch vorher anlegen. Bist du im selben Browser schon angemeldet, klickst du im zweiten Schritt nur noch auf „Erlauben“.
Was du fragen kannst
- Kann ich der Firma mit der CUI 13548146 eine Rechnung mit MwSt. stellen?
- Welche CUI hat Cubus Arts aus Sibiu, und ist die Firma noch aktiv?
- Welchen Umsatz und welchen Gewinn hatte RO13548146 in den letzten fünf Jahren?
- Hat sich bei dieser Firma in letzter Zeit etwas geändert? Ist sie noch in Betrieb?
- Wie viele Softwarefirmen wurden diesen Monat in Cluj und in Sibiu gegründet?
- Wie stand der BNR-Kurs für den Euro am 15. März 2024?
Du kennst die CUI nicht? Der Assistent findet die Firma über den Namen oder die Handelsregisternummer.
Schritt für Schritt, in deinem Assistenten
Die Menüs unterscheiden sich von Assistent zu Assistent und ändern sich gelegentlich. Wenn du eine Option nicht findest, suche in den Einstellungen nach „connector“ oder „MCP“: Mehr als die Adresse oben brauchst du nicht.
Claude · claude.ai und Claude Desktop, in jedem Tarif; der kostenlose erlaubt einen einzigen eigenen Connector
- Öffne Customize → Connectors, klicke auf „+“ und wähle „Add custom connector“.
- Gib einen Namen ein, zum Beispiel apifirme, und füge die Adresse oben ein.
- Lass die übrigen Optionen, wie sie sind, und klicke auf „Add“, dann auf „Connect“.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
ChatGPT · im Web, mit einem bezahlten Plan
- Öffne chatgpt.com/plugins, klicke auf „+“ und wähle „Add custom MCP server“. Fehlt die Option, schalte zuerst „Developer mode“ unter Settings → Apps → Advanced settings ein.
- Gib einen Namen ein, zum Beispiel apifirme, und eine Beschreibung; bei der Verbindung füge die Adresse oben ein, bei der Authentifizierung wähle „OAuth“.
- Bestätige mit „I understand and want to continue“ und klicke dann auf „Create as a plugin“.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
- Tippe in einer neuen Unterhaltung @ und wähle apifirme.
Perplexity · die Tarife Pro, Max und Enterprise, im Web und in der Desktop-App
- Öffne Settings → Connectors, klicke auf „+ Custom connector“ und wähle „Remote“.
- Gib einen Namen und die Adresse oben ein; wähle bei „Authentication“ „OAuth“ und bei „Transport“ „Streamable HTTP“.
- Klicke auf den hinzugefügten Connector, um die Anmeldung zu starten.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Mistral (Le Chat, Vibe)
- Öffne Connectors, klicke auf „+ Add Connector“ und wähle den Reiter „Custom MCP Connector“.
- Gib einen Namen und die Adresse oben ein und klicke auf „Connect“; die Art der Authentifizierung wird automatisch erkannt.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Grok
- Öffne grok.com/connectors, klicke auf „New Connector“ und wähle „Custom“.
- Füge die Adresse oben ein und starte die Anmeldung.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Microsoft Copilot Studio · für in Copilot Studio gebaute Agenten; in Microsoft 365 Copilot fügt der Administrator die Connectoren hinzu
- Im Agenten: Tools → Add a tool → New tool → Model Context Protocol.
- Gib einen Namen, eine Beschreibung und die Adresse oben ein; wähle als Authentifizierung „OAuth 2.0“ mit „Dynamic discovery“.
- Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Gemini
- Die Gemini-App nimmt eigene MCP-Server vorerst nur für private Konten in den USA an: Settings → Connected Apps → Custom apps → „Add a custom app“, mit der Adresse oben.
- Überall sonst nimmst du Gemini CLI: siehe unten.
Für Programme und Agenten: mit einem API-Schlüssel
Werkzeuge, die eine Konfigurationsdatei lesen, können statt der Anmeldung einen API-Schlüssel im Header Authorization senden. Den Schlüssel erzeugst du im Konto und setzt ihn an die Stelle von YOUR_API_KEY.
Claude Code
claude mcp add --transport http apifirme https://api.apifirme.dev/mcp
Gib danach /mcp in Claude Code ein und wähle apifirme, um dich anzumelden. Mit einem Schlüssel statt Anmeldung hängst du an den Befehl an: --header "Authorization: Bearer YOUR_API_KEY"
Cursor · ~/.cursor/mcp.json
{
"mcpServers": {
"apifirme": {
"url": "https://api.apifirme.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Ohne die Zeile „headers“ schickt dich Cursor zur Anmeldung, wie die Assistenten oben.
VS Code (GitHub Copilot) · .vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "apifirme-key",
"description": "apifirme API key",
"password": true
}
],
"servers": {
"apifirme": {
"type": "http",
"url": "https://api.apifirme.dev/mcp",
"headers": { "Authorization": "Bearer ${input:apifirme-key}" }
}
}
}
VS Code fragt dich einmal nach dem Schlüssel und bewahrt ihn außerhalb der Datei auf.
Gemini CLI
gemini mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" apifirme https://api.apifirme.dev/mcp
Codex CLI · ~/.codex/config.toml
[mcp_servers.apifirme]
url = "https://api.apifirme.dev/mcp"
bearer_token_env_var = "APIFIRME_API_KEY"
Der Schlüssel steht in der Umgebungsvariable APIFIRME_API_KEY.
Windsurf, Cline, Zed, LM Studio, Goose, n8n und andere
{
"mcpServers": {
"apifirme": {
"url": "https://api.apifirme.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Das Adressfeld heißt von Client zu Client anders: url, serverUrl (Windsurf), httpUrl (Gemini CLI), uri (Goose). Wo ein Transport verlangt wird, wähle „Streamable HTTP“.
Aus deinem eigenen Code: die APIs von OpenAI und Anthropic
// OpenAI Responses API, in "tools"
{ "type": "mcp", "server_label": "apifirme", "server_url": "https://api.apifirme.dev/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }, "require_approval": "never" }
// Anthropic Messages API, in "mcp_servers"
{ "type": "url", "name": "apifirme", "url": "https://api.apifirme.dev/mcp",
"authorization_token": "YOUR_API_KEY" }
Was der Assistent bekommt
| Werkzeug | Wofür es da ist |
|---|---|
| find_company | Findet eine Firma ohne CUI: nach dem Namen oder nach der Handelsregisternummer. |
| lookup_company | Die Daten einer Firma nach CUI: Name, Sitz, Status, CAEN-Code, MwSt., e-Factura. |
| check_invoice | Die Prüfung vor der Rechnungsstellung: existiert, mehrwertsteuerpflichtig, Ist-Versteuerung, inaktiv, e-Factura. |
| get_financials | Die Jahresabschlüsse, seit 2008. |
| get_company_events | Was sich bei einer Firma geändert hat, seit wir sie beobachten. |
| get_fx_rate | Der Referenzkurs der BNR, seit 2005. |
| count_new_companies | Wie viele neue Firmen registriert wurden, nach Branche und Kreis. In jedem Tarif. |
| list_new_companies | Die Liste der neu registrierten Firmen. Im Tarif Plus und in den größeren, ab 69 Lei + MwSt. pro Monat. |
Alle Werkzeuge lesen nur. Der Assistent kann nichts ändern, weder an den Daten noch in deinem Konto.
Gut zu wissen
- Gezählt werden nur die Fragen an die Register (Tool-Aufrufe), jede als eine Anfrage deines Tarifs. Das Verbinden und die Liste der Werkzeuge zählen nicht.
- Die Liste der neu registrierten Firmen (list_new_companies) gibt es im Tarif Plus und in den größeren, ab 69 Lei + MwSt. pro Monat. Wie viele es sind, erfährt der Assistent in jedem Tarif, auch im kostenlosen.
- Ein verbundener Assistent erscheint im Konto als Schlüssel, der seinen Namen trägt. Du trennst ihn, indem du den Schlüssel widerrufst.
- Jede Antwort enthält Quelle und Datum der Information. Bitte den Assistenten, sie dir zu nennen.
- Auch natürliche Personen, die eine wirtschaftliche Tätigkeit ausüben (Einzelunternehmer: PFA, Einzel- und Familienunternehmen; freie Berufe), werden gefunden und beschrieben, mit dem, was die Register über sie veröffentlichen.
- Technisch: Transport Streamable HTTP, das MCP-Protokoll in der Revision 2026-07-28 und in denen von 2025, Authentifizierung per OAuth 2.1 oder API-Schlüssel.