Primi passi con il server MCP per i domini

Obiettivo

Il Model Context Protocol (MCP) è uno standard aperto che permette a un assistente IA di utilizzare strumenti esterni. Il server MCP di OVHcloud espone i tuoi servizi OVHcloud sotto forma di strumenti, in modo che un assistente possa consultare e modificare la tua configurazione per tuo conto.

In pratica, questo significa che non devi più navigare tra le interfacce né scrivere chiamate API: ti basta chiedere:

Elenca i miei domini e dimmi quali scadono nei prossimi 60 giorni.

Questa guida spiega come collegare un agente IA al server MCP di OVHcloud e utilizzarlo per gestire i tuoi domini, i tuoi record DNS e i tuoi reindirizzamenti.

Prerequisiti

• Essere connesso al tuo Spazio Cliente OVHcloud
• Avere installato un client MCP compatibile (consulta Collegare il tuo agente)
• Disporre di un browser per completare l'autenticazione OAuth2

Procedura

1 — Come funziona MCP

Entrano in gioco tre componenti:

Non richiami mai uno strumento per nome. Descrivi ciò che desideri, l'agente seleziona lo strumento adeguato e ti chiede conferma prima di modificare qualsiasi cosa.

2 — L'hub MCP di OVHcloud

L'hub MCP di OVHcloud elenca i servizi esposti sotto forma di strumenti MCP ed è il riferimento per sapere cosa è attualmente disponibile.

Scegli l'URL corrispondente alla region del tuo account OVHcloud:

Sostituisci {section} con il nome della sezione a cui desideri collegarti, così come appare sulle schede dell'hub. Ti colleghi sempre a una sezione precisa: non esiste un URL globale che esponga tutti gli strumenti contemporaneamente.

Sezioni per i domini

Due sezioni coprono i domini, una per versione dell'API:

L'URL da utilizzare è quindi https://mcp.eu.ovhcloud.com/mcp/v1_domain per un account europeo sull'API v1.

Ad oggi, l'API v1 resta la più completa a livello funzionale: v1_domain espone quindi un insieme di strumenti più ampio rispetto a v2_domain. L'API v2 si arricchisce progressivamente.

Per capire cosa distingue l'API v2 dall'API v1, consulta la guida OVHcloud API v2 - Principles of operation.

Puoi aggiungere l'una, l'altra o entrambe contemporaneamente. v1_domain da sola è sufficiente per effettuare tutte le operazioni di questa guida.

3 — Collegare il tuo agente a MCP

L'autenticazione si basa su OAuth2: la prima volta che il tuo agente contatta il server, si apre una finestra del browser sulla pagina di autenticazione OVHcloud. Una volta effettuato l'accesso, l'agente riutilizza quella sessione per le sue chiamate MCP.

$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

Per verificare che la connessione funzioni, poni al tuo agente una domanda di sola lettura:

Elenca i miei domini OVHcloud.

4 — Visualizzare le informazioni di un dominio

Inizia chiedendo l'elenco dei tuoi domini, poi richiedi i dettagli di uno di essi.

Esempio di richiesta:

Mostrami i dettagli di mydomain.ovh: data di scadenza, server DNS e stato del blocco del trasferimento.

5 — Ordinare un dominio

L'ordine di un dominio si effettua con lo strumento order-new-domain-name, disponibile nella sezione v1_domain.

Esempio di richiesta:

Ordina mydomain.ovh per un anno.

Prima di qualsiasi acquisto, chiedi una simulazione. Lo strumento accetta un parametro dryRun: impostato su true, verifica la disponibilità del nome e calcola il prezzo senza impegnare né fatturare nulla.

Simula l'ordine di mydomain.ovh per un anno.

Il tuo agente mostra quindi il preventivo (prezzo, durata e configurazione che sarà applicata al dominio) e attende la tua approvazione prima di proseguire.

Una volta che hai approvato il preventivo, l'agente ripete la chiamata con dryRun impostato su false. L'ordine diventa definitivo: l'API restituisce l'URL del buono d'ordine. Il tuo agente ti comunica questo URL direttamente nella sua risposta: aprilo nel browser per pagare l'ordine. Trovi questo buono d'ordine anche nel tuo Spazio Cliente OVHcloud, nella sezione I miei ordini.

6 — Modificare un record DNS

Strumenti associati: create-domain-zone-record per aggiungere un record, delete-domain-zone-record per eliminarne uno e get-domain-zone-details per consultare la zona.

Esempi di richieste:

Modifica il record A di www.mydomain.ovh in 203.0.113.42.

Non hai bisogno di sapere quale tipo di record modificare. Descrivi il risultato che ti aspetti: il tuo agente individua il record interessato, ti spiega cosa sta per modificare e attende la tua approvazione prima di applicare la modifica.

Il mio sito è ora ospitato su un server il cui indirizzo IP è 203.0.113.42.
Fai in modo che www.mydomain.ovh punti a quell'indirizzo.

La propagazione su Internet può poi richiedere fino a 24 ore, in base al TTL del record.

7 — Creare un reindirizzamento

Un reindirizzamento invia i visitatori del tuo dominio verso un altro indirizzo.

Esempio di richiesta:

Reindirizza blog.mydomain.ovh verso https://mydomain.ovh/notizie, mantenendo l'indirizzo visibile nel browser.

8 — Le altre operazioni coperte

Le sezioni v1_domain e v2_domain espongono le route corrispondenti dell'API OVHcloud sotto forma di strumenti: qualsiasi operazione realizzabile sui tuoi domini tramite l'API lo è anche tramite MCP. Oltre alle operazioni descritte sopra, questo comprende ad esempio:

• DNSSEC: attivazione, disattivazione e gestione dei record DS
• Protezione contro il trasferimento: blocco e sblocco
• Gestione dei contatti: proprietario, amministratore, tecnico e di fatturazione
• Server DNS e record glue
• Identificativi e record DynHost (DNS dinamico)
• Backup, ripristino, importazione ed esportazione della zona
• Gestione delle operazioni: accelerazione, annullamento, rilancio
• Recupero del codice AuthInfo e approvazione dei trasferimenti in uscita

Se non sei certo che un'operazione sia possibile, chiedi al tuo agente di spiegarti cosa è in grado di fare sui tuoi domini.

Per saperne di più

Order a Domain Name

Configure the DNS of your Domain Name

Reindirizzare un dominio gestito da OVHcloud

AI Endpoints - Model Context Protocol (MCP) with LangChain4j

Contatta la nostra community di utenti.