Documentation API L’hébergement web accessible à tous Visiter LWS

Serveur MCP

Confiez vos noms de domaine et vos zones DNS à un assistant IA (Claude, ChatGPT, Cursor, n8n…), sans écrire de code et sans lui donner votre clé API.

Le serveur MCP LWS relie un assistant IA à votre compte LWS. MCP (Model Context Protocol) est le standard ouvert qui permet aux assistants d’utiliser des services extérieurs : vous demandez en langage courant de lister vos domaines, de lire une zone DNS ou d’y ajouter un enregistrement, et l’assistant fait pour vous les appels à cette API.

Le serveur est hébergé par LWS, à l’adresse https://mcp.lws.net/mcp : rien à installer. Votre clé API reste chez LWS. L’assistant reçoit un jeton, que vous créez sur le portail mcp.lws.net et que vous pouvez suspendre ou révoquer à tout moment. Chaque jeton a ses propres outils, sa durée et ses limites, et chacune de ses actions est enregistrée dans vos journaux.

Avant de commencer

  • Une clé API de production, générée depuis votre espace client, comme pour tout appel à cette API.
  • Les adresses IP autorisées de votre accès API. Le MCP en demande deux : celle de votre connexion internet, pour vous connecter au portail, et celle du serveur MCP, pour que l’assistant puisse agir. Le portail vous indique la seconde à l’activation.
  • Du crédit prépayé, seulement si l’assistant doit acheter ou renouveler des domaines.

Activer le MCP

  1. Rendez-vous sur mcp.lws.net et connectez-vous avec votre identifiant LWS (le nombre seul) et votre clé API. Si la connexion est refusée, vérifiez l’une et l’autre, puis les adresses IP autorisées : le message indique celle à ajouter.
  2. À la première connexion, acceptez les conditions d’utilisation et indiquez l’adresse e-mail des alertes.
  3. Confirmez cette adresse par le lien reçu, valable 24 heures. Sans confirmation, aucune alerte ne part. L’expéditeur est [email protected].
  4. Ajoutez l’adresse IP du serveur MCP aux IP autorisées de votre accès API, si ce n’est pas déjà fait.

Nous vous conseillons d’activer aussi la double authentification, dans Mon compte.

Brancher votre assistant

Deux façons de faire, selon l’assistant :

  • Claude et ChatGPT se connectent par autorisation (OAuth) : l’adresse du serveur suffit, et le jeton est créé quand vous donnez votre accord sur le portail.
  • Les autres (Claude Code, Cursor, n8n…) utilisent un jeton que vous créez sur le portail, dans Jetons, et qu’ils envoient dans l’en-tête Authorization: Bearer. Sa valeur n’est affichée qu’une fois : copiez-la à sa création.

Claude (claude.ai, application de bureau ou mobile)

  1. Dans Claude, ouvrez les connecteurs (menu Personnaliser ou Paramètres) et ajoutez un connecteur personnalisé.
  2. Nom : LWS. Adresse : https://mcp.lws.net/mcp. Laissez le reste tel quel.
  3. Claude ouvre le portail : connectez-vous, puis choisissez ce que Claude pourra faire. Le portail propose un jeton en lecture seule, valable 30 jours, que vous ajustez sous « Réglages avancés ».

ChatGPT

  1. Sur chatgpt.com, ajoutez un serveur MCP personnalisé (menu des connecteurs, selon votre version). L’option dépend de votre abonnement et des réglages de votre espace de travail.
  2. Adresse du serveur : https://mcp.lws.net/mcp. Authentification : OAuth.
  3. ChatGPT ouvre le portail : connectez-vous, puis choisissez ce qu’il pourra faire.

Un jeton obtenu par autorisation vaut pour la durée choisie : à son expiration, l’assistant vous demande une nouvelle autorisation. Si le portail affiche « Application non vérifiée par LWS », ne continuez que si vous venez vous-même de lancer la connexion.

Claude Code

Dans un terminal, en remplaçant VOTRE_JETON par la valeur du jeton :

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

Cursor et autres éditeurs

Ajoutez ce serveur au fichier de configuration MCP de l’éditeur (pour Cursor : ~/.cursor/mcp.json), puis redémarrez-le :

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

n8n

  1. Ajoutez à votre agent IA l’outil MCP Client Tool.
  2. Endpoint : https://mcp.lws.net/mcp. Transport : HTTP Streamable.
  3. Authentication : Bearer Auth, avec la valeur d’un jeton.

Choisir ce que l’assistant peut faire

Chaque jeton a ses réglages :

  • les outils auxquels il a droit, classés en quatre niveaux (voir ci-dessous) ;
  • sa durée, de 1 à 365 jours ;
  • un nombre maximal d’actions, si vous le souhaitez ;
  • les achats : aucun tant que vous ne cochez pas un outil payant, et alors dans la limite du nombre d’achats que vous fixez ;
  • les adresses IP et les pays d’où il peut être utilisé ;
  • une note, pour vous rappeler à quoi il sert.

Commencez par la lecture seule, et créez un jeton par assistant et par usage. Pour tout le compte, la page Limites règle en plus le nombre d’actions par heure et par jour (refuser au-delà, tolérer une marge ou seulement prévenir), les achats par jour et par mois, les adresses IP et les pays autorisés, et un passage en lecture seule.

Niveau Outils
Lecture 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
Écriture dns_record_add, domain_autorenew_enable, domain_transfer_lock, domain_redirect_remove
Sensible dns_record_update, dns_record_delete, domain_nameservers_set, domain_authcode_send, domain_autorenew_disable, domain_transfer_unlock, domain_redirect_set
Payant domain_buy, domain_renew

Les outils de lecture ne changent rien. Ceux d’écriture ajoutent ou protègent ; les outils sensibles peuvent couper un site ou ses e-mails (zone DNS, serveurs de noms) ou préparer un transfert. Les outils payants débitent votre crédit prépayé.

Garder le contrôle

  • Journaux : chaque action de vos assistants (date, jeton, outil, résultat, adresse IP, pays), conservée 90 jours, avec des filtres et un export CSV, JSON ou YAML.
  • Alertes par e-mail : jeton créé, expiration proche, quota bientôt épuisé, limite atteinte, connexion refusée ou depuis un nouveau réseau, et chaque achat, toujours signalé.
  • Historique : connexions au portail, changements de jetons et de réglages, achats, conservés un an.
  • À tout moment, vous pouvez suspendre, régénérer ou révoquer un jeton, et déconnecter vos autres appareils du portail.

Bon à savoir

  • Un assistant peut se tromper : relisez ce qu’il propose avant une modification de zone DNS, de serveurs de noms ou de transfert.
  • Après une erreur ou un délai dépassé, une opération a pu être faite quand même : l’assistant est prévenu de vérifier avant de la relancer, faites-en autant.
  • Un achat fait par l’assistant est une commande comme une autre, soumise aux conditions générales de vente de LWS : l’enregistrement et le renouvellement d’un nom de domaine n’ouvrent pas de droit de rétractation.
  • Ce que le MCP renvoie à l’assistant (domaines, zones DNS…) est transmis à son éditeur, qui le traite selon ses propres conditions.
  • LWS ne vous demandera jamais votre clé API, ni vos jetons. Les conditions d’utilisation du MCP précisent les règles du service.