Pinako Ai Bridge

Pinako AI Bridge

ブラウザーのタブやライブラリを、Claude Desktop、Cursor、その他の AI がアクセスできるあらゆるものに接続します。

Pinako — タブツリーを管理する Chromium 拡張機能 — を、Claude Code、Claude Desktop、Cursor、ChatGPT-Codex、VS Code（Copilot エージェントモード）、Antigravity、Grok Build、Kimi Code、OpenClaw、Hermes、Cline、Zoo Code、および任意の HTTP MCP クライアントなどのローカル AI クライアントに接続する Model Context Protocol（MCP）ブリッジです。Windsurf、Roo Code、Continue.dev、Gemini CLI の旧バージョンも、インストールされている場合は設定されます。

このブリッジは、お使いのコンピューター上で小さなネイティブメッセージングホストとして動作し、Pinako のタブツリー、ライブラリ、ライブラリグループ、メインノート、ブラウザーのブックマークを MCP ツールとして公開します。完全な読み取り・書き込み機能を備えており、AI アシスタントはブラウザーの状態を照会できるだけでなく、タブの移動や入れ子化、ライブラリ、グループ、フォルダーの作成、タイトル、タグ、メモ、色、ノートの編集、重複の検索と削除、さらに大規模な変更の一括適用を、単一の取り消し可能な操作として実行できます。

このブリッジは Claude Desktop、Cursor、Codex などのデスクトップ AI クライアント内で動作するため、同じアシスタントが Pinako と、接続先の他のツール、ファイル、サービスとの間で情報を移動できます。たとえば、次のように依頼できます。

• 「この調査ライブラリのノートを Google ドキュメントにコピーして。」
• 「競合他社ライブラリのタブからスプレッドシートを作成して。」
• 「読書ライブラリの URL にアクセスして、要約を作成して。」
• 「開いているタブをトピック別にライブラリに整理してから、仕事関連のものにタグを付けて。」
• 「重複したブックマークを探して削除して。」

書き込みは、拡張機能の UI と同じプラン制限、確認、取り消しの仕組みを通ります。破壊的な操作（削除、ブックマークの並べ替え）は、呼び出し元が明示的に確認するまで CONFIRMATION_REQUIRED の結果を返します。また、bulk_apply の一括処理は、1 回の取り消し操作としてアトミックに適用されます。すべての書き込みは、クライアントがエラーコードに応じて処理を分岐できるよう、構造化された {ok, error} の結果を返します。

ツール

読み取りおよび書き込み用の MCP ツールです。各ツールのパラメーターを含む詳細なリファレンスは、pinako.pro/docs/ai-connect をご覧ください。

読み取り — ツリー、ライブラリ、ノート、ブックマークの照会と検索

get_tree、get_tree_summary、search_tabs、search_pinako、search_docs、list_libraries、get_library、get_main_tree_notes、get_bookmarks、list_browsers、find_duplicates

ツリー構造 — ノードの移動、入れ子化、グループ化、削除

move_node、indent_node、outdent_node、create_group、create_folder、ghost_node、delete_node、delete_live_node、bulk_apply（最大 250 件のアトミックなサブ操作を、1 回の取り消し操作として適用可能）

ノードのメタデータ — タイトル、タグ、メモ、色

set_title、set_tags、add_tags、remove_tags、set_memo、set_star_color、set_row_color

ライブラリとライブラリグループ — 作成、編集、削除、並べ替え

create_library、add_to_library、set_library_title、set_library_description、delete_library、create_library_group、set_library_group_title、set_library_group_description、delete_library_group、add_library_to_group、remove_library_from_group、reorder_library_panel、reorder_libraries_in_group

ノート — メインノートとライブラリのノートを作成、編集

create_note、set_note_content、delete_note

ブックマーク — ブラウザーのブックマークツリーに書き込み

add_to_bookmarks（ブックマークの読み取りには get_bookmarks を使用し、重複の検出には find_duplicates を使用します）

