apifirme
ro en de hu

apifirme in deinem KI-Assistenten

Du fragst in deinen eigenen Worten, der Assistent sucht die Antwort in den amtlichen Registern und sagt dir, woher er sie 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.

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 gehören dem jeweiligen Assistenten und ändern sich gelegentlich. Wenn du eine Option nicht findest, suche in seinen 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 Tarif; eigene Connectoren gehören zum „Developer mode“
  1. Schalte in den Settings den „Developer mode“ ein.
  2. Füge eine neue App hinzu (chatgpt.com/plugins, Schaltfläche „+“): ein Name, die Adresse oben bei „MCP server URL“ und „OAuth“ als Authentifizierung.
  3. Der Assistent schickt dich zu apifirme: Du meldest dich an (oder legst gleich ein kostenloses Konto an) und klickst auf „Erlauben“.
  4. Wähle in einer Unterhaltung apifirme aus dem Menü „+“.
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. In den Tarifen, die sie enthalten.

Alle Werkzeuge lesen nur. Der Assistent kann nichts ändern, weder an den Daten noch in deinem Konto.

Gut zu wissen