Pinako AI Bridge

Pinako AI Bridge conecta tus pestañas del navegador, marcadores, bibliotecas de Pinako y notas a Claude, Cursor y otros clientes de IA de escritorio, para que tu agente pueda consultarlos, organizarlos y mover información entre Pinako y tus otras herramientas y servicios.

GitHub
1
Prueba este MCPPatrocinado

Documentación

Pinako AI Bridge

Conecta las pestañas y bibliotecas de tu navegador con Claude Desktop, Cursor y todo lo demás que tu IA pueda alcanzar.

El puente del Protocolo de Contexto de Modelo (MCP) que conecta Pinako, una extensión de Chromium para la gestión de árboles de pestañas, con clientes de IA locales, incluidos Claude Code, Claude Desktop, Cursor, ChatGPT-Codex, VS Code (modo agente de Copilot), Antigravity, Grok Build, Kimi Code, OpenClaw, Hermes, Cline, Zoo Code y cualquier cliente HTTP MCP. Las instalaciones heredadas de Windsurf, Roo Code, Continue.dev y Gemini CLI también se configuran cuando están presentes.

El puente se ejecuta como un pequeño host de mensajería nativa en tu computadora y expone tu árbol de pestañas de Pinako, bibliotecas, grupos de bibliotecas, Notas Principales y marcadores del navegador como herramientas MCP. Es una superficie completa de lectura y escritura: tu asistente de IA puede consultar el estado de tu navegador y reorganizarlo: mover y anidar pestañas, crear bibliotecas, grupos y carpetas, editar títulos, etiquetas, memos, colores y notas, encontrar y eliminar duplicados, y aplicar ediciones masivas grandes como un solo paso deshacible.

Debido a que el puente se ejecuta dentro de clientes de IA de escritorio como Claude Desktop, Cursor y Codex, el mismo asistente puede mover información entre Pinako y las otras herramientas, archivos y servicios a los que se conecta. Por ejemplo:

  • "Copia las notas de esta biblioteca de investigación en un Google Doc."
  • "Crea una hoja de cálculo a partir de las pestañas de mi biblioteca Competitors."
  • "Visita las URL de mi biblioteca Reading y escribe un resumen."
  • "Organiza mis pestañas abiertas en bibliotecas por tema y luego etiqueta las de trabajo."
  • "Encuentra y elimina mis marcadores duplicados."

Las escrituras pasan por el mismo control de niveles, confirmación y mecanismo de deshacer que la interfaz de la propia extensión. Las operaciones destructivas (eliminaciones, reordenamientos de marcadores) devuelven un resultado CONFIRMATION_REQUIRED hasta que el llamador confirme explícitamente, y un lote bulk_apply se aplica atómicamente como un solo paso de deshacer. Cada escritura devuelve un resultado estructurado {ok, error} para que los clientes puedan ramificar según el código de error.

Herramientas

Herramientas MCP de lectura y escritura. Referencia completa por herramienta con parámetros: pinako.pro/docs/ai-connect.

Lectura — consulta el árbol, bibliotecas, notas y marcadores, y búsqueda

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

Estructura del árbol — mover, anidar, agrupar y eliminar nodos

move_node, indent_node, outdent_node, create_group, create_folder, ghost_node, delete_node, delete_live_node, bulk_apply (hasta 250 suboperaciones atómicas, deshacibles como un solo paso)

Metadatos de nodo — títulos, etiquetas, memos, colores

set_title, set_tags, add_tags, remove_tags, set_memo, set_star_color, set_row_color

Bibliotecas y grupos de bibliotecas — crear, editar, eliminar y organizar

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

Notas — crear y editar Notas Principales y notas de biblioteca

create_note, set_note_content, delete_note

Marcadores — escribir en el árbol de marcadores del navegador

add_to_bookmarks (las lecturas de marcadores usan get_bookmarks; la deduplicación usa find_duplicates)

Las herramientas de lectura son seguras para aprobación automática. Las herramientas de escritura están anotadas individualmente (idempotentes, no idempotentes o destructivas) para que los clientes MCP puedan controlarlas adecuadamente.

Instalación

Guía de configuración con capturas de pantalla e instrucciones por cliente: pinako.pro/docs/ai-connect

Descargas: pinako.pro/downloads

Instaladores disponibles:

  • Windows — instalador gráfico (.exe)
  • Linux x64 y Linux ARM64 — instalador CLI

Requisitos

  • Extensión Pinako instalada en tu navegador (Chrome Web Store)
  • Una suscripción activa de Pinako (Pro o superior): el puente está controlado por suscripción

Acceso local y token de acceso

El puente escucha en 127.0.0.1:37421 y solo atiende solicitudes de loopback: rechaza cualquier cosa que lleve un Origin del navegador o un Host que no sea de loopback, por lo que una página web no puede alcanzarlo ni siquiera mediante rebinding de DNS.

Más allá de eso, usar las herramientas de escritura requiere un token de acceso local a la máquina. El instalador lo genera y lo escribe en la URL configurada de cada cliente de IA:

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

El token vive en tu directorio de datos de Pinako junto al binario del servicio (%APPDATA%\Pinako\mcp-auth-token en Windows, ~/.local/share/pinako/ en Linux, ~/Library/Application Support/Pinako/ en macOS), legible solo por tu cuenta de usuario. Authorization: Bearer <token> también funciona, para clientes que admiten encabezados personalizados.

Trata la URL como una contraseña. Cualquiera que la tenga puede leer y cambiar tus pestañas, bibliotecas y notas.

Un cliente configurado sin el token aún se conecta y aún lee: sus herramientas de escritura devuelven un mensaje pidiéndote que vuelvas a ejecutar el instalador. Eso mantiene funcionando las configuraciones existentes durante la actualización; volver a ejecutar el instalador restaura el acceso completo.

Para revocar un token que se haya compartido o pegado en algún lugar público:

Linux (instalador CLI) — regenera el secreto y reescribe la configuración de cada cliente detectado en un solo paso:

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

Windows / macOS — el instalador GUI no tiene comando de rotación, así que rota con el binario del servicio y luego vuelve a ejecutar el instalador para actualizar tus aplicaciones:

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

El token anterior deja de funcionar de inmediato: un Bridge en ejecución nota el cambio y elimina cualquier sesión ya autorizada. Hasta que vuelvas a ejecutar el instalador, las aplicaciones que aún tengan la URL anterior pasan a modo de solo lectura.

Compilar desde el código fuente

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

Los resultados se guardan en dist/. Consulta setup/build.js para las banderas de compilación (--all, --no-tauri, --no-cli).

El instalador GUI de Tauri solo se puede compilar en la plataforma a la que apunta (es decir, compila el instalador de Windows en Windows). El instalador CLI se compila de forma cruzada para todas las plataformas listadas desde cualquier host.

Arquitectura

  • host.js — servidor MCP / host de mensajería nativa de Chrome
  • setup/main.js — instalador CLI (escribe el JSON del host de mensajería nativa, configura los clientes de IA compatibles)
  • setup/build.js — compilación de múltiples etapas (esbuild → pkg → Tauri)
  • installer/src-tauri/ — instalador GUI de Rust Tauri para Windows

Licencia

MIT