Pour les assistants IA

Configuration du serveur MCP

Connectez htmlkin.io via MCP et votre agent publiera et mettra à jour des pages HTML et des sites statiques textuels directement depuis la conversation.

De quoi s’agit-il ?

MCP (Model Context Protocol) est un protocole ouvert qui permet aux assistants IA de se connecter à des outils externes. Le serveur MCP de htmlkin.io tourne déjà chez nous à l’adresse https://htmlkin.io/mcp — rien à installer ni à lancer : ajoutez l’adresse dans les paramètres de votre assistant et connectez-vous dans le navigateur.

Ce qu’il vous faut

Un compte htmlkin.io — la connexion s’ouvre dans le navigateur. Les connexions figurent sur la page « Clés API »
Un client MCP — Claude, Cursor ou un autre assistant compatible MCP.

Connexion

L’adresse du serveur est https://htmlkin.io/mcp. À la première connexion, le client ouvre le navigateur : connectez-vous à htmlkin.io et cliquez sur « Autoriser ». Aucune clé à copier.

Prompt pour votre agent

Collez-le dans Claude Code, Codex, Cursor ou un autre agent — il connectera le serveur lui-même :

Connecte le serveur MCP htmlkin.io : adresse https://htmlkin.io/mcp, transport HTTP, nom htmlkin. Aucune clé API n’est nécessaire — le serveur utilise OAuth. Ajoute le serveur à ta configuration (dans Claude Code : claude mcp add --transport http htmlkin https://htmlkin.io/mcp) et lance la connexion : un navigateur s’ouvrira pour que j’autorise l’accès.

Claude Code

claude mcp add --transport http htmlkin https://htmlkin.io/mcp

Claude (claude.ai et Claude Desktop)

Settings → Connectors → Add custom connector, saisissez https://htmlkin.io/mcp dans le champ URL et cliquez sur Connect — la connexion à htmlkin.io s’ouvre.

Autres clients (Cursor, VS Code, etc.)

Tout client prenant en charge le transport HTTP se connecte avec cette configuration :

{
  "mcpServers": {
    "htmlkin": {
      "type": "http",
      "url": "https://htmlkin.io/mcp"
    }
  }
}

Un client sans connexion par le navigateur se connecte avec une clé API de votre tableau de bord : dans l’en-tête Authorization: Bearer ou dans l’adresse https://htmlkin.io/mcp?key=htk_votre_cle. Une clé placée dans l’adresse peut se retrouver dans l’historique et les journaux du client — préférez l’en-tête lorsque c’est possible.

Outils

Une fois connecté, l’assistant dispose de quatre outils :

Outil	Rôle
htmlkin_publish	Publier du HTML ou un ensemble de fichiers texte d’un site et obtenir l’adresse.
htmlkin_update	Remplacer tout le site (HTML ou fichiers) et/ou changer le code PIN et la visibilité.
htmlkin_get	Obtenir l’adresse, la taille, le nombre de fichiers, le point d’entrée, la durée de vie, le code PIN et la visibilité.
htmlkin_delete	Supprimer un site ; le domaine associé reste dans le compte.

Demandez simplement à l’assistant : « publie ce site sur htmlkin.io » — il appellera htmlkin_publish et renverra le lien. La description complète des paramètres et les codes d’erreur se trouvent dans la documentation de l’API REST.

Sites multi-fichiers

htmlkin_publish et htmlkin_update acceptent un paramètre files : un tableau d’objets { path, content }. Jusqu’à 20 fichiers texte et 2 Mo d’UTF-8 au total sont autorisés ; index.html est obligatoire à la racine. HTML, CSS, JS, JSON, SVG, XML, Markdown et les autres extensions texte indiquées dans la description de l’outil sont pris en charge.

Une mise à jour remplace toujours tout le site actuel. Si vous mettez à jour un site multi-fichiers avec un seul html_content, il devient un site à fichier unique. N’envoyez pas de fichiers binaires ni de gros sites en base64 dans les arguments : importez un ZIP via l’API REST (site_archive) ou utilisez le navigateur.