Enviar contexto visual a un agente

Pinar escribe Markdown plano y HTML en el portapapeles. El texto incluye anotaciones legibles más un bloque JSON pinar-visual-context delimitado. Pega ambos como una unidad; el bloque estructurado es la fuente de verdad legible por máquina.

Si el paquete lista una ruta absoluta de Screenshot, el agente local debe abrir esa única imagen; las insignias numeradas son superposiciones. Avisos como screenshot_missing, helper_unavailable o viewer_unavailable describen una entrega degradada, pero no invalidan los comentarios ni el contexto DOM.

La extensión de Chrome nunca escribe en el compositor del agente. En modo Prompt, después de Command+Enter / Alt+Enter, pega tú mismo el portapapeles en Cursor, Claude, Codex o Grok. El texto empieza diciendo que las notas de los pins pueden pedir un cambio o una explicación, y tratar el selector y el camino DOM como localizadores complementarios, seguidas de un bloque JSON pinar-visual-context delimitado. Si se incluye una URL de Viewer, recupérala solo cuando esos detalles no basten. En modo Enlace, el agente recibe solo el enlace de la sesión y necesita acceso a ese .md (los enlaces de Pinar Cloud son privados y requieren API key o MCP); No solo guarda.

Trata captureId y pinId como identidad, no como etiquetas a reescribir. Visual Context actualmente codifica schemaVersion 1; parseVisualCapture rechaza un captureId ausente y cualquier schemaVersion distinto de 1 o el legado 0. Sigue solo lo que describen los pins. Si la persona nunca pegó, pídele que copie de nuevo desde Pinar en lugar de reconstruir pins de memoria.

• Pega el portapapeles entero en el agente; no reescribas comentarios ni inventes un captureId nuevo.
• Confirma que el texto pegado aún contiene un cierre de cerca pinar-visual-context antes de empezar a editar código.
• Si no se pegó nada, pide Command+Enter / Alt+Enter en Pinar y sigue solo las notas de los pins.

Pinar también expone sus sesiones guardadas a través del Model Context Protocol. Un cliente MCP puede listar proyectos, colecciones, lotes, sesiones, pins y comentarios de pins, y puede crearlos, comentarlos, renombrarlos, moverlos, reordenarlos y eliminarlos.

El servicio Pinar local expone MCP en tu propio equipo sin cuenta, inicio de sesión ni clave de API. Pinar Cloud requiere una clave de API con el permiso necesario, y el ámbito de recursos de la clave limita lo que el agente puede leer, comentar o modificar.

Para la configuración del cliente, incluido el endpoint, la cabecera de autenticación y los detalles del protocolo, consulta la guía de acceso de agentes en el repositorio de Pinar.

• Una sesión creada por un agente guarda los metadatos de la página sin captura, y un pin de agente guarda el comentario con un localizador opcional en lugar de una geometría medida.
• MCP no rehidrata ni sincroniza el borrador en el navegador; la extensión sigue siendo quien escribe el borrador activo, y un guardado explícito posterior reemplaza la sesión guardada con el mismo id.
• Compartir sigue siendo explícito: publica un share desde el espacio de trabajo, o deja que un agente con el permiso de compartir lo publique o lo revogue.