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
  1. Du fügst die Adresse in deinem Assistenten dort ein, wo ein Connector oder MCP-Server hinzugefügt wird.
  2. 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“.
  3. 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“.

kostenloses Konto anlegen

Was du fragen kannst

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
  1. Öffne Customize → Connectors, klicke auf „+“ und wähle „Add custom connector“.
  2. Gib einen Namen ein, zum Beispiel apifirme, und füge die Adresse oben ein.
  3. Lass die übrigen Optionen, wie sie sind, und klicke auf „Add“, dann auf „Connect“.
  4. 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
  1. Ö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.
  2. 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“.
  3. Bestätige mit „I understand and want to continue“ und klicke dann auf „Create as a plugin“.
  4. Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
  5. Tippe in einer neuen Unterhaltung @ und wähle apifirme.
Perplexity · die Tarife Pro, Max und Enterprise, im Web und in der Desktop-App
  1. Öffne Settings → Connectors, klicke auf „+ Custom connector“ und wähle „Remote“.
  2. Gib einen Namen und die Adresse oben ein; wähle bei „Authentication“ „OAuth“ und bei „Transport“ „Streamable HTTP“.
  3. Klicke auf den hinzugefügten Connector, um die Anmeldung zu starten.
  4. 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)
  1. Öffne Connectors, klicke auf „+ Add Connector“ und wähle den Reiter „Custom MCP Connector“.
  2. Gib einen Namen und die Adresse oben ein und klicke auf „Connect“; die Art der Authentifizierung wird automatisch erkannt.
  3. Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Grok
  1. Öffne grok.com/connectors, klicke auf „New Connector“ und wähle „Custom“.
  2. Füge die Adresse oben ein und starte die Anmeldung.
  3. 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
  1. Im Agenten: Tools → Add a tool → New tool → Model Context Protocol.
  2. Gib einen Namen, eine Beschreibung und die Adresse oben ein; wähle als Authentifizierung „OAuth 2.0“ mit „Dynamic discovery“.
  3. Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
Gemini
  1. 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.
  2. Ü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