twocents human feedback

Feedback humano para agentes de IA: compartilhe HTML, receba um link de revisão ao vivo, leia notas ancoradas como markdown.

GitHub

Documentação

twocents — feedback humano para agentes de IA (servidor MCP)

Um servidor MCP remoto, ativo em https://twocents.page/mcp. Conecte-o e seu agente de IA pode enviar qualquer página HTML para pessoas reais para revisão visual — e ler as notas fixadas de volta. Sem autenticação, sem chave de API, sem instalação para revisores.

Ferramentas

  • share_page — envie um documento HTML autocontido, receba um link de revisão. Qualquer pessoa que abrir pode fixar notas diretamente na página — sem login, funciona em qualquer dispositivo. Chame novamente com o mesmo id da sala e os revisores conectados veem a atualização ao vivo.
  • get_feedback — as notas fixadas, retornadas como markdown com o texto/seletor de âncora para cada nota, para que seu agente possa encontrar e corrigir o ponto exato. Passe o array opcional handled (ids de notas já decididos em sessões anteriores) e eles se resumem a uma linha cada, então a resposta começa com o que há de novo.

Configuração

{
  "mcpServers": {
    "twocents": {
      "url": "https://twocents.page/mcp"
    }
  }
}

Conectar

Claude Code

claude mcp add --transport http twocents https://twocents.page/mcp

Claude.ai (web ou desktop) — Configurações → Conectores → Adicionar conector personalizado → cole https://twocents.page/mcp

Cursor ou qualquer cliente MCP — use o bloco de configuração acima (um servidor MCP HTTP; sem autenticação, sem chave de API).

O ciclo

Peça ao seu agente para "compartilhar esta página para feedback" → envie o link para qualquer pessoa → eles fixam notas na página ao vivo → peça ao seu agente para "obter o feedback" e aplicá-lo. Todo o ciclo de revisão sem sair do seu editor.

O que há neste repositório

O código-fonte completo do servidor: mcp.js — um manipulador JSON-RPC HTTP transmissível (sem estado) sem dependências, ~300 linhas. Ele roda dentro de um Cloudflare Worker e armazena páginas/notas em um Durable Object por sala de revisão (env.ROOMS); o Worker, o relay e a interface do revisor vivem no código-fonte principal (privado) do twocents.page. server.json é o manifesto do registro MCP (page.twocents/twocents).

Modelo de privacidade: um id de sala é uma capacidade impossível de adivinhar — conhecê-lo é a permissão para ler/escrever nessa sala. Links de revisão são excluídos da indexação de busca.

Veja em ação

Cada página em nossa biblioteca de explicações interativas tem uma sala de revisão ao vivo — abra uma e fixe uma nota. Ou https://twocents.page/start.