Kompatibilität & Integration

Der Server funktioniert mit jedem MCP-fähigen Client — von Claude und ChatGPT bis zum OpenAI SDK — und bringt Handelsregister-Daten ohne eigene Integrationsschicht in Deine KI-Workflows.

Hauptfunktionen

• Funktioniert mit allen MCP-Clients
• Echtzeit-Zugriff auf deutsche Unternehmensdaten
• Gemacht für agentenbasierte Workflows
• Native Integration ins OpenAI SDK

Verwendung mit dem OpenAI Python SDK

Den MCP-Server kannst Du direkt mit dem OpenAI Python SDK verwenden, um Handelsregister-Daten in Deine KI-Anwendungen zu holen:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

resp = client.responses.create(
    model="gpt-5",
    input="Gib mir die aktuellsten Finanzdaten der Konux GmbH aus München und gebe diese als Markdown-Tabelle aus.",
    tools=[
        {
            "type": "mcp",
            "server_label": "handelsregister",
            "server_url": "https://mcp.handelsregister.ai/mcp",
            "require_approval": "never",
            "headers": {
                "X-API-Key": os.environ["HANDELSREGISTER_API_KEY"]
            },
        }
    ],
)

print(resp.output_text)

Authentifizierung

Zwei Authentifizierungsmethoden werden unterstützt:

API-Key (Header)

Schick Deinen handelsregister.ai API-Key als Header mit — ideal für skriptbasierte Clients und SDKs:

Es ist derselbe API-Key wie für die REST API.

OAuth 2.1 (für MCP-Clients wie Claude und ChatGPT)

Clients, die sich interaktiv verbinden (z. B. Claude Custom Connectors, ChatGPT), authentifizieren sich über unseren OAuth-2.1-Autorisierungsserver — ganz ohne manuelles API-Key-Handling. Der Client entdeckt den Server automatisch, registriert sich selbst (Dynamic Client Registration, RFC 7591) und holt Deine Zustimmung im Browser ein. Anfragen werden anschließend über Dein Konto abgerechnet.

Unterstützt: authorization_code-Grant mit PKCE, Refresh Tokens, Scopes mcp / api / offline_access. Access Tokens funktionieren auf der REST API wie reguläre Bearer-Tokens.

Verfügbare Tools

Der MCP-Server stellt ein Tool pro Datenprodukt bereit. Die Tool-Parameter entsprechen den REST-API-Parametern; Credits werden exakt wie beim entsprechenden REST-Aufruf berechnet:

Agentenbasierte Workflows

Der MCP-Server bringt Handelsregister-Daten direkt in komplexe agentenbasierte Workflows:

• • Automatische Datenextraktion und -analyse
• • Multi-Agenten-Systeme mit Zugriff auf Unternehmensdaten
• • Workflow-Automatisierung mit Echtzeit-Datenabruf
• • Integration in bestehende KI-Pipelines

Credits & Preise

MCP-Anfragen verbrauchen dieselben Credits wie direkte API-Aufrufe — abhängig von den angeforderten Features, zu exakt denselben Preisen wie die REST API.

Anforderungen

• Gültiger handelsregister.ai API-Key
• MCP-kompatibler Client (z. B. OpenAI SDK)
• Python 3.8+ (für das OpenAI SDK)