Per assistenti IA

Configurazione del server MCP

Collega htmlkin.io tramite MCP e il tuo agente pubblicherà e aggiornerà pagine HTML e siti statici di testo direttamente dalla chat.

Che cos’è

MCP (Model Context Protocol) è un protocollo aperto che gli assistenti IA usano per collegare strumenti esterni. Il server MCP di htmlkin.io è già attivo da noi all’indirizzo https://htmlkin.io/mcp — non c’è nulla da installare o avviare: aggiungi l’indirizzo nelle impostazioni del tuo assistente e accedi dal browser.

Cosa ti serve

Un account htmlkin.io — l’accesso si apre nel browser al collegamento. I collegamenti sono nella pagina “Chiavi API”
Un client MCP — Claude, Cursor o un altro assistente che supporta MCP.

Collegamento

L’indirizzo del server è https://htmlkin.io/mcp. Al primo collegamento il client apre il browser: accedi a htmlkin.io e clicca “Consenti”. Nessuna chiave da copiare.

Prompt per l’agente

Incollalo in Claude Code, Codex, Cursor o un altro agente — collegherà il server da solo:

Collega il server MCP di htmlkin.io: indirizzo https://htmlkin.io/mcp, trasporto HTTP, nome htmlkin. Non serve una chiave API — il server usa OAuth. Aggiungi il server alla tua configurazione (in Claude Code: claude mcp add --transport http htmlkin https://htmlkin.io/mcp) e avvia l’accesso: si aprirà un browser dove approverò l’accesso.

Claude Code

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

Claude (claude.ai e Claude Desktop)

Impostazioni → Connettori → Aggiungi connettore personalizzato, inserisci https://htmlkin.io/mcp nel campo URL e clicca Connetti — si apre l’accesso a htmlkin.io.

Altri client (Cursor, VS Code e altri)

Qualsiasi client con supporto al trasporto HTTP si collega con questa configurazione:

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

Un client senza accesso dal browser si collega con una chiave API del tuo Pannello: nell’intestazione Authorization: Bearer o nell’indirizzo https://htmlkin.io/mcp?key=htk_tua_chiave. Una chiave nell’indirizzo può finire nella cronologia e nei log del client — quando puoi, preferisci l’intestazione.

Strumenti

Una volta collegato, l’assistente ottiene quattro strumenti:

Strumento	Scopo
htmlkin_publish	Pubblica HTML o un insieme di file di testo di un sito e restituisce l’indirizzo.
htmlkin_update	Sostituisce l’intero sito (HTML o file) e/o cambia il PIN e la visibilità.
htmlkin_get	Restituisce indirizzo, dimensione, numero di file, punto di ingresso, durata, PIN e visibilità.
htmlkin_delete	Elimina un sito; il dominio collegato resta nell’account.

Basta chiedere all’assistente: “pubblica questo sito su htmlkin.io” — chiamerà htmlkin_publish e restituirà il link. La descrizione completa dei parametri e i codici di errore sono nella documentazione REST API.

Siti con più file

htmlkin_publish e htmlkin_update accettano il parametro files: un array di oggetti { path, content }. Sono ammessi fino a 20 file di testo e 2 MB di UTF-8 in totale; index.html è obbligatorio nella radice. Sono supportati HTML, CSS, JS, JSON, SVG, XML, Markdown e le altre estensioni di testo indicate nella descrizione dello strumento.

L’aggiornamento sostituisce sempre l’intero sito attuale. Se aggiorni un sito con più file usando un solo html_content, diventa un sito a file singolo. Non inviare file binari o siti grandi in base64 negli argomenti: carica uno ZIP tramite la REST API (site_archive) oppure usa il browser.