Servidor MCP

Confie os seus nomes de domínio e as suas zonas DNS a um assistente de IA (Claude, ChatGPT, Cursor, n8n…), sem escrever código e sem lhe dar a sua chave API.

O servidor MCP da LWS liga um assistente de IA à sua conta LWS. O MCP (Model Context Protocol) é o padrão aberto que permite aos assistentes usar serviços externos: pede, em linguagem corrente, que liste os seus domínios, leia uma zona DNS ou lhe acrescente um registo, e o assistente faz por si as chamadas a esta API.

O servidor é alojado pela LWS em https://mcp.lws.net/mcp: não há nada a instalar. A sua chave API fica na LWS. O assistente recebe um token, que cria no portal mcp.lws.net e que pode suspender ou revogar a qualquer momento. Cada token tem as suas próprias ferramentas, duração e limites, e cada uma das suas ações fica registada nos seus registos de atividade.

O portal está em francês: as suas etiquetas são indicadas abaixo tal como aparecem, com o seu significado.

Antes de começar

Uma chave API de produção, gerada a partir da sua área de cliente, como para qualquer chamada a esta API.
Os endereços IP autorizados do seu acesso API. O MCP precisa de dois: o da sua ligação à internet, para entrar no portal, e o do servidor MCP, para que o assistente possa agir. O portal indica-lhe o segundo na ativação.
Crédito pré-pago, só se o assistente tiver de comprar ou renovar domínios.

Ativar o MCP

Aceda a mcp.lws.net e entre com o seu identificador LWS (apenas o número) e a sua chave API. Se a ligação for recusada, verifique ambos e depois os endereços IP autorizados: a mensagem indica o endereço a acrescentar.
Na primeira ligação, aceite as condições de utilização e indique o endereço de e-mail dos alertas.
Confirme esse endereço com a ligação recebida, válida durante 24 horas. Sem confirmação, nenhum alerta é enviado. O remetente é [email protected].
Acrescente o endereço IP do servidor MCP aos IP autorizados do seu acesso API, se ainda não o fez.

Aconselhamos também a ativar a autenticação de dois fatores, em Mon compte (A minha conta).

Ligar o seu assistente

Há duas formas, conforme o assistente:

Claude e ChatGPT ligam-se por autorização (OAuth): basta o endereço do servidor, e o token é criado quando dá o seu consentimento no portal.
Os outros (Claude Code, Cursor, n8n…) usam um token que cria no portal, em Jetons (Tokens), e que enviam no cabeçalho Authorization: Bearer. O seu valor só é mostrado uma vez: copie-o ao criá-lo.

Claude (claude.ai, aplicação para computador ou telemóvel)

No Claude, abra os conectores (menu Personalizar ou Definições) e acrescente um conector personalizado.
Nome: LWS. Endereço: https://mcp.lws.net/mcp. Deixe o resto como está.
O Claude abre o portal: entre e escolha o que o Claude poderá fazer. O portal propõe um token só de leitura, válido durante 30 dias, que pode ajustar em “Réglages avancés” (Definições avançadas).

ChatGPT

Em chatgpt.com, acrescente um servidor MCP personalizado (menu dos conectores, conforme a sua versão). A opção depende da sua subscrição e das definições do seu espaço de trabalho.
Endereço do servidor: https://mcp.lws.net/mcp. Autenticação: OAuth.
O ChatGPT abre o portal: entre e escolha o que ele poderá fazer.

Um token obtido por autorização vale durante o período escolhido: quando expira, o assistente pede-lhe uma nova autorização. Se o portal mostrar “Application non vérifiée par LWS” (aplicação não verificada pela LWS), continue apenas se acabou de iniciar a ligação.

Claude Code

Num terminal, substituindo VOTRE_JETON pelo valor do token:

claude mcp add --transport http lws https://mcp.lws.net/mcp --header "Authorization: Bearer VOTRE_JETON"

Cursor e outros editores

Acrescente este servidor ao ficheiro de configuração MCP do editor (para o Cursor: ~/.cursor/mcp.json) e reinicie-o:

{
  "mcpServers": {
    "lws": {
      "url": "https://mcp.lws.net/mcp",
      "headers": { "Authorization": "Bearer VOTRE_JETON" }
    }
  }
}

n8n

Acrescente ao seu agente de IA a ferramenta MCP Client Tool.
Endpoint: https://mcp.lws.net/mcp. Transport: HTTP Streamable.
Authentication: Bearer Auth, com o valor de um token.

Escolher o que o assistente pode fazer

Cada token tem as suas próprias definições:

as ferramentas a que tem direito, em quatro níveis (ver abaixo);
a sua duração, de 1 a 365 dias;
um número máximo de ações, se o desejar;
as compras: nenhuma enquanto não assinalar uma ferramenta paga, e então dentro do número de compras que fixar;
os endereços IP e os países a partir dos quais pode ser usado;
uma nota, para lembrar para que serve.

Comece pela leitura e crie um token por assistente e por utilização. Para toda a conta, a página Limites fixa ainda o número de ações por hora e por dia (recusar além disso, tolerar uma margem ou apenas avisar), as compras por dia e por mês, os endereços IP e os países autorizados, e um modo só de leitura.

Nível	Ferramentas
Leitura	`domain_list`, `domain_get`, `domain_check`, `dns_zone_get`, `domain_nameservers_get`, `hosting_get`, `credit_get`, `purchase_history`, `hosting_plans`, `tld_prices`, `domain_renew_price`, `contact_list`, `pending_operations`
Escrita	`dns_record_add`, `domain_autorenew_enable`, `domain_transfer_lock`, `domain_redirect_remove`
Sensível	`dns_record_update`, `dns_record_delete`, `domain_nameservers_set`, `domain_authcode_send`, `domain_autorenew_disable`, `domain_transfer_unlock`, `domain_redirect_set`
Paga	`domain_buy`, `domain_renew`

As ferramentas de leitura não alteram nada. As de escrita acrescentam ou protegem; as sensíveis podem deixar um site ou o seu e-mail sem serviço (zona DNS, servidores de nomes) ou preparar uma transferência. As pagas debitam o seu crédito pré-pago.

Manter o controlo

Registos de atividade: cada ação dos seus assistentes (data, token, ferramenta, resultado, endereço IP, país), conservada 90 dias, com filtros e exportação em CSV, JSON ou YAML.
Alertas por e-mail: token criado, expiração próxima, quota quase esgotada, limite atingido, ligação recusada ou a partir de uma rede nova, e cada compra, sempre comunicada.
Histórico: ligações ao portal, alterações de tokens e de definições, compras, conservados um ano.
A qualquer momento, pode suspender, regenerar ou revogar um token, e terminar a sessão do portal nos seus outros dispositivos.

Bom saber

Um assistente pode enganar-se: reveja o que propõe antes de uma alteração de zona DNS, de servidores de nomes ou de transferência.
Após um erro ou um tempo de espera esgotado, uma operação pode ter sido feita na mesma: o assistente é avisado para verificar antes de a repetir, e deve fazer o mesmo.
Uma compra feita pelo assistente é uma encomenda como qualquer outra, sujeita às condições gerais de venda da LWS: o registo e a renovação de um nome de domínio não dão direito de livre resolução.
O que o MCP devolve ao assistente (domínios, zonas DNS…) é transmitido ao seu editor, que o trata segundo as suas próprias condições.
A LWS nunca lhe pedirá a sua chave API nem os seus tokens. As condições de utilização do MCP (em francês) definem as regras do serviço.