Pinthread

Servidor MCP de feedback de sites para agentes de codificação de IA. Fixe comentários em elementos reais do site; seu agente lê e resolve eles.

Servidor MCP hospedado

npx add-mcp 'https://pinthread.dev/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Um servidor MCP de feedback para websites.

pinthread é um servidor MCP hospedado para feedback visual para agentes de IA. Sua equipe fixa comentários nos elementos reais do seu site. Seu agente de codificação os lê via MCP, faz a alteração e responde no tópico. Está incluído em todos os planos, incluindo o Free a US$ 0 por mês.

Feedback visual via MCP: o que seu agente lê

Cada tópico nomeia o local exato na página. Seu agente recebe:

  • A URL da página
  • O seletor do elemento e o texto visível
  • A posição do comentário ou a área selecionada
  • Cada resposta, com seu 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 · Crie um token de agente

Cadastre-se gratuitamente e crie um projeto. Abra-o no painel e escolha Acesso do agente. Selecione um escopo:

  • Leitura: lista e lê tópicos e novas atividades.
  • Escrita: também responde, inicia, resolve e reabre tópicos.

Cada token pertence a um projeto. Os tokens começam com ptk_ e são exibidos uma única vez. Eles expiram após 90 dias por padrão, ou até 365 dias. Armazene o token como PINTHREAD_TOKEN, nunca no seu repositório.

02 · Conecte seu cliente

A URL do servidor é https://pinthread.dev/mcp. Ela usa HTTP transmissível com um token de portador.

claude mcp add --transport http pinthread https://pinthread.dev/mcp \
  --header "Authorization: Bearer $PINTHREAD_TOKEN"

Execute-o no seu projeto com PINTHREAD_TOKEN definido como seu token de agente.

Leia a ramificação localhost

Um widget em localhost grava na ramificação local a menos que configurado de outra forma. As ferramentas MCP usam shared por padrão. Use estas chamadas para feedback de localhost:

list_threads({ branch: "local", status: "all" })
get_thread({ thread_id: "THREAD_ID", branch: "local" })

status: "all" inclui todos os status em uma ramificação, não todas as ramificações. Uma lista vazia pode incluir availableBranches com contagens de abertos. Passe uma ramificação listada para ler seus tópicos.

Servidor remoto, sem instalação local

O servidor MCP pinthread é remoto. Nós o hospedamos em https://pinthread.dev/mcp, então não há processo para iniciar nem nada para instalar. Seu cliente envia mensagens JSON-RPC com POST e recebe respostas JSON. O servidor expõe apenas ferramentas, sem recursos ou prompts. Uma solicitação GET retorna HTTP 405.

Ele não usa login OAuth. Cada solicitação carrega um token de portador estático. O token pertence a um projeto, então o agente vê apenas os tópicos desse projeto. Cada solicitação é limitada por taxa e tamanho, e um token revogado ou expirado é rejeitado com HTTP 401.

Guia de configuração para cada agente

Cada guia tem a configuração exata para aquele agente, como ele lê e responde a tópicos, e uma lista de solução de problemas.

Ferramentas

As ferramentas de leitura funcionam com qualquer token. As ferramentas de escrita precisam de um token de escrita.

