Para assistentes de IA

Configuração do servidor MCP

Conecte o htmlkin.io via MCP e o seu agente vai publicar e atualizar páginas HTML e sites estáticos de texto direto no chat.

O que é

MCP (Model Context Protocol) é um protocolo aberto que os assistentes de IA usam para conectar ferramentas externas. O servidor MCP do htmlkin.io já roda do nosso lado em https://htmlkin.io/mcp — não há nada para instalar ou executar: adicione o endereço nas configurações do seu assistente e entre na conta pelo navegador.

O que você precisa

Uma conta no htmlkin.io — o login abre no navegador ao conectar. As conexões aparecem na página “Chaves de API”
Um cliente MCP — Claude, Cursor ou outro assistente com suporte a MCP.

Conexão

O endereço do servidor é https://htmlkin.io/mcp. Na primeira conexão, o cliente abre o navegador: entre na conta do htmlkin.io e clique em “Permitir”. Não é preciso copiar chave.

Prompt para o agente

Cole no Claude Code, Codex, Cursor ou outro agente — ele conecta o servidor sozinho:

Conecte o servidor MCP do htmlkin.io: endereço https://htmlkin.io/mcp, transporte HTTP, nome htmlkin. Não precisa de chave de API — o servidor usa OAuth. Adicione o servidor à sua configuração (no Claude Code: claude mcp add --transport http htmlkin https://htmlkin.io/mcp) e inicie o login: vai abrir um navegador onde eu aprovo o acesso.

Claude Code

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

Claude (claude.ai e Claude Desktop)

Configurações → Conectores → Adicionar conector personalizado, informe https://htmlkin.io/mcp no campo URL e clique em Conectar — abre o login do htmlkin.io.

Outros clientes (Cursor, VS Code e outros)

Qualquer cliente com suporte a transporte HTTP se conecta com esta configuração:

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

Um cliente sem login pelo navegador se conecta com uma chave de API do seu Painel: no cabeçalho Authorization: Bearer ou no endereço https://htmlkin.io/mcp?key=htk_sua_chave. Uma chave no endereço pode acabar no histórico e nos logs do cliente — prefira o cabeçalho sempre que possível.

Ferramentas

Depois de conectado, o assistente ganha quatro ferramentas:

Ferramenta	Finalidade
htmlkin_publish	Publicar HTML ou um conjunto de arquivos de texto de um site e obter o endereço.
htmlkin_update	Substituir o site inteiro (HTML ou arquivos) e/ou alterar o PIN e a visibilidade.
htmlkin_get	Obter o endereço, o tamanho, o número de arquivos, o ponto de entrada, o prazo de validade, o PIN e a visibilidade.
htmlkin_delete	Excluir um site; o domínio vinculado continua na conta.

Basta pedir ao assistente: “publique este site no htmlkin.io” — ele vai chamar htmlkin_publish e devolver o link. A descrição completa dos parâmetros e os códigos de erro estão na documentação da REST API.

Sites com vários arquivos

htmlkin_publish e htmlkin_update aceitam o parâmetro files: um array de objetos { path, content }. São permitidos até 20 arquivos de texto e 2 MB de UTF-8 no total; index.html é obrigatório na raiz. HTML, CSS, JS, JSON, SVG, XML, Markdown e as demais extensões de texto da descrição da ferramenta são suportados.

A atualização sempre substitui o site atual inteiro. Se você atualizar um site com vários arquivos usando um único html_content, ele passa a ser um site de um arquivo só. Não envie arquivos binários nem sites grandes em base64 nos argumentos: envie um ZIP para a REST API (site_archive) ou use o navegador.