Zum Hauptinhalt springen

MCP Einstieg

Diese Seite zeigt die kürzeste Einrichtung für Kunden: Token erstellen, passenden gehosteten Endpunkt wählen, im MCP-Client eintragen und prüfen, ob der Assistent eine USt-IdNr. auflösen kann.

1. Token Erstellen​

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.

2. Umgebung Wählen​

UmgebungMCP-Endpunkt
Produktionhttps://mcp.app.optimussoftware.de
Testhttps://mcp.dev.app.optimussoftware.de

Starten Sie mit dem Test-Endpunkt, wenn Sie eine neue Assistenten-Einrichtung prüfen. Wechseln Sie erst zu Produktion, wenn der Assistent mit produktiven Optimus Daten arbeiten soll.

3. Optimus MCP Im Client Hinzufügen​

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

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>"
      }
    }
  }
}

Für Test verwenden Sie:

https://mcp.dev.app.optimussoftware.de

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

4. Verbindung Prüfen​

Fragen Sie den Assistenten:

Nutze Optimus MCP, um die USt-IdNr. DE284700631 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:

DE284700631 ist gültig.
Aufgelöstes Unternehmen: Optimus Software GmbH
Adresse: Tal 44, 80331 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.

5. 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 DE284700631 gültig ist, und zeige die aufgelösten Unternehmensdaten.
Nutze Optimus MCP, um USt-IdNr.-Kandidaten für Optimus Software GmbH in Deutschland, Tal 44, 80331 Munchen, zu finden.
Nutze Optimus MCP, um diesen Lieferantendatensatz zu validieren: USt-IdNr. DE284700631, Optimus Software GmbH, Tal 44, 80331 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 Test-Endpunkt für Test-Workflows und den Produktionsendpunkt nur für Produktionsdaten.
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​