Erste Schritte mit dem MCP-Server für Domainnamen

Ziel

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem ein KI-Assistent externe Tools nutzen kann. Der MCP-Server von OVHcloud stellt Ihre OVHcloud Dienste als solche Tools bereit, sodass ein Assistent Ihre Konfiguration in Ihrem Namen lesen und ändern kann.

In der Praxis bedeutet das: Statt sich durch Oberflächen zu klicken oder API-Aufrufe zu schreiben, fragen Sie einfach:

Liste meine Domainnamen auf und sage mir, welche davon in den nächsten 60 Tagen ablaufen.

Diese Anleitung erklärt, wie Sie einen KI-Agenten mit dem MCP-Server von OVHcloud verbinden und damit Ihre Domainnamen, DNS-Einträge und Weiterleitungen verwalten.

Voraussetzungen

• In Ihrem OVHcloud Kundencenter angemeldet sein
• Ein installierter, kompatibler MCP-Client (siehe Ihren Agenten verbinden)
• Ein Browser, um die OAuth2-Anmeldung abzuschließen

In der praktischen Anwendung

1 — Funktionsweise von MCP

Daran sind drei Komponenten beteiligt:

Sie rufen ein Tool nie selbst über seinen Namen auf. Sie beschreiben, was Sie erreichen möchten, der Agent wählt das passende Tool aus und bittet Sie um Bestätigung, bevor etwas geändert wird.

2 — Der MCP-Hub von OVHcloud

Der MCP-Hub von OVHcloud listet die als MCP-Tools bereitgestellten Dienste auf und ist die Referenz dafür, was aktuell verfügbar ist.

Wählen Sie die URL, die der Region Ihres OVHcloud Kontos entspricht:

Ersetzen Sie {section} durch den Namen des Bereichs, mit dem Sie sich verbinden möchten, so wie er auf den Karten des Hubs angezeigt wird. Sie verbinden sich immer mit einem bestimmten Bereich: Es gibt keine globale URL, die alle Tools auf einmal bereitstellt.

Bereiche für Domainnamen

Zwei Bereiche decken Domainnamen ab, einer pro API-Version:

Für ein europäisches Konto mit der API v1 lautet die zu verwendende URL also https://mcp.eu.ovhcloud.com/mcp/v1_domain.

Die API v1 ist nach wie vor die funktional umfangreichste: v1_domain stellt daher mehr Tools bereit als v2_domain. Die API v2 wird schrittweise erweitert.

Um die Unterschiede zwischen der API v2 und der API v1 zu verstehen, lesen Sie die Anleitung OVHcloud API v2 - Principles of operation.

Sie können den einen, den anderen oder beide Bereiche gleichzeitig hinzufügen. v1_domain allein genügt für alle Vorgänge dieser Anleitung.

3 — Ihren Agenten mit MCP verbinden

Die Authentifizierung erfolgt über OAuth2: Beim ersten Kontakt Ihres Agenten mit dem Server öffnet sich ein Browserfenster mit der OVHcloud Login-Seite. Nach Ihrer Anmeldung verwendet der Agent diese Sitzung für seine MCP-Aufrufe weiter.

$HOME/.config/shai/agents/ovh.config

{
  "name": "ovh",
  "description": "OVH agent with OVH MCP server for cloud management and API calls",
  "tools": {
    "builtin": ["*"],
    "builtin_excluded": [],
    "mcp": {
      "v1_domain": {
        "config": {
          "type": "http",
          "url": "https://mcp.eu.ovhcloud.com/mcp/v1_domain"
        },
        "enabled_tools": ["*"]
      },
      "v2_domain": {
        "config": {
          "type": "http",
          "url": "https://mcp.eu.ovhcloud.com/mcp/v2_domain"
        },
        "enabled_tools": ["*"]
      }
    }
  },
  "system_prompt": "{{CODER_BASE_PROMPT}}",
  "max_tokens": 4096,
  "temperature": 0.3
}

claude mcp add --transport http v1_domain https://mcp.eu.ovhcloud.com/mcp/v1_domain
claude mcp add --transport http v2_domain https://mcp.eu.ovhcloud.com/mcp/v2_domain

/mcp

Um zu prüfen, ob die Verbindung funktioniert, stellen Sie Ihrem Agenten eine Frage, die nur Daten abruft:

Liste meine OVHcloud Domainnamen auf.

