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.

La aplicación local de Pinar ofrece la misma superficie Model Context Protocol a los agentes que se ejecutan en el mismo equipo, y es abierta por diseño: no interviene ninguna cuenta, inicio de sesión ni clave de API. Apunta el cliente MCP de tu agente al endpoint descrito en la sección de acceso de agentes a sesiones del README de Pinar.

La sección de herramientas MCP locales del README lista cada herramienta con sus argumentos y valor de retorno. Las herramientas de listado paginan sus resultados, hasta 50 elementos por página, para que un agente recorra un espacio de trabajo grande una página a la vez. Las herramientas de reordenación esperan la lista completa de elementos y rechazan una parcial antes de que se mueva nada.

• Como la conexión es local, el agente solo trabaja con las capturas almacenadas en este equipo y nunca necesita Pinar Cloud.
• La mayor parte de la superficie de herramientas de la nube está disponible localmente; los extras exclusivos de la nube conciernen a las claves de agente y a la publicación de shares.

Pinar Cloud permite a las cuentas Pro emitir claves de agente dedicadas. Abre Configuración → “Acceso de agentes” en el espacio de trabajo para crear una: dale un nombre a la clave, elige un permiso — “Lectura”, “Gestionar”, “Compartir” o “Completo” — y una caducidad de 7, 30 o 90 días. Una clave de “Lectura” puede limitarse a toda la cuenta o a un proyecto, colección, sesión o lote. Los otros permisos actúan sobre toda la cuenta.

La clave se muestra solo una vez, justo después de crearla, así que cópiala antes de que se cierre el diálogo — Pinar solo conserva un prefijo corto y no puede mostrar la clave otra vez. Pueden existir hasta 20 claves activas a la vez. Cada clave listada muestra su ámbito, permiso, caducidad y último uso, y “Revocar” la termina de inmediato. Una solicitud de un recurso fuera del ámbito de la clave se responde como si el recurso no existiera, de modo que una clave nunca revela lo que hay más allá de su ámbito. La guía de acceso de agentes en la nube documenta la matriz de permisos y la superficie completa de herramientas detrás de cada clave.

• Dale a cada agente o automatización su propia clave, para que revocar una no perturbe a las otras.
• Las claves funcionan con clientes MCP que admiten cabeceras personalizadas y con los enlaces privados de Markdown; el panel “Acceso de agentes” explica cómo se usa la clave.