Enviar contexto visual a um agente

O Pinar grava Markdown simples e HTML na área de transferência. O texto inclui anotações legíveis e um bloco JSON pinar-visual-context. Cole tudo como uma unidade; o bloco estruturado é a fonte de verdade legível pela máquina.

Se o pacote listar um caminho absoluto em Screenshot, o agente local deve abrir essa imagem única; os badges numerados são sobreposições. Avisos como screenshot_missing, helper_unavailable ou viewer_unavailable descrevem uma entrega degradada, mas não invalidam comentários e contexto DOM.

A extensão do Chrome nunca digita no campo do agente. No modo Prompt, depois de Command+Enter / Alt+Enter, cole você mesmo a área de transferência no Cursor, Claude, Codex ou Grok. O texto começa dizendo que as notas dos pins podem pedir uma alteração ou uma explicação, e para tratar seletor e caminho DOM como localizadores complementares, seguidas de um bloco JSON pinar-visual-context. Se houver URL de visualizador, busque-a só quando esses detalhes não bastarem. No modo Link, o agente recebe só o link da sessão e precisa de acesso a esse .md (links do Pinar Cloud são privados e exigem API key ou MCP); Desligado apenas salva.

Trate captureId e pinId como identidade, não como rótulos a reescrever. O Visual Context grava hoje schemaVersion 1; o analisador rejeita um captureId ausente e qualquer schemaVersion que não seja 1 ou o legado 0. Siga só o que os pins descrevem. Se a pessoa não colou, peça para copiar de novo no Pinar em vez de reconstruir pins de memória.

• Cole a área de transferência inteira no agente; não redigite comentários nem invente um captureId novo.
• Confirme que o texto colado ainda contém a cerca fechada pinar-visual-context antes de editar código.
• Se nada foi colado, peça Command+Enter / Alt+Enter no Pinar e siga somente as notas dos pins.

O Pinar também expõe as sessões armazenadas pelo Model Context Protocol. Um cliente MCP pode listar projetos, coleções, lotes, sessões, pins e comentários de pins, e pode criá-los, comentá-los, renomeá-los, movê-los, reordená-los e excluí-los.

O serviço Pinar local expõe MCP na sua própria máquina, sem conta, login ou chave de API. O Pinar Cloud exige uma chave de API com a permissão necessária, e o escopo de recurso da chave limita o que o agente pode ler, comentar ou modificar.

Para a configuração do cliente, incluindo o endpoint, o cabeçalho de autenticação e os detalhes do protocolo, consulte o guia de acesso de agentes no repositório do Pinar.

• Uma sessão criada por agente armazena os metadados da página sem screenshot, e um pin de agente armazena o comentário com um localizador opcional, sem geometria medida.
• O MCP não reidrata nem sincroniza o rascunho no navegador; a extensão continua sendo a escritora do rascunho ativo, e um salvamento explícito posterior substitui a sessão armazenada com o mesmo id.
• O compartilhamento continua explícito: publique um share a partir do workspace, ou deixe um agente com a permissão de compartilhar publicar ou revogar.