4 — Informationen zu einem Domainnamen anzeigen

Lassen Sie sich zunächst Ihre Domainnamen auflisten und fragen Sie dann die Details zu einem davon ab.

Beispielanfrage:

Zeige mir die Details von mydomain.ovh: Ablaufdatum, Nameserver und ob die Transfersperre aktiv ist.

5 — Einen Domainnamen bestellen

Die Bestellung eines Domainnamens erfolgt mit dem Tool order-new-domain-name aus dem Bereich v1_domain.

Beispielanfrage:

Bestelle mydomain.ovh für ein Jahr.

Fordern Sie vor jedem Kauf eine Simulation an. Das Tool akzeptiert einen Parameter dryRun: Auf true gesetzt, prüft es die Verfügbarkeit des Namens und berechnet den Preis, ohne etwas verbindlich zu bestellen oder in Rechnung zu stellen.

Simuliere die Bestellung von mydomain.ovh für ein Jahr.

Ihr Agent zeigt daraufhin das Angebot an – Preis, Laufzeit und die Konfiguration, die auf den Domainnamen angewendet wird – und wartet auf Ihre Zustimmung, bevor er fortfährt.

Sobald Sie das Angebot bestätigt haben, führt der Agent den Aufruf erneut mit dryRun auf false aus. Die Bestellung wird damit verbindlich: Die API gibt die URL des Bestellscheins zurück. Ihr Agent übermittelt Ihnen diese URL direkt in seiner Antwort: Öffnen Sie sie in Ihrem Browser, um die Bestellung zu bezahlen. Sie finden diesen Bestellschein auch im OVHcloud Kundencenter unter Meine Bestellungen.

6 — Einen DNS-Eintrag ändern

Zugehörige Tools: create-domain-zone-record, um einen Eintrag hinzuzufügen, delete-domain-zone-record, um einen zu löschen, und get-domain-zone-details, um die Zone einzusehen.

Beispielanfragen:

Ändere den A-Eintrag von www.mydomain.ovh auf 203.0.113.42.

Sie müssen nicht wissen, welcher Eintragstyp geändert werden muss. Beschreiben Sie das gewünschte Ergebnis: Ihr Agent ermittelt den betroffenen Eintrag, erklärt Ihnen, was er ändern wird, und wartet auf Ihre Zustimmung, bevor er die Änderung anwendet.

Meine Website wird jetzt auf einem Server mit der IP-Adresse 203.0.113.42 gehostet.
Sorge dafür, dass www.mydomain.ovh darauf zeigt.

Die Propagation im Internet kann anschließend je nach TTL des Eintrags bis zu 24 Stunden dauern.

7 — Eine Weiterleitung erstellen

Eine Weiterleitung führt die Besucher Ihres Domainnamens auf eine andere Adresse.

Beispielanfrage:

Leite blog.mydomain.ovh auf https://mydomain.ovh/news weiter. Die Adresse soll im Browser sichtbar bleiben.

8 — Weitere abgedeckte Vorgänge

Die Bereiche v1_domain und v2_domain stellen die entsprechenden Routen der OVHcloud API als Tools bereit: Jeder Vorgang, den Sie über die API für Ihre Domainnamen ausführen können, ist auch über MCP möglich. Über die oben genannten Aufgaben hinaus umfasst das zum Beispiel:

• DNSSEC: Aktivierung, Deaktivierung und Verwaltung der DS-Einträge
• Transfersperre: Aktivierung und Deaktivierung
• Verwaltung der Kontakte: Inhaber, Administrator-Kontakt, technischer Kontakt und Rechnungskontakt
• Nameserver und Glue Records
• DynHost-Zugangsdaten und -Einträge (dynamisches DNS)
• Sicherung, Wiederherstellung, Import und Export der Zone
• Verwaltung der Aufgaben: Beschleunigung, Abbruch, Neustart
• Abruf des AuthInfo-Codes und Freigabe ausgehender Transfers

Wenn Sie nicht sicher sind, ob ein Vorgang möglich ist, bitten Sie Ihren Agenten, Ihnen zu erklären, was er mit Ihren Domainnamen tun kann.

Weiterführende Informationen

Order a Domain Name

Configure the DNS of your Domain Name

Weiterleitung von bei OVHcloud verwalteten Domainnamen

AI Endpoints - Model Context Protocol (MCP) with LangChain4j

Treten Sie unserer User Community bei.