Zum Hauptinhalt springen

MCP Einstieg

Diese Seite zeigt die kürzeste Einrichtung für Kunden: passenden gehosteten Endpunkt wählen, nach Möglichkeit per OAuth verbinden und prüfen, ob der Assistent eine USt-IdNr. auflösen kann.

1. Gehosteten Endpunkt Verwenden​

Der gehostete Optimus MCP-Endpunkt ist:

https://mcp.app.optimussoftware.de

2. Optimus MCP Im Client Hinzufügen​

Verwenden Sie einen MCP-Client, der gehostete Streamable-HTTP-Server unterstützt.

OAuth-Clients​

Für gehostete Claude-Connectoren, Claude Code und andere Clients mit MCP-OAuth-Erkennung fügen Sie nur den Optimus MCP-Endpunkt hinzu:

https://mcp.app.optimussoftware.de

Der Client erkennt die OAuth-Metadaten über den MCP-Endpunkt, registriert seinen eigenen OAuth-Client dynamisch und führt Sie durch die Optimus Anmeldung und Zustimmung. Sie benötigen keine feste Client-ID und sollten kein Optimus API-Token in einen OAuth-fähigen gehosteten Connector einfügen.

Genehmigen Sie nur die erwarteten Optimus MCP-Berechtigungen, zum Beispiel USt-IdNr.-Lookup und USt-Validierung.

API-Token-Fallback​

Verwenden Sie diesen Fallback nur für MCP-Clients, die sich nicht per OAuth anmelden können, aber eigene Autorisierungs-Header senden.

Erstellen Sie ein Personal Access Token in der Optimus Web-App unter Settings > API Interface > API Tokens.

Kopieren Sie das Token sofort. Das vollständige Secret wird nur einmal angezeigt.

Speichern Sie keine echten tok_optimus_ Tokenwerte in Chat-Nachrichten, öffentlichen Prompts, Screenshots, Support-Tickets oder Dokumentationsbeispielen.

Fügen Sie den Optimus MCP-Endpunkt hinzu und konfigurieren Sie diesen Autorisierungs-Header:

Authorization: Bearer <token>

Einige MCP-Clients verwenden JSON-Konfiguration. In diesen Clients sieht die Konfiguration typischerweise so aus:

{
  "mcpServers": {
    "optimus": {
      "url": "https://mcp.app.optimussoftware.de",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Wenn Ihr Client verfügbare Aktionen einschränken kann, aktivieren Sie nur die Optimus Aktionen für USt-IdNr.-Lookup und USt-Validierung.

3. Verbindung Prüfen​

Fragen Sie den Assistenten:

Nutze Optimus MCP, um die USt-IdNr. DE329194932 aufzulösen.

Eine erfolgreiche Antwort sollte sagen, ob die USt-IdNr. gültig ist, und aufgelöste Unternehmensdaten anzeigen, wenn Optimus sie bereitstellen kann.

Beispiel für ein erfolgreiches Ergebnis:

DE329194932 ist gültig.
Aufgelöstes Unternehmen: TL Digital Solutions GmbH
Adresse: Leopoldstr. 8, 80802 Munchen
Geprüft am: 2026-04-19T10:17:26.4359867Z

Die genaue Formulierung hängt von Ihrem Assistenten ab. Wichtig ist, dass er Optimus MCP verwendet und einen USt-Status zurückgibt.

4. Einen Echten Workflow Testen​

Wenn die Verbindung funktioniert, testen Sie Prompts, die zur Nutzung in Ihrem Team passen:

Nutze Optimus MCP, um zu prüfen, ob DE329194932 gültig ist, und zeige die aufgelösten Unternehmensdaten.
Nutze Optimus MCP, um USt-IdNr.-Kandidaten für TL Digital Solutions GmbH in Deutschland, Leopoldstr. 8, 80802 Munchen, zu finden.
Nutze Optimus MCP, um diesen Lieferantendatensatz zu validieren: USt-IdNr. DE329194932, TL Digital Solutions GmbH, Leopoldstr. 8, 80802 Munchen.

Empfohlene Assistenten-Anweisung​

Fügen Sie Ihrer Assistenten-Konfiguration oder Ihren Workspace-Anweisungen eine kurze Anweisung hinzu:

Nutze Optimus MCP für USt-IdNr.-Lookup und USt-Validierung.
Nutze den konfigurierten Optimus MCP-Endpunkt für freigegebene Assistenten-Workflows.
Gib das Optimus Bearer Token niemals aus.
Wenn eine Validierung länger dauert, setze die Validierung fort, bis ein Endergebnis verfügbar ist.
Fasse Ergebnisse für Nutzer in fachlicher Sprache zusammen.

Nächste Schritte​