Pinako AI Bridge

A Ponte Pinako AI conecta suas abas do navegador, favoritos, bibliotecas e notas do Pinako ao Claude, Cursor e outros clientes de IA para desktop, permitindo que seu agente consulte, organize e mova informações entre o Pinako e suas outras ferramentas e serviços.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Pinako AI Bridge

Conecte suas abas do navegador e bibliotecas ao Claude Desktop, Cursor e tudo o mais que sua IA puder alcançar.

A ponte do Model Context Protocol (MCP) que conecta o Pinako — uma extensão do Chromium para gerenciamento de árvore de abas — a clientes de IA locais, incluindo Claude Code, Claude Desktop, Cursor, ChatGPT-Codex, VS Code (modo agente do Copilot), Antigravity, Grok Build, Kimi Code, OpenClaw, Hermes, Cline, Zoo Code e qualquer cliente HTTP MCP. Instalações legadas de Windsurf, Roo Code, Continue.dev e Gemini CLI também são configuradas quando presentes.

A ponte roda como um pequeno host de mensagens nativas no seu computador e expõe sua árvore de abas do Pinako, bibliotecas, grupos de bibliotecas, Notas Principais e favoritos do navegador como ferramentas MCP. É uma superfície completa de leitura e escrita: seu assistente de IA pode consultar o estado do navegador e reorganizá-lo — mover e aninhar abas, criar bibliotecas, grupos e pastas, editar títulos, tags, lembretes, cores e notas, encontrar e remover duplicatas e aplicar grandes edições em lote como uma única etapa desfazível.

Como a ponte roda dentro de clientes de IA de desktop como Claude Desktop, Cursor e Codex, o mesmo assistente pode mover informações entre o Pinako e as outras ferramentas, arquivos e serviços aos quais se conecta. Por exemplo:

  • "Copie as notas desta biblioteca de pesquisa para um Google Doc."
  • "Crie uma planilha a partir das abas da minha biblioteca Concorrentes."
  • "Visite as URLs da minha biblioteca de Leitura e escreva um resumo."
  • "Organize minhas abas abertas em bibliotecas por tópico e depois marque as de trabalho."
  • "Encontre e remova meus favoritos duplicados."

As escritas passam pelo mesmo controle de nível, confirmação e mecanismo de desfazer da interface da extensão. Operações destrutivas (exclusões, reordenações de favoritos) retornam um resultado CONFIRMATION_REQUIRED até que o chamador confirme explicitamente, e um lote bulk_apply é aplicado atomicamente como uma única etapa de desfazer. Cada escrita retorna um resultado estruturado {ok, error} para que os clientes possam ramificar com base no código de erro.

Ferramentas

Ferramentas MCP de leitura e escrita. Referência completa por ferramenta com parâmetros: pinako.pro/docs/ai-connect.

Leitura — consulte a árvore, bibliotecas, notas e favoritos, e pesquise

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

Estrutura da árvore — mover, aninhar, agrupar e remover nós

move_node, indent_node, outdent_node, create_group, create_folder, ghost_node, delete_node, delete_live_node, bulk_apply (até 250 suboperações atômicas, desfazíveis como uma única etapa)

Metadados do nó — títulos, tags, lembretes, cores

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

Bibliotecas e grupos de bibliotecas — criar, editar, excluir e 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 — criar e editar Notas Principais e notas de biblioteca

create_note, set_note_content, delete_note

Favoritos — escrever na árvore de favoritos do navegador

add_to_bookmarks (leituras de favoritos usam get_bookmarks; deduplicação usa find_duplicates)

As ferramentas de leitura são seguras para aprovação automática. As ferramentas de escrita são anotadas individualmente (idempotentes, não idempotentes ou destrutivas) para que os clientes MCP possam controlá-las adequadamente.

Instalação

Guia de configuração com capturas de tela e instruções por cliente: pinako.pro/docs/ai-connect

Downloads: pinako.pro/downloads

Instaladores disponíveis:

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

Requisitos

  • Extensão Pinako instalada no seu navegador (Chrome Web Store)
  • Uma assinatura ativa do Pinako (Pro ou superior) — a ponte é controlada pela assinatura

Acesso local e o token de acesso

A ponte escuta em 127.0.0.1:37421 e atende apenas a solicitações de loopback — ela recusa qualquer coisa que carregue um Origin do navegador ou um Host que não seja de loopback, então uma página da web não consegue alcançá-la nem mesmo via rebinding de DNS.

Além disso, acionar as ferramentas de escrita exige um token de acesso local à máquina. O instalador o gera e o escreve na URL configurada de cada cliente de IA:

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

O token fica no diretório de dados do Pinako ao lado do binário do serviço (%APPDATA%\Pinako\mcp-auth-token no Windows, ~/.local/share/pinako/ no Linux, ~/Library/Application Support/Pinako/ no macOS), legível apenas pela sua conta de usuário. Authorization: Bearer <token> também funciona, para clientes que suportam cabeçalhos personalizados.

Trate a URL como uma senha. Qualquer pessoa que a tiver pode ler e alterar suas abas, bibliotecas e notas.

Um cliente configurado sem o token ainda conecta e ainda lê — suas ferramentas de escrita retornam uma mensagem pedindo para você executar novamente o instalador. Isso mantém as configurações existentes funcionando durante a atualização; executar novamente o instalador restaura o acesso total.

Para revogar um token que foi compartilhado ou colado em algum lugar público:

Linux (instalador CLI) — regenera o segredo e reescreve a configuração de cada cliente detectado em uma única etapa:

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

Windows / macOS — o instalador GUI não tem comando de rotação, então gire com o binário do serviço e depois execute novamente o instalador para atualizar seus aplicativos:

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

O token antigo para de funcionar imediatamente: uma ponte em execução percebe a mudança e descarta qualquer sessão já autorizada. Até você executar novamente o instalador, os aplicativos que ainda mantêm a URL antiga voltam ao modo somente leitura.

Compilar a partir do código-fonte

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

As saídas ficam em dist/. Veja setup/build.js para flags de compilação (--all, --no-tauri, --no-cli).

O instalador GUI do Tauri só pode ser compilado na plataforma alvo (ou seja, compile o instalador do Windows no Windows). O instalador CLI faz compilação cruzada para todas as plataformas listadas a partir de qualquer host.

Arquitetura

  • host.js — servidor MCP / host de mensagens nativas do Chrome
  • setup/main.js — instalador CLI (escreve o JSON do host de mensagens nativas, configura os clientes de IA suportados)
  • setup/build.js — compilação em múltiplas etapas (esbuild → pkg → Tauri)
  • installer/src-tauri/ — instalador GUI Rust Tauri para Windows

Licença

MIT