dochost

Publique Markdown ou HTML em um link público compartilhável, diretamente do assistente.

Documentação

Servidor MCP dochost

Publique Markdown ou HTML em um link limpo e compartilhável — direto do seu assistente de IA. O servidor MCP dochost dá ao Claude, ChatGPT, Cursor e qualquer outro cliente MCP seis ferramentas — publish, update_page, list_my_pages, get_page, get_account, delete_page — para que seu assistente possa devolver um link público dochost e continuar mantendo-o. Sem copiar e colar, sem painel separado.

🌐 Site: https://dochost.io
🔌 Servidor MCP: https://dochost.io/mcp
🛰️ Endpoint: https://dochost.io/api/mcp (HTTP Streamable, OAuth)
🔑 Autenticação: login OAuth — sem chaves de API

Por quê

Seu LLM produziu um relatório, um README, um artefato HTML. Enviá-lo não deveria significar uma captura de tela ou um blob .md bruto. O dochost transforma essa saída em uma página web normal em sua própria URL, em uma única chamada de ferramenta. Markdown e HTML são renderizados ao vivo.

Início rápido

Claude Code (uma linha):

claude mcp add --transport http dochost https://dochost.io/api/mcp

Em seguida, execute /mcp dentro do Claude Code e aprove no navegador. Adicione --scope user para usá-lo em todos os projetos.

Claude Desktop / Cursor / VS Code / Windsurf — adicione um servidor HTTP remoto:

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

Você autoriza uma vez via OAuth no navegador; o assistente então publica como você, e a saída segue as permissões do seu plano dochost.

Ponte Stdio / Docker

Para clientes ou avaliadores de diretório que precisam de um processo stdio local, este repositório inclui uma ponte para o mesmo endpoint MCP hospedado:

npm ci --ignore-scripts
node server/index.js

Ou execute-o no Docker:

docker build -t dochost-mcp .
docker run --rm -i dochost-mcp

Node.js 22 ou mais recente é necessário. A ponte encaminha as ferramentas e esquemas ao vivo; não é uma cópia auto-hospedada do aplicativo dochost. A inicialização e a descoberta de ferramentas são públicas. Clientes interativos podem usar OAuth; a execução de ferramentas headless precisa de um segredo de runtime DOCHOST_API_KEY existente (Docker: docker run --rm -i -e DOCHOST_API_KEY dochost-mcp).

Mantenedores: veja instruções de reivindicação, build e release do Glama.

Qual método de autenticação?

Cliente	Autenticação recomendada	Por quê
OpenClaw, Hermes	Chave de API	Agentes headless (ex.: um orquestrador Telegram). Uma chave Bearer estática funciona com a skill HTTP simples e qualquer executor MCP, sem etapa de navegador por sessão.
Claude, Cursor, ChatGPT, VS Code, Windsurf e todos os outros clientes MCP	OAuth	Uma aprovação no navegador, nada de longo prazo armazenado na configuração; o assistente publica como você.

Mantenha a chave de API como qualquer segredo: armazene-a como uma variável de ambiente / segredo do host (nunca a envie para o repositório) e revogue ou rotacione-a em Configurações → Chaves de API se ela vazar.

Agentes (OpenClaw, Hermes) — Chave de API

OpenClaw e Hermes são headless, então autenticam com uma chave de API. Crie uma em dochost.io → Configurações → Chaves de API, exporte-a como DOCHOST_API_KEY e:

Instale a skill — uma skill publish autocontida que funciona em qualquer agente que possa fazer uma requisição HTTP: skills/dochost-publish/.
Conecte o MCP — aponte o agente para https://dochost.io/api/mcp com a chave como um cabeçalho Bearer: examples/mcporter.config.json.

Guias de instalação por host:

OpenClaw → clients/openclaw.md
Hermes → clients/hermes.md

Uso único a partir de um shell: examples/publish.sh.

Ferramentas

Seis ferramentas. publish cria; as demais permitem que o assistente continue trabalhando com o que já publicou, em vez de deixar um link órfão toda vez que você revisa algo.

`publish`

Publique Markdown ou HTML como uma página hospedada e obtenha uma URL compartilhável.

Parâmetro	Tipo	Observações
`body`	string (obrigatório)	O conteúdo Markdown ou HTML a publicar.
`format`	`"markdown"` \| `"html"`	Detectado automaticamente quando omitido.
`public`	boolean	Listar no Explore. Padrão: `false` (não listado).
`customSlug`	string · Pro	Escolha o caminho do link em vez de um slug aleatório.
`password`	string · Pro	Proteja a página com uma senha.
`noBranding`	boolean · Pro	Oculte o selo de rodapé do dochost.

Retorna url, slug, expiresAt e um editToken.

Exemplo: "Publique meu relatório do Q3 como uma página privada com senha." → dochost.co/d/q3-report (protegida por senha, link de 7 dias no plano gratuito).

`update_page`

Substitua o conteúdo de uma página no mesmo lugar. A URL, as contagens de visualizações/curtidas e a expiração permanecem — apenas body, format e title mudam.

Parâmetro	Tipo	Observações
`slug`	string (obrigatório)	A página a atualizar.
`body`	string (obrigatório)	O novo conteúdo Markdown ou HTML.
`format`	`"markdown"` \| `"html"`	Detectado automaticamente quando omitido.
`title`	string	Substitua o título derivado.

Prefira isso a publicar novamente sempre que estiver revisando algo já publicado — um segundo publish gera um segundo link e deixa órfão aquele que o leitor já tem. Reenviar conteúdo idêntico é uma operação sem efeito.

`list_my_pages`

Liste as páginas que você publicou, das mais recentes para as mais antigas. Paginado (limit, offset); retorna registros compactos sem os corpos das páginas.

`get_page`

Consulte uma página por slug: título, formato, status, contagens de visualizações/curtidas, expiração e se é protegida por senha. Nunca retorna o corpo ou a senha.

`get_account`

Seu plano, uso da cota de páginas e flags de permissões (limite de tamanho, slug personalizado, senha, branding). Vale a pena chamar antes de publish para que o assistente saiba seus limites antecipadamente em vez de falhar neles.

`delete_page`

Exclua permanentemente uma página por slug. O link para de funcionar imediatamente e o slug é liberado. Excluir uma página já excluída é uma operação segura sem efeito.

Observações

Propriedade e permissões vêm da sua conta autenticada, nunca da entrada da ferramenta.
Páginas publicadas ficam em dochost.co, uma origem de conteúdo separada sem cookies — nunca na origem do aplicativo dochost.io. É isso que permite ao dochost servir HTML do autor sob uma política endurecida sem tocar na sua sessão. dochost.io/d/… redireciona permanentemente para dochost.co/d/…, então links antigos continuam funcionando.
Links gratuitos duram 7 dias; links permanentes, senha, slug personalizado, subdomínio personalizado e remoção de branding estão nos planos pagos — veja dochost.io.

Licença

MIT — veja LICENSE.