Pinthread
Servidor MCP de comentarios de sitios web para agentes de codificación de IA. Fija comentarios en elementos reales del sitio; tu agente los lee y los resuelve.
Servidor MCP alojado
npx add-mcp 'https://pinthread.dev/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Un servidor MCP para comentarios en sitios web.
pinthread es un servidor MCP alojado para comentarios visuales dirigidos a agentes de IA. Tu equipo fija comentarios en los elementos reales de tu sitio. Tu agente de codificación los lee a través de MCP, realiza el cambio y responde en el hilo. Está incluido en todos los planes, incluido el gratuito a $0 al mes.
Comentarios visuales MCP: lo que lee tu agente
Cada hilo nombra el lugar exacto en la página. Tu agente obtiene:
- La URL de la página
- El selector del elemento y su texto visible
- La posición del comentario o el área seleccionada
- Cada respuesta, con su autor
Page: /pricing
Target: #annual-plan-button
Element text: Choose plan
Maya: Make it clear this is billed annually.
Alex: Keep the monthly equivalent visible too.
01 · Crea un token de agente
Regístrate gratis y crea un proyecto. Ábrelo en el panel y elige Acceso de agente. Selecciona un alcance:
- Lectura: lista y lee hilos y actividad nueva.
- Escritura: también responde, inicia, resuelve y reabre hilos.
Cada token pertenece a un solo proyecto. Los tokens comienzan con ptk_ y se muestran una sola vez. Caducan después de 90 días de forma predeterminada, o hasta 365 días. Guarda el token como PINTHREAD_TOKEN, nunca en tu repositorio.
02 · Conecta tu cliente
La URL del servidor es https://pinthread.dev/mcp. Utiliza HTTP transmisible con un token de portador.
claude mcp add --transport http pinthread https://pinthread.dev/mcp \
--header "Authorization: Bearer $PINTHREAD_TOKEN"
Ejecútalo en tu proyecto con PINTHREAD_TOKEN configurado con tu token de agente.
Lee la rama de localhost
Un widget en localhost escribe en la rama local a menos que se configure de otro modo. Las herramientas MCP usan shared de forma predeterminada. Usa estas llamadas para comentarios de localhost:
list_threads({ branch: "local", status: "all" })
get_thread({ thread_id: "THREAD_ID", branch: "local" })
status: "all" incluye todos los estados en una sola rama, no todas las ramas. Una lista vacía puede incluir availableBranches con recuentos de abiertos. Pasa una rama listada para leer sus hilos.
Servidor remoto, sin instalación local
El servidor MCP de pinthread es remoto. Lo alojamos en https://pinthread.dev/mcp, por lo que no hay ningún proceso que iniciar ni nada que instalar. Tu cliente envía mensajes JSON-RPC con POST y recibe respuestas JSON. El servidor expone solo herramientas, sin recursos ni indicaciones. Una solicitud GET devuelve HTTP 405.
No utiliza inicio de sesión OAuth. Cada solicitud lleva un token de portador estático. El token pertenece a un solo proyecto, por lo que el agente solo ve los hilos de ese proyecto. Cada solicitud está limitada por tasa y tamaño, y un token revocado o caducado se rechaza con HTTP 401.
Guía de configuración para cada agente
Cada guía tiene la configuración exacta para ese agente, cómo lee y responde a los hilos, y una lista de solución de problemas.
- Claude Code Añade el servidor con un comando.
- Cursor Añade el servidor en .cursor/mcp.json.
- Codex Añade el servidor en config.toml.
- Flujo de trabajo del agente El ciclo completo para cualquier agente.
Herramientas
Las herramientas de lectura funcionan con cualquier token. Las herramientas de escritura necesitan un token de escritura.
| Herramienta | Alcance | Qué hace |
|---|---|---|
whoami | Lectura | Muestra el proyecto, el nombre del token y el alcance de esta conexión. |
list_threads | Lectura | Lista los hilos. Filtra por estado (sin resolver, abierto, en_progreso, necesita_revisión, resuelto, todos), asignado, prioridad, etiqueta, página o tiempo de actualización. |
get_thread | Lectura | Lee un hilo con cada comentario, autor y reacción, además de sus archivos adjuntos y cualquier edición de texto sugerida. Establece el nivel en compacto, estándar o detallado (atributos clave, componente, archivo:línea, enlaces vscode:// y cursor://). |
get_page_context | Lectura | Devuelve los hilos abiertos en una página con sus anclas, archivos adjuntos y ediciones sugeridas. |
list_events | Lectura | Lee hilos y respuestas nuevos después de un cursor, del más antiguo al más reciente. |
list_assignees | Lectura | Lista las personas y agentes a los que se puede asignar un hilo. |
reply_thread | Escritura | Añade una respuesta como el agente. |
create_thread | Escritura | Inicia un hilo en una página en un ancla determinada. |
resolve_thread | Escritura | Marca un hilo como resuelto. |
reopen_thread | Escritura | Reabre un hilo resuelto. |
mark_suggestion_applied | Escritura | Marca una edición de texto sugerida como aplicada, añade una nota y resuelve el hilo. |
update_thread | Escritura | Establece el estado, asignado, prioridad, etiquetas o fecha de vencimiento de un hilo. |
get_thread, list_threads y get_page_context devuelven una lista attachments en cada hilo. Cada elemento tiene kind (image, log, metadata, video o replay), name, mime, size y createdAt. El texto de registro y metadatos está en línea en text. Las imágenes, videos y repeticiones vienen como un url firmado con un tiempo expiresAt. Un enlace funciona durante 15 minutos, solo para el proyecto y token que lo solicitó, y deja de funcionar cuando ese token se revoca. Las contraseñas, tokens y valores de cookies se enmascaran en los registros almacenados. Un hilo con una edición de texto sugerida tiene un campo suggestion con valores de old, new y selector en texto plano. Un comentario hecho en un menú abierto, diálogo, ventana emergente, información sobre herramientas o sección expandida tiene un texto ui_state con pasos numerados que muestran esa interfaz de nuevo.
Reacciona a comentarios nuevos
Llama a list_events con since: "latest" para comenzar desde ahora. Pasa de vuelta el cursor que devuelve, y cada llamada devuelve solo hilos y respuestas nuevos. La guía de flujo de trabajo del agente muestra el ciclo completo desde el comentario hasta la corrección.
Otras herramientas de comentarios con MCP
| Herramienta | Acceso de agente | Plan gratuito |
|---|---|---|
| pinthread | Servidor MCP y tokens de agente en todos los planes, incluido el gratuito | $0 al mes, sin prueba que se agote. Hasta 10 proyectos, 25 miembros por proyecto, 10,000 comentarios por proyecto, 100 MB de almacenamiento por proyecto. |
| Marker.io | Servidor MCP para todos los clientes sin costo adicional | Sin plan gratuito. Prueba gratuita de 15 días. |
| BugHerd | Servidor MCP en beta, gratuito para todos los suscriptores de BugHerd | Sin plan gratuito. Prueba gratuita de 7 días. |
| Userback | Conectores MCP en planes de pago | 2 proyectos de comentarios. Los comentarios permanecen disponibles durante 7 días. |
| Huddlekit | MCP en planes de pago | 1 proyecto, 3 miembros del equipo y 100 MB de almacenamiento |
| Ruttl | Sin MCP listado en la página de precios | 1 proyecto, 5 páginas y hasta 5 usuarios |
Verificado el 7 de octubre de 2026. Fuentes: Precios de Marker.io, MCP de Marker.io, Precios de BugHerd, MCP de BugHerd, Precios de Userback, Precios de Huddlekit, Precios de Ruttl.
Lee todas las alternativas, o consulta lo que incluye el plan gratuito.
Preguntas
¿Qué agentes pueden usar el servidor MCP de pinthread?
Cualquier cliente MCP que admita HTTP transmisible, incluidos Claude Code, Cursor y Codex. Los clientes sin MCP pueden tomar los comentarios copiados como una indicación.
¿El servidor MCP está incluido en el plan gratuito?
Sí. Los tokens de agente y el acceso MCP están incluidos en todos los planes, incluido el gratuito a $0 al mes.
¿Puede el agente ver mis otros proyectos?
No. Cada token pertenece a un solo proyecto, por lo que el agente solo ve los hilos de ese proyecto. Un token de lectura no puede responder, iniciar, resolver ni reabrir hilos.
¿El servidor MCP de pinthread es remoto o local?
Remoto. pinthread lo aloja en https://pinthread.dev/mcp. Tu cliente se conecta a través de HTTP con un token de portador. No ejecutas un proceso local. El servidor expone solo herramientas, sin recursos ni indicaciones, y el punto final acepta solo solicitudes POST.
¿Cómo se autentica el servidor MCP?
Con un token de agente que comienza con ptk_, enviado como encabezado Authorization: Bearer. No hay inicio de sesión OAuth. Cada token pertenece a un solo proyecto y tiene un alcance de lectura o escritura. Los tokens caducan después de 90 días de forma predeterminada y puedes revocarlos en cualquier momento.