FerramentaEscopoO que faz
whoamiLeituraMostra o projeto, o nome do token e o escopo desta conexão.
list_threadsLeituraLista tópicos. Filtra por status (não resolvido, aberto, em_andamento, precisa_de_revisão, resolvido, todos), responsável, prioridade, etiqueta, página ou horário de atualização.
get_threadLeituraLê um tópico com todos os comentários, autores e reações, além de anexos e qualquer edição de texto sugerida. Defina o nível como compacto, padrão ou detalhado (atributos-chave, componente, arquivo:linha, links vscode:// e cursor://).
get_page_contextLeituraRetorna os tópicos abertos em uma página com suas âncoras, anexos e edições sugeridas.
list_eventsLeituraLê novos tópicos e respostas após um cursor, do mais antigo ao mais novo.
list_assigneesLeituraLista as pessoas e agentes aos quais um tópico pode ser atribuído.
reply_threadEscritaAdiciona uma resposta como o agente.
create_threadEscritaInicia um tópico em uma página em uma âncora específica.
resolve_threadEscritaMarca um tópico como resolvido.
reopen_threadEscritaReabre um tópico resolvido.
mark_suggestion_appliedEscritaMarca uma edição de texto sugerida como aplicada, adiciona uma nota e resolve o tópico.
update_threadEscritaDefine o status, responsável, prioridade, etiquetas ou data de vencimento de um tópico.

get_thread, list_threads e get_page_context retornam uma lista attachments em cada tópico. Cada item tem kind (image, log, metadata, video ou replay), name, mime, size e createdAt. Texto de log e metadados está embutido em text. Imagens, vídeos e replay vêm como um url assinado com um tempo de expiresAt. Um link funciona por 15 minutos, apenas para o projeto e token que o solicitou, e para de funcionar quando esse token é revogado. Senhas, tokens e valores de cookies são mascarados nos logs armazenados. Um tópico com edição de texto sugerida tem um campo suggestion com valores simples de old, new e selector. Um comentário feito em um menu aberto, diálogo, popover, dica ou seção expandida tem um texto ui_state com etapas numeradas que mostram essa interface novamente.

Reaja a novos feedbacks

Chame list_events com since: "latest" para começar de agora. Passe de volta o cursor que ele retorna, e cada chamada retorna apenas novos tópicos e respostas. O guia de fluxo de trabalho do agente mostra o ciclo completo, do comentário à correção.

Outras ferramentas de feedback com MCP

FerramentaAcesso do agentePlano gratuito
pinthreadServidor MCP e tokens de agente em todos os planos, incluindo FreeUS$ 0 por mês, sem teste que expira. Até 10 projetos, 25 membros por projeto, 10.000 comentários por projeto, 100 MB de armazenamento por projeto.
Marker.ioServidor MCP para todos os clientes sem custo extraSem plano gratuito. Teste gratuito de 15 dias.
BugHerdServidor MCP em beta, gratuito para todos os assinantes do BugHerdSem plano gratuito. Teste gratuito de 7 dias.
UserbackConectores MCP em planos pagos2 projetos de feedback. O feedback fica disponível por 7 dias.
HuddlekitMCP em planos pagos1 projeto, 3 membros da equipe e 100 MB de armazenamento
RuttlNenhum MCP listado na página de preços1 projeto, 5 páginas e até 5 usuários

Verificado em 7 de outubro de 2026. Fontes: Preços do Marker.io, MCP do Marker.io, Preços do BugHerd, MCP do BugHerd, Preços do Userback, Preços do Huddlekit, Preços do Ruttl.

Leia todas as alternativas ou veja o que o plano gratuito inclui.

Perguntas

Quais agentes podem usar o servidor MCP pinthread?

Qualquer cliente MCP que suporte HTTP transmissível, incluindo Claude Code, Cursor e Codex. Clientes sem MCP podem usar os comentários copiados como um prompt.

O servidor MCP está incluído no plano gratuito?

Sim. Tokens de agente e acesso MCP estão incluídos em todos os planos, incluindo o Free a US$ 0 por mês.

O agente pode ver meus outros projetos?

Não. Cada token pertence a um projeto, então o agente vê apenas os tópicos desse projeto. Um token de leitura não pode responder, iniciar, resolver ou reabrir tópicos.

O servidor MCP pinthread é remoto ou local?

Remoto. A pinthread o hospeda em https://pinthread.dev/mcp. Seu cliente se conecta via HTTP com um token de portador. Você não executa um processo local. O servidor expõe apenas ferramentas, sem recursos ou prompts, e o endpoint aceita apenas solicitações POST.

Como o servidor MCP autentica?

Com um token de agente que começa com ptk_, enviado como um cabeçalho Authorization: Bearer. Não há login OAuth. Cada token pertence a um projeto e tem escopo de leitura ou escrita. Os tokens expiram após 90 dias por padrão e você pode revogá-los a qualquer momento.