OpusDNS MCP Server in der Praxis: Was kann ich damit machen?

Dieser Artikel zeigt anhand konkreter Beispiele, wie sich der OpusDNS MCP Server im Alltag nutzen lässt, sobald er verbunden ist. Grundlagen zu Tools und Verbindung stehen in den verlinkten Artikeln am Ende.

Beispiel 1: Eine einzelne Domain verlängern

Aufgabe: "Verlängere example.com um ein Jahr."

Ablauf im Hintergrund:

1. search_operations sucht nach "renew domain" und findet die passende Operation
2. describe_operation zeigt die nötigen Parameter, hier Domainname und Laufzeit
3. call_operation führt die Operation mit den konkreten Werten aus

Da es sich um eine Schreiboperation handelt, erscheint vorher eine Freigabeanfrage mit den genauen Details. Erst nach Bestätigung wird die Domain tatsächlich verlängert.

Beispiel 2: Überblick über das eigene Portfolio

Aufgabe: "Wie viele Domains habe ich und was läuft bald ab?"

Hier reicht ein einziger Aufruf von portfolio_summary, ohne weitere Parameter. Das Ergebnis liefert Gesamtzahlen und einen Ausblick auf anstehende Ablaufdaten, eine gute Ausgangsfrage für regelmäßige Checks.

Beispiel 3: Gezielt nach ablaufenden Domains filtern

Aufgabe: "Zeig mir alle .com Domains, die in den nächsten 30 Tagen ablaufen, nur Name und Ablaufdatum."

Dafür ist portfolio_query gedacht. Man filtert nach TLD und Ablaufzeitraum und lässt nur die benötigten Felder zurückgeben. So bleibt die Antwort kompakt, auch bei großen Portfolios mit tausenden Domains.

Beispiel 4: Mehrere Domains auf einmal gegen Transfer sperren

Aufgabe: "Sperre alle .com Domains, die in 30 Tagen ablaufen, gegen Transfer."

Das ist der klassische Bulk Fall, umgesetzt in zwei Schritten:

1. bulk_preview mit dem Selector {"tld": ["com"], "expires_in_30_days": true} zeigt vorab, wie viele Domains betroffen wären, zum Beispiel "matchedDomains: 412", ohne dass etwas verändert wird
2. bulk_submit mit denselben Parametern reicht die Änderung ein. Die Freigabeanfrage nennt die exakte Menge, etwa "Approve: domain_update_bulk on 412 domain(s) matching expires_in_30_days=true"

Nach der Bestätigung entsteht ein Batch, dessen Fortschritt sich mit job_batch_status verfolgen lässt (queued, running, succeeded, failed). Läuft etwas falsch oder soll pausiert werden, übernimmt job_batch_control das Pausieren, Fortsetzen, Wiederholen oder Abbrechen, auch das mit Freigabe.

Praktischer Vorteil: Domains werden serverseitig über den Selector aufgelöst, es muss keine Liste manuell zusammengestellt oder abgetippt werden.

Beispiel 5: Arbeiten mit Unterorganisationen

Aufgabe: "Zeig mir das Portfolio von Kunde X" (bei Reseller Strukturen)

Hier wird bei jedem Aufruf die organizationId der Zielorganisation mitgegeben. Wichtig bei Bulk Aktionen: bulk_preview und bulk_submit müssen dieselbe organizationId erhalten, sonst betrifft die Ausführung eine andere Domainmenge als die Vorschau. Die Freigabeanfrage zeigt immer an, für welche Organisation die Aktion gilt.

Beispiel 6: Eine unbekannte Aufgabe angehen

Aufgabe: "Kann ich eine Domain sperren lassen, damit sie nicht versehentlich gelöscht wird?"

Wenn nicht klar ist, welche Operation dafür existiert, ist search_operations der Einstiegspunkt. Ergebnisse werden mit describe_operation genauer geprüft, bevor überhaupt etwas ausgeführt wird. So lässt sich die API auch ohne Auswendiglernen von Endpunktnamen erkunden.

• • Für Massenänderungen immer bulk_preview vor bulk_submit nutzen, nie einzelne call_operation Aufrufe in einer Schleife
  • Bei portfolio_query nur die Felder anfragen, die wirklich gebraucht werden
  • Freigabeanfragen genau lesen, sie zeigen die exakte Domainmenge und Aktion
  • Bei Reseller Konten die organizationId konsequent bei jedem Aufruf mitgeben