Was Assistenten Tun Können
Optimus MCP gibt Ihrem Assistenten eine kleine Gruppe von Aktionen für USt-IdNr.-Lookup und USt-Validierung. In der normalen Nutzung sollten Ihre Nutzer fachliche Fragen stellen und den Assistenten den Optimus Aufruf übernehmen lassen.
Verfügbare Aktionen
| Kundenziel | Was der Assistent tut | Aktionsname in manchen MCP-Clients |
|---|---|---|
| Eine USt-IdNr. prüfen | Löst die USt-IdNr. auf und meldet, ob sie gültig ist. | resolve_vat |
| Eine USt-IdNr. aus Unternehmensdaten finden | Sucht USt-IdNr.-Kandidaten anhand von Unternehmensname, Land und Adresse. | lookup_vat |
| Kunden- oder Lieferantendatensätze validieren | Führt eine Optimus Validierung für einen oder mehrere Datensätze aus und fasst das Ergebnis zusammen. | validate_vat_records |
| Eine längere Validierung fortsetzen | Prüft den Fortschritt und holt das Endergebnis ab, wenn die Verarbeitung abgeschlossen ist. | get_vat_validation_result |
Eine USt-IdNr. Prüfen
Nutzen Sie dies, wenn die USt-IdNr. bereits bekannt ist.
Optionen:
| Kundenauswahl | Was angeben? | Optionsname in manchen MCP-Clients |
|---|---|---|
| Zu prüfende USt-IdNr. | Die USt-IdNr., möglichst mit Länderpräfix, zum Beispiel DE284700631. | vat_id |
| Transliteration | Optimus soll aufgelöste Unternehmens- und Adressfelder transliterieren, oder diese Option leer lassen, um Ihre Optimus Benutzereinstellungen zu verwenden. | transliterate |
| Zusätzliche Adressbestandteile | Optimus soll Straßenname und Hausnummer getrennt zurückgeben, wenn verfügbar. Unterstützte Werte sind addressStreetName und addressHouseNumber. | include |
Beispielprompt:
Nutze Optimus MCP, um zu prüfen, ob DE284700631 gültig ist, und zeige die aufgelösten Unternehmensdaten.
Beispiel mit Option:
Nutze Optimus MCP, um zu prüfen, ob DE284700631 gültig ist. Verwende Transliteration für die aufgelösten Unternehmens- und Adressdaten.
Nutze Optimus MCP, um zu prüfen, ob DE284700631 gültig ist, und gib Straßenname und Hausnummer getrennt zurück, wenn verfügbar.
Erwartetes Ergebnis:
- USt-Status, zum Beispiel gültig, ungültig oder nicht verfügbar.
- Aufgelöster Unternehmensname, wenn verfügbar.
- Aufgelöste Adresse, wenn verfügbar.
- Zeitpunkt der Prüfung.
USt-IdNr.-Kandidaten Finden
Nutzen Sie dies, wenn Unternehmensdaten bekannt sind, aber die USt-IdNr. fehlt oder unsicher ist.
Optionen:
| Kundenauswahl | Was angeben? | Optionsname in manchen MCP-Clients |
|---|---|---|
| Unternehmensname | Unternehmensname für die Suche. Erforderlich. | companyName |
| Land | Zweistelliger Ländercode wie DE, AT oder NL. Erforderlich. | countryCode |
| Straße | Straße, wenn verfügbar. | street |
| Ort | Ort, wenn verfügbar. | city |
| PLZ | Postleitzahl, wenn verfügbar. | zip |
| Unstrukturierte Adresse | Vollständiger Adresstext, wenn Straße, PLZ und Ort nicht getrennt vorliegen. | rawAddress |
| Transliteration | Optimus soll aufgelöste Unternehmens- und Adressfelder transliterieren, oder diese Option leer lassen, um Ihre Optimus Benutzereinstellungen zu verwenden. | transliterate |
Beispielprompt:
Nutze Optimus MCP, um USt-IdNr.-Kandidaten für Optimus Software GmbH in Deutschland, Tal 44, 80331 Munchen, zu finden.
Beispiel mit Optionen:
Nutze Optimus MCP, um USt-IdNr.-Kandidaten für Optimus Software GmbH zu finden. Verwende Ländercode DE, Adresse Tal 44, 80331 Munchen, und Transliteration.
Erwartetes Ergebnis:
- Anzahl gefundener Kandidaten.
- Kandidaten für USt-IdNrn.
- Prüfstatus je Kandidat.
- Ähnlichkeitswert und aufgelöste Unternehmensdaten, wenn verfügbar.
Adressdaten verbessern den Abgleich. Geben Sie mindestens Unternehmensname und Land an.
Datensätze Validieren
Nutzen Sie dies, wenn Optimus übermittelte Kunden- oder Lieferantendatensätze validieren soll.
Datensatzfelder:
| Kundenauswahl | Was angeben? | Feldname in manchen MCP-Clients |
|---|---|---|
| USt-IdNr. | USt-IdNr. des Kunden oder Lieferanten. | vatId |
| Unternehmensname | Unternehmensname zum Abgleich mit dem autoritativen Ergebnis. | companyName |
| Straße | Straße zum Abgleich mit dem autoritativen Ergebnis. | street |
| PLZ | Postleitzahl zum Abgleich mit dem autoritativen Ergebnis. | zip |
| Ort | Ort zum Abgleich mit dem autoritativen Ergebnis. | city |
| Eigene Referenzfelder | Werte, mit denen Sie das Ergebnis Ihrem System zuordnen, zum Beispiel Lieferantennummer, Kundennummer oder Importzeilen-ID. | benutzerdefinierte Felder |
Validierungsoptionen:
| Kundenauswahl | Was steuert es? | Optionsname in manchen MCP-Clients |
|---|---|---|
| Standard- oder qualifizierte Validierung | Standardvalidierung für normale Prüfungen. Qualifizierte Validierung, wenn Optimus USt-IdNr., Unternehmensname und Adresse nach qualifizierten Bestätigungsregeln prüfen soll. | checkType |
| Retry-Zeitfenster | Wie lange Optimus transiente Validierungsprobleme erneut versuchen darf. Werte sind kein Retry, 1 Stunde, 2 Stunden, 4 Stunden, 8 Stunden und 24 Stunden. | retryDuration |
| Benachrichtigungs-E-Mail | Ob der Validierungsworkflow seine konfigurierte Benachrichtigungs-E-Mail senden darf. | sendNotificationEmail |
| Snapshot | Ob Optimus einen Snapshot des abgeschlossenen Ergebnisses speichert. | createSnapshot |
| PDF-Bericht | Ob ein PDF-Bericht erzeugt werden soll. | pdf.create |
| Signiertes PDF | Ob das erzeugte PDF signiert werden soll. Erfordert PDF-Erstellung. | pdf.sign |
| PDF per E-Mail | Ob das PDF über den Validierungsworkflow per E-Mail gesendet werden soll. Erfordert PDF-Erstellung. | pdf.sendByEmail |
| PDF als Download-Link zurückgeben | Ob das Ergebnis eine PDF-Download-URL enthalten soll. Erfordert PDF-Erstellung. | pdf.returnAsUrl |
| PDF als Base64 zurückgeben | Ob das Ergebnis den PDF-Inhalt als Base64 enthalten soll. Erfordert PDF-Erstellung. | pdf.returnAsBase64 |
| Eigene USt-IdNr. | USt-IdNr., die während der Validierung als Ihre eigene USt-IdNr. verwendet wird. Wenn ausgelassen, nutzt Optimus Ihren konfigurierten Standard. | ownVatId |
| Transliteration | Transliteration für die Validierung überschreiben oder leer lassen, um Ihre Optimus Benutzereinstellungen zu verwenden. | transliterate |
| Zusätzliche Adressbestandteile | Straßenname und Hausnummer in abgeschlossenen Validierungsdatensätzen getrennt zurückgeben, wenn verfügbar. Unterstützte Werte sind addressStreetName und addressHouseNumber. | include |
| Verarbeitung | Optimus automatisch wählen lassen, auf das Ergebnis warten oder eine Hintergrundvalidierung starten. | processing_mode |
| Wiederholungsreferenz | Stabile Referenz, mit der doppelte Arbeit vermieden wird, wenn dieselbe Validierung erneut versucht wird. | idempotency_key |
Beispielprompt für einen Datensatz:
Nutze Optimus MCP, um diesen Lieferantendatensatz mit Standardvalidierung zu validieren:
USt-IdNr. DE284700631
Unternehmen Optimus Software GmbH
Straße Tal 44
PLZ 80331
Ort Munchen
Referenz C-1001
Beispiel mit Validierungsoptionen:
Nutze Optimus MCP, um diesen Lieferantendatensatz mit qualifizierter Validierung zu validieren. Erstelle einen PDF-Bericht, gib einen Download-Link zurück, speichere einen Snapshot, verwende Transliteration und nutze supplier-check-2026-05-22-001 als Wiederholungsreferenz.
Nutze Optimus MCP, um diesen Lieferantendatensatz zu validieren, und gib Straßenname und Hausnummer im abgeschlossenen Ergebnis getrennt zurück.
Beispielprompt für eine längere Aufgabe:
Nutze Optimus MCP, um diese Lieferantendatensätze zu validieren. Verwende Standardvalidierung, behalte meine Referenz-IDs in der Zusammenfassung und fahre fort, bis das Endergebnis verfügbar ist.
Erwartetes Ergebnis:
- Gesamtstatus der Validierung.
- USt-Ergebnis pro Datensatz.
- Feldvergleichsstatus für Unternehmens- und Adressdaten, wenn verfügbar.
- Korrigierte oder normalisierte Daten, wenn Optimus sie bereitstellen kann.
- PDF-Berichtsmetadaten, wenn PDF-Erstellung Teil der Validierungsoptionen ist.
Längere Validierungen
Einige Validierungen werden sofort abgeschlossen. Größere oder länger laufende Validierungen können im Hintergrund weiterlaufen.
In diesem Fall sollte Ihr Assistent die Validierung für Sie fortsetzen. Nutzer sollten Operation IDs in derselben Unterhaltung nicht manuell kopieren müssen.
Optionen zum Fortsetzen:
| Kundenauswahl | Was angeben? | Optionsname in manchen MCP-Clients |
|---|---|---|
| Validierungsreferenz | Die Operation- oder Validierungsreferenz, die beim Start der Validierung zurückgegeben wurde. | operation_id |
| Wiederholungsreferenz | Die Wiederholungsreferenz, die beim Start der Validierung verwendet wurde. Nutzen Sie diese, wenn keine Validierungsreferenz verfügbar ist. | idempotency_key |
Beispielprompt:
Setze die Optimus Validierung fort, die du vorhin gestartet hast, und fasse das Endergebnis zusammen.
Beispiel mit Wiederholungsreferenz:
Setze die Optimus Validierung für Wiederholungsreferenz supplier-check-2026-05-22-001 fort und fasse das Endergebnis zusammen.
Tipps Für Bessere Ergebnisse
- Geben Sie beim Suchen nach USt-IdNrn. das Land zusammen mit den Unternehmensdaten an.
- Ergänzen Sie Straße, PLZ und Ort, wenn verfügbar.
- Geben Sie Ihre eigene Referenz-ID an, wenn Sie Ergebnisse Ihrem System zuordnen müssen.
- Sagen Sie dem Assistenten, ob Sie Standard- oder qualifizierte Validierung wünschen.
- Bitten Sie um eine kurze fachliche Zusammenfassung, wenn Sie keine Rohdetails benötigen.
Wann Stattdessen Die Integration API Verwenden?
Nutzen Sie die Integration API statt MCP, wenn Ihre Anwendung die vollständige technische Integration im Code steuern muss, einschließlich Wiederholungen, Antwortverarbeitung und Speicherung.