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.
- Claude Code Adicione o servidor com um comando.
- Cursor Adicione o servidor em .cursor/mcp.json.
- Codex Adicione o servidor em config.toml.
- Fluxo de trabalho do agente O ciclo completo para qualquer agente.
Ferramentas
As ferramentas de leitura funcionam com qualquer token. As ferramentas de escrita precisam de um token de escrita.
| Ferramenta | Escopo | O que faz |
|---|---|---|
whoami | Leitura | Mostra o projeto, o nome do token e o escopo desta conexão. |
list_threads | Leitura | Lista 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_thread | Leitura | Lê 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_context | Leitura | Retorna os tópicos abertos em uma página com suas âncoras, anexos e edições sugeridas. |
list_events | Leitura | Lê novos tópicos e respostas após um cursor, do mais antigo ao mais novo. |
list_assignees | Leitura | Lista as pessoas e agentes aos quais um tópico pode ser atribuído. |
reply_thread | Escrita | Adiciona uma resposta como o agente. |
create_thread | Escrita | Inicia um tópico em uma página em uma âncora específica. |
resolve_thread | Escrita | Marca um tópico como resolvido. |
reopen_thread | Escrita | Reabre um tópico resolvido. |
mark_suggestion_applied | Escrita | Marca uma edição de texto sugerida como aplicada, adiciona uma nota e resolve o tópico. |
update_thread | Escrita | Define 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
| Ferramenta | Acesso do agente | Plano gratuito |
|---|---|---|
| pinthread | Servidor MCP e tokens de agente em todos os planos, incluindo Free | US$ 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.io | Servidor MCP para todos os clientes sem custo extra | Sem plano gratuito. Teste gratuito de 15 dias. |
| BugHerd | Servidor MCP em beta, gratuito para todos os assinantes do BugHerd | Sem plano gratuito. Teste gratuito de 7 dias. |
| Userback | Conectores MCP em planos pagos | 2 projetos de feedback. O feedback fica disponível por 7 dias. |
| Huddlekit | MCP em planos pagos | 1 projeto, 3 membros da equipe e 100 MB de armazenamento |
| Ruttl | Nenhum MCP listado na página de preços | 1 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.