読み取りツールは安全に自動承認できます。書き込みツールにはそれぞれ、べき等、非べき等、破壊的のいずれかが注記されているため、MCP クライアントは適切に実行を制御できます。

インストール

スクリーンショットとクライアントごとの手順を含むセットアップガイド： pinako.pro/docs/ai-connect

ダウンロード： pinako.pro/downloads

利用可能なインストーラー：

• Windows — グラフィカルインストーラー（.exe）
• Linux x64 および Linux ARM64 — CLI インストーラー

要件

• ブラウザーに Pinako 拡張機能がインストールされていること（Chrome ウェブストア）
• 有効な Pinako サブスクリプション（Pro 以上）があること — ブリッジの利用にはサブスクリプションが必要です

ローカルアクセスとアクセストークン

ブリッジは 127.0.0.1:37421 でリッスンし、ループバックリクエストのみを受け付けます。ブラウザーの Origin を含むリクエストや、ループバック以外の Host を持つリクエストは拒否するため、DNS リバインディングを使ってもウェブページからアクセスすることはできません。

さらに、書き込みツールを操作するには、マシンローカルのアクセストークンが必要です。インストーラーがトークンを生成し、各 AI クライアントの設定済み URL に書き込みます。

http://127.0.0.1:37421/mcp?token=<your-token>

トークンは、サービスバイナリと同じ Pinako データディレクトリに保存されます（Windows では %APPDATA%\Pinako\mcp-auth-token、Linux では ~/.local/share/pinako/、macOS では ~/Library/Application Support/Pinako/）。読み取り可能なのは、お使いのユーザーアカウントのみです。カスタムヘッダーに対応したクライアントでは、Authorization: Bearer <token> も使用できます。

URL はパスワードのように扱ってください。 URL を知っている人は、タブ、ライブラリ、メモを読み取ったり変更したりできます。

トークンを設定せずに構成したクライアントも接続でき、読み取りも引き続き可能です。ただし、書き込みツールを実行すると、インストーラーを再実行するよう求めるメッセージが返されます。これにより、アップグレード後も既存の設定をそのまま使用できます。インストーラーを再実行すると、完全なアクセス権が復元されます。

共有したり、公開の場に貼り付けたりしたトークンを無効にするには、次の手順を実行します。

Linux（CLI インストーラー）— シークレットを再生成し、検出されたすべてのクライアントの設定を書き換えます。

pinako-ai-bridge-cli-linux-x64 rotate-token

Windows / macOS — GUI インストーラーにはトークンのローテーション機能がないため、サービスバイナリでトークンをローテーションしてから、インストーラーを再実行してアプリを更新します。

"%APPDATA%\Pinako\pinako-mcp-service.exe" --rotate-token

古いトークンはすぐに使えなくなります。起動中の Bridge は変更を検知し、すでに認証済みのセッションをすべて切断します。インストーラーを再実行するまでは、古い URL を保持しているアプリは拒否され、その旨を示すメッセージが表示されます。

ソースからビルドする

git clone https://github.com/teleomorph/pinako-mcp.git
cd pinako-mcp
npm install
node setup/build.js --all

出力先は dist/ です。ビルドフラグ（--all、--no-tauri、--no-cli）については setup/build.js を参照してください。

Tauri GUI インストーラーは、対象プラットフォーム上でのみビルドできます（つまり、Windows インストーラーは Windows 上でビルドします）。CLI インストーラーは、任意のホストから、一覧にあるすべてのプラットフォーム向けにクロスコンパイルできます。

アーキテクチャ

• host.js — MCP サーバー／Chrome ネイティブメッセージングホスト
• setup/main.js — CLI インストーラー（ネイティブメッセージングホストの JSON を書き込み、対応する AI クライアントを設定）
• setup/build.js — 複数段階のビルド（esbuild → pkg → Tauri）
• installer/src-tauri/ — Windows 向け Rust Tauri GUI インストーラー

ライセンス

MIT