htmlkin

Conecte o htmlkin.ru pelo protocolo MCP — e o agente publicará e atualizará páginas HTML, documentos PDF e sites estáticos de texto diretamente pelo diálogo.

O que é

MCP (Model Context Protocol) é um protocolo aberto pelo qual assistentes de IA conectam ferramentas externas. O servidor MCP do htmlkin.ru já está implantado no nosso lado e está disponível no endereço https://htmlkin.ru/mcp — não é necessário instalar ou executar nada, basta adicionar o endereço nas configurações do assistente e informar a chave de API.

O que é necessário

• Chave de API do htmlkin.ru — criada no painel de controle na página «Chaves de API»
• Cliente MCP — Claude, Cursor ou outro assistente com suporte a MCP.

Conexão

O endereço do servidor é https://htmlkin.ru/mcp. A chave de API é enviada pelo cabeçalho Authorization: Bearer; se o cliente não souber definir cabeçalhos — adicione a chave diretamente no endereço: https://htmlkin.ru/mcp?key=hk_твой_ключ.

Claude Code

claude mcp add --transport http htmlkin https://htmlkin.ru/mcp \
  --header "Authorization: Bearer hk_твой_ключ"

Claude (claude.ai e Claude Desktop)

Settings → Connectors → Add custom connector, no campo URL informe o endereço com a chave: https://htmlkin.ru/mcp?key=hk_твой_ключ.

Outros clientes (Cursor, VS Code etc.)

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

{
  "mcpServers": {
    "htmlkin": {
      "type": "http",
      "url": "https://htmlkin.ru/mcp",
      "headers": {
        "Authorization": "Bearer hk_твой_ключ"
      }
    }
  }
}

A chave no endereço (?key=) pode ficar registrada no histórico e nos logs do cliente — onde for possível, prefira o cabeçalho. Se a chave for comprometida, revogue-a e emita uma nova no painel de controle.

Ferramentas

Após a conexão, o assistente tem acesso a quatro ferramentas:

Ferramenta	Finalidade
htmlkin_publish	Publicar HTML, PDF ou um conjunto de arquivos de texto do site e obter o endereço.
htmlkin_update	Substituir completamente o site (HTML, PDF ou files) e/ou alterar o PIN.
htmlkin_get	Obter endereço, tamanho, número de arquivos, entrypoint, tempo de vida e PIN.
htmlkin_delete	Excluir o site; o domínio vinculado permanece na conta.

Basta pedir ao assistente: «publique este site no htmlkin.ru» — ele chamará htmlkin_publish e retornará o link. A descrição completa dos parâmetros e códigos de erro está na documentação da API REST.

Site com vários arquivos

Em htmlkin_publish e htmlkin_update é possível passar o parâmetro files: um array de objetos { path, content }. São permitidos até 20 arquivos de texto e até 2 MB de UTF-8 no total; na raiz é obrigatório o index.html. São suportados HTML, CSS, JS, JSON, SVG, XML, Markdown e outras extensões de texto descritas na ferramenta.

Update sempre substitui completamente o site atual. Se você atualizar um site com vários arquivos usando um único html_content, ele se tornará single-file. Não envie arquivos binários e sites grandes em base64 pelos arguments: carregue o ZIP na API REST (site_archive) ou use o navegador.