Visuellen Kontext an einen Agenten senden

Pinar schreibt reines Markdown und HTML in die Zwischenablage. Der Text enthält lesbare Annotationen plus einen abgegrenzten pinar-visual-context-JSON-Block. Füge beides als eine Einheit ein; der strukturierte Block ist die maschinenlesbare Quelle der Wahrheit.

Wenn das Bundle einen absoluten Screenshot-Pfad auflistet, sollte der lokale Agent dieses einzelne Bild öffnen; nummerierte Badges sind Overlays. Warnungen wie screenshot_missing, helper_unavailable oder viewer_unavailable beschreiben eine eingeschränkte Zustellung, machen die Kommentare und den DOM-Kontext jedoch nicht ungültig.

Die Chrome-Erweiterung tippt niemals in den Agent-Composer. Im Prompt-Modus füge die Zwischenablage nach Command+Enter / Alt+Enter selbst in Cursor, Claude, Codex oder Grok ein. Der Text beginnt damit, dass die Pin-Notizen eine Änderung oder eine Erklärung erbitten können, und Selektor und DOM-Pfad als ergänzende Locator zu behandeln, gefolgt von einem abgegrenzten pinar-visual-context-JSON-Block. Wenn eine Viewer-URL enthalten ist, rufe sie nur ab, wenn diese Details nicht ausreichen. Im Link-Modus erhält der Agent nur den Sitzungslink und braucht Zugriff auf diese .md (Pinar-Cloud-Links sind privat und erfordern API-Key oder MCP); Aus speichert nur.

Behandle captureId und pinId als Identität, nicht als Labels zum Umschreiben. Visual Context kodiert derzeit schemaVersion 1; parseVisualCapture lehnt eine fehlende captureId und jede schemaVersion außer 1 oder dem Legacy-Wert 0 ab. Folge nur dem, was die Pins beschreiben. Wenn die Person nichts eingefügt hat, bitte sie, erneut aus Pinar zu kopieren, statt Pins aus dem Gedächtnis zu rekonstruieren.

• Füge die gesamte Zwischenablage in den Agenten ein; tippe Kommentare nicht ab und erfinde keine neue captureId.
• Bestätige, dass der eingefügte Text noch einen geschlossenen pinar-visual-context-Fence enthält, bevor du Code bearbeitest.
• Wenn nichts eingefügt wurde, bitte um Command+Enter / Alt+Enter in Pinar und folge nur den Pin-Notizen.

Pinar stellt seine gespeicherten Sitzungen außerdem über das Model Context Protocol bereit. Ein MCP-Client kann Projekte, Collections, Chargen, Sitzungen, Pins und Pin-Kommentare auflisten und sie anlegen, kommentieren, umbenennen, verschieben, neu anordnen oder löschen.

Der lokale Pinar-Dienst bietet MCP auf deinem eigenen Rechner an, ohne Konto, Login oder API-Schlüssel. Pinar Cloud verlangt einen API-Schlüssel mit der nötigen Berechtigung, und der Ressourcenumfang des Schlüssels begrenzt, was der Agent lesen, kommentieren oder ändern kann.

Für die Client-Konfiguration, einschließlich Endpunkt, Authentifizierungs-Header und Protokolldetails, siehe den Agenten-Zugangsleitfaden im Pinar-Repository.

• Eine vom Agenten angelegte Sitzung speichert die Seitendaten ohne Screenshot, und ein Agenten-Pin speichert den Kommentar mit einem optionalen Locator statt gemessener Geometrie.
• MCP rehydratisiert oder synchronisiert den Browser-Entwurf nicht; die Erweiterung bleibt die Schreibende des aktiven Entwurfs, und ein späteres explizites Speichern ersetzt die gespeicherte Sitzung unter derselben id.
• Teilen bleibt explizit: Veröffentliche einen Share aus dem Workspace oder lass einen Agenten mit der Teilen-Berechtigung ihn veröffentlichen oder widerrufen.

Die lokale Pinar-Anwendung bietet dieselbe Model-Context-Protocol-Oberfläche für Agenten, die auf demselben Computer laufen, und ist bewusst offen: Kein Konto, Login oder API-Schlüssel ist beteiligt. Richte den MCP-Client deines Agenten auf den Endpunkt ein, der im Abschnitt „Agent access to sessions“ der Pinar-README beschrieben ist.

Der Abschnitt „Local MCP tools“ der README listet jedes Tool mit seinen Argumenten und Rückgabewerten. List-Tools gliedern ihre Ergebnisse in Seiten, bis zu 50 pro Seite, sodass ein Agent einen großen Workspace Seite für Seite durchläuft. Reorder-Tools erwarten die vollständige Liste der Elemente und lehnen eine teilweise ab, bevor sich etwas bewegt.

• Weil die Verbindung lokal ist, arbeitet der Agent nur mit den auf diesem Computer gespeicherten Aufnahmen und braucht Pinar Cloud nie.
• Der größte Teil der Cloud-Tool-Oberfläche ist lokal verfügbar; die nur-cloud-Ergänzungen betreffen Agenten-Schlüssel und das Veröffentlichen von Shares.

Pinar Cloud lässt Pro-Konten dedizierte Agenten-Schlüssel ausgeben. Öffne im Workspace Einstellungen → „Agentenzugriff“, um einen zu erstellen: Gib dem Schlüssel einen Namen, wähle eine Berechtigung — „Lesen“, „Verwalten“, „Teilen“ oder „Vollständig“ — und eine Gültigkeit von 7, 30 oder 90 Tagen. Ein „Lesen“-Schlüssel kann auf das gesamte Konto oder auf ein Projekt, eine Collection, eine Sitzung oder eine Charge beschränkt werden. Die anderen Berechtigungen wirken auf das gesamte Konto.

Der Schlüssel wird nur einmal angezeigt, direkt nach der Erstellung, also kopiere ihn, bevor der Dialog schließt — Pinar behält nur ein kurzes Präfix und kann den Schlüssel nicht erneut zeigen. Bis zu 20 aktive Schlüssel können gleichzeitig existieren. Jeder gelistete Schlüssel zeigt seinen Umfang, seine Berechtigung, seine Gültigkeit und die letzte Nutzung, und „Widerrufen“ beendet ihn sofort. Eine Anfrage nach einer Ressource außerhalb des Schlüsselumfangs wird so beantwortet, als existiere die Ressource nicht, sodass ein Schlüssel nie zeigt, was jenseits seines Umfangs liegt. Der Agenten-Zugangsleitfaden dokumentiert die Berechtigungs-Matrix und die vollständige Tool-Oberfläche hinter jedem Schlüssel.

• Gib jedem Agenten oder jeder Automatisierung seinen eigenen Schlüssel, damit der Widerruf eines die anderen nicht stört.
• Schlüssel funktionieren mit MCP-Clients, die benutzerdefinierte Header unterstützen, und mit den privaten Markdown-Links; das „Agentenzugriff“-Panel erklärt, wie der Schlüssel verwendet wird.