Débuter avec le serveur MCP pour les noms de domaine
Connectez un agent IA au serveur MCP d'OVHcloud pour gérer vos noms de domaine, vos enregistrements DNS et vos redirections en langage naturel
Le serveur MCP d’OVHcloud est en cours de développement actif. La liste des outils disponibles s’enrichit régulièrement : une fonctionnalité absente aujourd’hui peut être disponible peu de temps après. Consultez le hub MCP d’OVHcloud pour connaître l’inventaire à jour.
Objectif
Le Model Context Protocol (MCP) est un standard ouvert qui permet à un assistant IA d’utiliser des outils externes. Le serveur MCP d’OVHcloud expose vos services OVHcloud sous forme d’outils, afin qu’un assistant puisse consulter et modifier votre configuration pour vous.
Concrètement, vous n’avez plus besoin de naviguer dans une interface ni d’écrire des appels API : vous demandez simplement :
Ce guide vous explique comment connecter un agent IA au serveur MCP d’OVHcloud et l’utiliser pour gérer vos noms de domaine, vos enregistrements DNS et vos redirections.
Prérequis
- Être connecté à votre
- Avoir installé un client MCP compatible (voir Connecter votre agent)
- Disposer d’un navigateur, pour réaliser l’étape de connexion OAuth2
En pratique
1 — Le fonctionnement de MCP
Trois éléments interviennent :
Vous n’appelez jamais un outil par son nom. Vous décrivez votre besoin, l’agent sélectionne l’outil correspondant, et il vous demande confirmation avant toute modification.
Un agent IA connecté à MCP agit avec vos droits. Lisez chaque demande de confirmation avant de l’accepter, en particulier pour les opérations qui suppriment des enregistrements ou modifient des serveurs DNS.
2 — Le hub MCP d’OVHcloud
Le hub MCP d’OVHcloud recense les services exposés sous forme d’outils MCP. C’est la référence pour savoir ce qui est disponible.
Choisissez l’URL correspondant à la région de votre compte OVHcloud :
{section} est à remplacer par le nom de la section à laquelle vous souhaitez vous connecter, tel qu’il apparaît sur les cartes du hub. Vous vous connectez toujours à une section précise : il n’existe pas d’URL globale exposant l’ensemble des outils.
Sections pour les noms de domaine
Deux sections couvrent les noms de domaine, une par version d’API :
L’URL à utiliser est donc https://mcp.eu.ovhcloud.com/mcp/v1_domain pour un compte européen sur l’API v1.
À ce jour, l’API v1 reste la plus complète en termes de fonctionnalités : v1_domain expose donc un jeu d’outils plus large que v2_domain. L’API v2 s’enrichit progressivement.
Pour comprendre ce qui distingue l’API v1 de l’API v2, consultez le guide « API v2 OVHcloud - Principes de fonctionnement ».
Vous pouvez ajouter l’une, l’autre, ou les deux simultanément. v1_domain seule suffit à réaliser toutes les opérations de ce guide.
3 — Connecter votre agent à MCP
L’authentification repose sur OAuth2 : au premier contact de votre agent avec le serveur, une fenêtre de navigateur s’ouvre sur la page de connexion OVHcloud. Une fois que vous êtes connecté, l’agent réutilise cette session pour ses appels MCP.
Aucun en-tête HTTP personnalisé n’est nécessaire : le flux OAuth2 fournit les identifiants. Les instructions de configuration d’OVHcloud précisent de laisser vide la section des en-têtes de votre configuration client.
SHAI est l’agent en terminal d’OVHcloud. La version 0.1.5 ou supérieure est requise.
Créez le fichier de configuration suivant, à partir du modèle .ovh.config disponible dans le dépôt SHAI :
Déclarez sous tools.mcp une entrée par section que vous souhaitez utiliser. Cet exemple active les deux versions de l’API :
Remplacez les points d’accès par ceux de votre région.
N’ajoutez aucun identifiant dans ce fichier à la main. Après votre connexion, SHAI y inscrit lui-même un access_token et un expires_at dans le bloc config de chaque serveur. Ces valeurs sont des secrets personnels : ne versionnez jamais ce fichier et ne le partagez pas en l’état.
Démarrez ensuite l’agent. Votre navigateur s’ouvre sur la page de connexion OVHcloud : identifiez-vous pour finaliser la connexion.
Pour vérifier que la connexion fonctionne, posez à votre agent une question en lecture seule :
4 — Afficher les informations d’un nom de domaine
Commencez par lister vos noms de domaine, puis demandez le détail de l’un d’eux.
Exemple de demande :
5 — Commander un nom de domaine
La commande d’un nom de domaine s’effectue avec l’outil order-new-domain-name, disponible dans la section v1_domain.
Exemple de demande :
Avant tout achat, demandez une simulation. L’outil accepte un paramètre dryRun : positionné à true, il vérifie la disponibilité du nom et calcule le tarif sans rien engager ni facturer.
Votre agent affiche alors le devis — le prix, la durée et la configuration qui seront appliqués au nom de domaine — puis attend votre accord avant d’aller plus loin.
Une fois le devis validé, l’agent relance l’appel avec dryRun à false. La commande devient ferme : l’API retourne l’URL du bon de commande. Votre agent vous transmet cette URL directement dans sa réponse : ouvrez-la dans votre navigateur pour régler la commande. Vous retrouverez également ce bon de commande dans votre espace client OVHcloud, dans la section .
Le bon de commande doit être réglé pour que l’enregistrement soit transmis au registre. Votre agent ne peut pas payer à votre place : suivez l’URL du bon de commande qu’il vous a retournée pour effectuer le paiement. Tant que celui-ci n’est pas encaissé, le nom de domaine reste disponible pour un tiers.
Valider la commande génère un bon de commande réel et facturable sur votre compte OVHcloud. Lisez la demande de confirmation de votre agent avant de l’accepter, et vérifiez le nom de domaine et la durée : un enregistrement ne s’annule pas comme une modification de configuration.
6 — Modifier un enregistrement DNS
Outils associés : create-domain-zone-record pour ajouter un enregistrement, delete-domain-zone-record pour en supprimer un, et get-domain-zone-details pour inspecter la zone.
Exemples de demandes :
Vous n’avez pas besoin de savoir quel type d’enregistrement modifier. Décrivez le résultat que vous attendez : votre agent identifie l’enregistrement concerné, vous explique ce qu’il va changer et attend votre accord avant d’appliquer.
Un enregistrement DNS modifié ne devient actif qu’après le rafraîchissement de la zone. Si vous omettez cette étape, votre modification est enregistrée mais jamais appliquée. Demandez explicitement à votre agent de rafraîchir la zone, ou vérifiez qu’il l’a fait.
La propagation sur Internet peut ensuite prendre jusqu’à 24 heures, selon le TTL de l’enregistrement.
7 — Créer une redirection
Une redirection envoie les visiteurs de votre domaine vers une autre adresse.
Exemple de demande :
8 — Les autres opérations couvertes
Les sections v1_domain et v2_domain exposent les routes correspondantes de l’API OVHcloud sous forme d’outils : toute opération réalisable sur vos noms de domaine via l’API l’est également via MCP. Au-delà des tâches ci-dessus, cela couvre par exemple :
- DNSSEC : activation, désactivation et gestion des enregistrements DS
- Protection de transfert : verrouillage et déverrouillage
- Gestion des contacts : propriétaire, administrateur, technique et facturation
- Serveurs DNS et enregistrements glue
- Identifiants et enregistrements DynHost (DNS dynamique)
- Sauvegarde, restauration, import et export de zone
- Gestion des tâches : accélération, annulation, relance
- Récupération du code AuthInfo et approbation des transferts sortants
Si vous n’êtes pas certain qu’une opération soit possible, demandez à votre agent de vous expliquer ce qu’il est capable de faire sur vos noms de domaine.
Aller plus loin
Commander un nom de domaine avec l’API OVHcloud
Configurer les DNS de son nom de domaine
Rediriger un nom de domaine géré par OVHcloud
AI Endpoints - Model Context Protocol (MCP) avec LangChain4j
Informations sur l’administration des services OVHcloud et sur la manière d’obtenir l’assistance appropriée
Lors de l’utilisation des guides OVHcloud, veuillez tenir compte des points suivants :
- Les instructions visent à fournir un maximum de détails, mais ne peuvent pas couvrir tous les cas d’utilisation particuliers. Il peut être nécessaire d’adapter les actions décrites à vos besoins.
- L’écosystème OVHcloud est conçu pour offrir flexibilité et liberté de choix. Vous êtes donc responsable de la configuration correcte et sécurisée de vos services. Afin d’éviter toute perte de données, nous vous recommandons vivement de mettre en place des stratégies de sauvegarde pour toutes vos données importantes.
- Nos guides et tutoriels peuvent faire référence à des logiciels ou services tiers utilisés en combinaison avec les solutions OVHcloud. Le support technique fourni par OVHcloud n’inclut pas la configuration de systèmes ou de produits ne relevant pas de notre responsabilité. Cela inclut notamment :
- Les systèmes d’exploitation et les interfaces utilisateur (Windows, Debian, Plesk, etc.).
- Tout autre logiciel tiers (clients FTP, logiciels de messagerie, etc.).
- Les services proposés par d’autres fournisseurs (DNS, API, interfaces utilisateur, etc.).
- Le matériel personnel utilisé avec nos services VoIP (téléphone IP, iPBX, etc.).
- Le matériel personnel utilisé avec nos offres d’accès internet (modem, routeur, etc.).
Pour recevoir l’assistance appropriée en cas de problème, suivez ces recommandations :
- Vous souhaitez obtenir des conseils personnalisés ou discuter d’un sujet qui n’est pas traité en détail dans notre documentation ?
Rejoignez la communauté OVHcloud pour y rechercher votre sujet et échanger avec d’autres utilisateurs. - Vous devez signaler un incident concernant votre service OVHcloud ou vous rencontrez des difficultés dans l’espace client OVHcloud ?
Créez une demande d’assistance dans notre centre d’aide. - Vous avez besoin d’une assistance professionnelle pour votre projet ou d’aide pour des tâches en dehors de notre périmètre de support ?
Consultez notre portail des partenaires pour trouver des experts des solutions OVHcloud. - Vous recherchez des informations plus détaillées sur nos niveaux de support et Professional Services ?
Consultez nos pages niveaux de support OVHcloud et OVHcloud Professional Services.
Vous pouvez participer à l’amélioration de notre documentation :
- Vous souhaitez faire un retour pour améliorer un guide ou signaler des informations insuffisantes sur une page spécifique ?
Utilisez les boutons « Cette page vous a-t-elle aidé ? » en bas de page pour nous en informer. - Vous souhaitez proposer directement une modification de la documentation ?
Utilisez la fonction « Modifier cette page », disponible en bas de page et dans la barre latérale.
Échangez avec notre communauté d’utilisateurs.