Primeros pasos con el servidor MCP para nombres de dominio

Objetivo

El Model Context Protocol (MCP) es un estándar abierto que permite a un asistente de IA utilizar herramientas externas. El servidor MCP de OVHcloud expone sus servicios de OVHcloud en forma de herramientas, de modo que un asistente pueda consultar y modificar su configuración en su nombre.

En la práctica, esto significa que ya no tiene que navegar por las interfaces ni escribir llamadas a la API. Basta con preguntar:

Enumera mis nombres de dominio e indícame cuáles caducan en los próximos 60 días.

Esta guía explica cómo conectar un agente de IA al servidor MCP de OVHcloud y utilizarlo para gestionar sus nombres de dominio, sus registros DNS y sus redirecciones.

Requisitos

• Estar conectado a su área de cliente de OVHcloud
• Tener instalado un cliente MCP compatible (consulte Conectar su agente)
• Disponer de un navegador para completar la autenticación OAuth2

Procedimiento

1 — Cómo funciona MCP

Intervienen tres componentes:

Usted nunca invoca una herramienta por su nombre. Describe lo que desea, el agente selecciona la herramienta adecuada y le pide confirmación antes de modificar nada.

2 — El hub MCP de OVHcloud

El hub MCP de OVHcloud recoge los servicios expuestos en forma de herramientas MCP y es la referencia para saber qué está disponible actualmente.

Elija la URL correspondiente a la región de su cuenta de OVHcloud:

Sustituya {section} por el nombre de la sección a la que desea conectarse, tal y como aparece en las tarjetas del hub. Siempre se conecta a una sección concreta: no existe una URL global que exponga todas las herramientas a la vez.

Secciones para los nombres de dominio

Dos secciones cubren los nombres de dominio, una por versión de la API:

Así pues, la URL que debe utilizarse es https://mcp.eu.ovhcloud.com/mcp/v1_domain para una cuenta europea en la API v1.

A día de hoy, la API v1 sigue siendo la más completa en cuanto a funcionalidades: v1_domain expone por tanto un conjunto de herramientas más amplio que v2_domain. La API v2 se enriquece progresivamente.

Para entender qué diferencia la API v2 de la API v1, consulte la guía OVHcloud API v2 - Principles of operation.

Puede añadir una, otra o ambas simultáneamente. v1_domain por sí sola basta para realizar todas las operaciones de esta guía.

3 — Conectar su agente a MCP

La autenticación utiliza OAuth2: la primera vez que su agente contacta con el servidor, se abre una ventana del navegador en la página de conexión de OVHcloud. Una vez que haya iniciado sesión, el agente reutiliza esa sesión para sus llamadas 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

Para comprobar que la conexión funciona, plantee a su agente una pregunta de solo lectura:

Enumera mis nombres de dominio de OVHcloud.

4 — Mostrar la información de un nombre de dominio

Empiece por pedir la lista de sus dominios y solicite después los detalles de uno de ellos.

Ejemplo de petición:

Muéstrame los detalles de mydomain.ovh: fecha de expiración, servidores DNS y estado del bloqueo de transferencia.

5 — Contratar un nombre de dominio

La contratación de un nombre de dominio se realiza con la herramienta order-new-domain-name, disponible en la sección v1_domain.

Ejemplo de petición:

Contrata el dominio mydomain.ovh durante un año.

Antes de comprar nada, pida una simulación. La herramienta acepta un parámetro dryRun: con el valor true, comprueba la disponibilidad del nombre y calcula el precio sin contratar ni facturar nada.

Simula la contratación de mydomain.ovh durante un año.

Su agente mostrará entonces el presupuesto —precio, duración y configuración que se aplicará al dominio— y esperará su conformidad antes de continuar.

Una vez validado el presupuesto, el agente repite la llamada con dryRun en false. El pedido pasa a ser firme: la API devuelve la URL de la orden de pedido. Su agente le facilita esa URL directamente en su respuesta: ábrala en su navegador para pagar el pedido. También encontrará esta orden de pedido en el área de cliente de OVHcloud, en la sección Mis pedidos.

6 — Modificar un registro DNS

Herramientas asociadas: create-domain-zone-record para añadir un registro, delete-domain-zone-record para eliminar uno y get-domain-zone-details para consultar la zona.

Ejemplos de peticiones:

Cambia el registro A de www.mydomain.ovh a 203.0.113.42.

No necesita saber qué tipo de registro hay que modificar. Describa el resultado que espera: su agente identificará el registro afectado, le explicará qué va a cambiar y esperará su conformidad antes de aplicarlo.

Mi sitio web está alojado ahora en un servidor cuya dirección IP es 203.0.113.42.
Haz que www.mydomain.ovh apunte a él.

Después, la propagación por Internet puede tardar hasta 24 horas, en función del TTL del registro.

7 — Crear una redirección

Una redirección envía a los visitantes de su dominio hacia otra dirección.

Ejemplo de petición:

Redirige blog.mydomain.ovh a https://mydomain.ovh/noticias, manteniendo visible la dirección en el navegador.

8 — Las demás operaciones cubiertas

Las secciones v1_domain y v2_domain exponen las rutas correspondientes de la API de OVHcloud en forma de herramientas: cualquier operación que pueda realizarse sobre sus nombres de dominio a través de la API está también disponible mediante MCP. Más allá de las tareas anteriores, esto abarca, por ejemplo:

• DNSSEC: activación, desactivación y gestión de los registros DS
• Protección de transferencia: bloqueo y desbloqueo
• Gestión de los contactos: titular, administrador, técnico y de facturación
• Servidores DNS y registros glue
• Usuarios y registros DynHost (DNS dinámico)
• Copia de seguridad, restauración, importación y exportación de la zona
• Gestión de las tareas: aceleración, cancelación, relanzamiento
• Obtención del código AuthInfo y aprobación de las transferencias salientes

Si no está seguro de que una operación sea posible, pida a su agente que le explique lo que es capaz de hacer con sus nombres de dominio.

Más información

Order a Domain Name

Configure the DNS of your Domain Name

Redirigir un nombre de dominio gestionado por OVHcloud

AI Endpoints - Model Context Protocol (MCP) with LangChain4j

Interactúe con nuestra comunidad de usuarios.