ビジュアルコンテキストをエージェントへ送る

Pinar はプレーンな Markdown と HTML をクリップボードに書き込みます。テキストには、読める注釈と、囲まれた pinar-visual-context JSON ブロックが含まれます。両方をひとまとまりとして貼ってください。構造化ブロックが機械可読の正本です。

バンドルに絶対パスの Screenshot がある場合、ローカルエージェントはその1枚の画像を開く必要があります。番号バッジはオーバーレイです。screenshot_missing、helper_unavailable、viewer_unavailable などの警告は、配信が劣化していることを示しますが、コメントと DOM コンテキストは無効になりません。

Chrome 拡張機能がエージェントの入力欄へ入力することはありません。「プロンプト」モードでは、Command+Enter / Alt+Enter のあと、クリップボードを自分で Cursor、Claude、Codex、Grok へ貼ってください。テキストは、ピン注記が変更の依頼か説明を求める質問かもしれないこと、およびセレクターと DOM パスを相補的なロケーターとして扱うことから始まり、続けて囲まれた pinar-visual-context JSON ブロックがあります。ビューアー URL が含まれる場合、それらの詳細では足りないときだけ取得してください。「リンク」モードでは、エージェントはセッションのリンクだけを受け取り、その .md へアクセスできる必要があります（Pinar Cloud のリンクは非公開で、API key または MCP が必要です）。「オフ」は保存のみです。

captureId と pinId は識別子であり、書き換えるラベルではありません。Visual Context は現在 schemaVersion 1 を符号化します。parseVisualCapture は欠落した captureId と、1 でもレガシー 0 でもない schemaVersion を拒否します。ピンが述べていることだけに従ってください。相手が一度も貼っていない場合は、記憶からピンを再構成せず、Pinar から再度コピーするよう依頼してください。

• クリップボード全体をエージェントへ貼ってください。コメントを打ち直したり、新しい captureId を作ったりしないでください。
• コード編集を始める前に、貼ったテキストに閉じた pinar-visual-context フェンスが残っていることを確認してください。
• 何も貼られていない場合は、Pinar で Command+Enter / Alt+Enter を頼み、ピン注記だけに従ってください。

Pinar は保存されたセッションを Model Context Protocol でも公開します。MCP クライアントはプロジェクト、コレクション、バッチ、セッション、ピン、ピンコメントを一覧でき、それらを作成、コメント、名前変更、移動、並べ替え、削除できます。

Pinar ローカルサービスは、ご自身のマシン上でアカウント、ログイン、API キーなしに MCP を公開します。Pinar Cloud には必要な権限を持つ API キーが必要で、キーのリソーススコープがエージェントが読める、コメントできる、変更できる範囲を限定します。

クライアント設定（エンドポイント、認証ヘッダー、プロトコルの詳細を含む）は、Pinar リポジトリの エージェントアクセスガイド を参照してください。

• エージェントが作成したセッションはスクリーンショットなしでページメタデータのみを保存し、エージェントのピンは測定されたジオメトリではなく、任意のロケーター付きのコメントを保存します。
• MCP はブラウザ内のドラフトを再構築も同期もせず、拡張機能がアクティブなドラフトの書き手であり続けます。後の明示的な保存は、同じ id で保存されたセッションを置き換えます。
• 共有は明示的なままです。ワークスペースから共有を公開するか、共有権限を持つエージェントに公開・取り消しさせます。