twocents human feedback

Comentarios humanos para agentes de IA: comparte HTML, obtén un enlace de revisión en vivo, lee notas ancladas como markdown.

GitHub

Documentación

twocents — comentarios humanos para agentes de IA (servidor MCP)

Un servidor MCP remoto, disponible en https://twocents.page/mcp. Conéctalo y tu agente de IA podrá enviar cualquier página HTML a personas reales para revisión visual — y leer sus notas ancladas. Sin autenticación, sin clave de API, sin instalación para los revisores.

Herramientas

  • share_page — envía un documento HTML autocontenido y recibe un enlace de revisión. Cualquiera que lo abra puede anclar notas directamente en la página — sin inicio de sesión, funciona en cualquier dispositivo. Llama de nuevo con el mismo id de sala y los revisores conectados verán la actualización en vivo.
  • get_feedback — las notas ancladas, devueltas como markdown con el texto/selector de anclaje para cada nota, para que tu agente pueda encontrar y corregir el punto exacto. Pasa el array opcional handled (ids de notas ya decididos en sesiones anteriores) y esos se colapsan a una línea cada uno, para que la respuesta destaque lo nuevo.

Configuración

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

Conexión

Claude Code

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

Claude.ai (web o escritorio) — Configuración → Conectores → Añadir conector personalizado → pega https://twocents.page/mcp

Cursor o cualquier cliente MCP — usa el bloque de configuración anterior (un servidor MCP HTTP; sin autenticación, sin clave de API).

El ciclo

Pide a tu agente que "comparta esta página para comentarios" → envía el enlace a cualquier persona → ellos anclan notas en la página en vivo → pide a tu agente que "obtenga los comentarios" y los aplique. Todo el ciclo de revisión sin salir de tu editor.

Qué hay en este repositorio

El código fuente completo del servidor: mcp.js — un manejador JSON-RPC HTTP Streamable (sin estado) sin dependencias, ~300 líneas. Se ejecuta dentro de un Cloudflare Worker y almacena páginas/notas en un Durable Object por sala de revisión (env.ROOMS); el Worker, el relay y la interfaz de revisión viven en el código base principal (privado) de twocents.page. server.json es el manifiesto del registro MCP (page.twocents/twocents).

Modelo de privacidad: un id de sala es una capacidad imposible de adivinar — conocerlo es el permiso para leer/escribir en esa sala. Los enlaces de revisión están excluidos de la indexación de búsqueda.

Vélo en acción

Cada página de nuestra biblioteca interactiva de explicaciones tiene una sala de revisión en vivo — abre una y ancla una nota. O obtén comentarios sobre tu propio trabajo.