Primeiros passos com o servidor MCP para nomes de domínio

Objetivo

O Model Context Protocol (MCP) é uma norma aberta que permite a um assistente de IA utilizar ferramentas externas. O servidor MCP da OVHcloud expõe os seus serviços OVHcloud sob a forma de ferramentas, para que um assistente possa consultar e alterar a sua configuração em seu nome.

Na prática, isto significa que deixa de ter de navegar pelas interfaces ou de escrever chamadas à API: basta pedir:

Lista os meus nomes de domínio e diz-me quais expiram nos próximos 60 dias.

Este guia explica como ligar um agente de IA ao servidor MCP da OVHcloud e utilizá-lo para gerir os seus nomes de domínio, os seus registos DNS e os seus reencaminhamentos.

Requisitos

• Ter acesso à Área de Cliente OVHcloud
• Ter instalado um cliente MCP compatível (consulte Ligar o seu agente)
• Dispor de um navegador para concluir a autenticação OAuth2

Instruções

1 — Como funciona o MCP

Estão envolvidos três componentes:

Nunca invoca uma ferramenta pelo nome. Descreve o que pretende, o agente seleciona a ferramenta adequada e pede-lhe confirmação antes de alterar seja o que for.

2 — O hub MCP da OVHcloud

O hub MCP da OVHcloud reúne os serviços expostos sob a forma de ferramentas MCP e é a referência para saber o que está atualmente disponível.

Escolha o URL correspondente à região da sua conta OVHcloud:

Substitua {section} pelo nome da secção à qual pretende ligar-se, tal como aparece nos cartões do hub. Liga-se sempre a uma secção específica: não existe um URL global que exponha todas as ferramentas de uma só vez.

Secções para os nomes de domínio

Duas secções abrangem os nomes de domínio, uma por versão da API:

O URL a utilizar é, portanto, https://mcp.eu.ovhcloud.com/mcp/v1_domain para uma conta europeia na API v1.

Atualmente, a API v1 continua a ser a mais completa em termos de funcionalidades: v1_domain expõe, por isso, um conjunto de ferramentas mais alargado do que v2_domain. A API v2 vai sendo enriquecida progressivamente.

Para compreender o que distingue a API v2 da API v1, consulte o guia OVHcloud API v2 - Principles of operation.

Pode adicionar uma, outra ou ambas em simultâneo. A v1_domain só por si é suficiente para realizar todas as operações deste guia.

3 — Ligar o seu agente ao MCP

A autenticação utiliza OAuth2: na primeira vez que o seu agente contacta o servidor, abre-se uma janela do navegador na página de autenticação da OVHcloud. Depois de iniciar sessão, o agente reutiliza essa sessão para as suas chamadas 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 confirmar que a ligação funciona, coloque uma pergunta apenas de leitura ao seu agente:

Lista os meus nomes de domínio OVHcloud.

4 — Consultar as informações de um nome de domínio

Comece por pedir a lista dos seus domínios e peça depois os detalhes de um deles.

Exemplo de pedido:

Mostra-me os detalhes de mydomain.ovh: data de expiração, servidores DNS e estado do bloqueio de transferência.

5 — Encomendar um nome de domínio

A encomenda de um nome de domínio efetua-se com a ferramenta order-new-domain-name, disponível na secção v1_domain.

Exemplo de pedido:

Encomenda mydomain.ovh por um ano.

Antes de comprar seja o que for, peça uma simulação. A ferramenta aceita um parâmetro dryRun: definido como true, verifica a disponibilidade do nome e calcula o preço sem contratar nem faturar nada.

Simula a encomenda de mydomain.ovh por um ano.

O seu agente apresenta então o orçamento — preço, duração e configuração que será aplicada ao domínio — e aguarda a sua aprovação antes de prosseguir.

Assim que validar o orçamento, o agente repete a chamada com dryRun a false. A encomenda passa a ser definitiva: a API devolve o URL da nota de encomenda. O seu agente transmite-lhe esse URL diretamente na sua resposta: abra-o no seu navegador para pagar a encomenda. Encontrará igualmente esta nota de encomenda na sua Área de Cliente OVHcloud, na secção Encomendas.

6 — Modificar um registo DNS

Ferramentas associadas: create-domain-zone-record para adicionar um registo, delete-domain-zone-record para eliminar um e get-domain-zone-details para consultar a zona.

Exemplos de pedidos:

Altera o registo A de www.mydomain.ovh para 203.0.113.42.

Não precisa de saber que tipo de registo deve ser alterado. Descreva o resultado que espera: o seu agente identifica o registo em causa, explica-lhe o que vai alterar e aguarda a sua aprovação antes de aplicar a alteração.

O meu site está agora alojado num servidor cujo endereço IP é 203.0.113.42.
Faz com que www.mydomain.ovh aponte para ele.

A propagação na Internet pode depois demorar até 24 horas, consoante o TTL do registo.

7 — Criar um reencaminhamento

Um reencaminhamento envia os visitantes do seu domínio para outro endereço.

Exemplo de pedido:

Reencaminha blog.mydomain.ovh para https://mydomain.ovh/noticias, mantendo o endereço visível no navegador.

8 — As outras operações abrangidas

As secções v1_domain e v2_domain expõem as rotas correspondentes da API da OVHcloud sob a forma de ferramentas: qualquer operação que possa realizar nos seus nomes de domínio através da API está igualmente disponível através do MCP. Para além das tarefas acima, isto abrange, por exemplo:

• DNSSEC: ativação, desativação e gestão dos registos DS
• Proteção de transferência: bloqueio e desbloqueio
• Gestão dos contactos: proprietário, administrador, técnico e de faturação
• Servidores DNS e registos glue
• Identificadores e registos DynHost (DNS dinâmico)
• Cópia de segurança, reposição, importação e exportação da zona
• Gestão das tarefas: aceleração, cancelamento, relançamento
• Obtenção do código AuthInfo e aprovação das transferências de saída

Se não tiver a certeza de que uma operação é possível, peça ao seu agente que lhe explique o que é capaz de fazer com os seus nomes de domínio.

Quer saber mais?

Order a Domain Name

Configure the DNS of your Domain Name

Reencaminhar um domínio gerido pela OVHcloud

AI Endpoints - Model Context Protocol (MCP) with LangChain4j

Fale com a nossa comunidade de utilizadores.