O que é supernote-mcp?
O supernote-mcp, do usuário do GitHub ridget, conecta um cliente MCP a um tablet de tinta eletrônica Ratta Supernote na mesma rede Wi-Fi. Ele captura a tela ao vivo enquanto você escreve, lista arquivos, devolve a escrita reconhecida de um caderno como texto ou as páginas como imagens e copia arquivos para o tablet e do tablet. Usa dois recursos que o tablet já tem: Screen Mirroring na porta 8080 e o servidor de arquivos Browse & Access na porta 8089.
É escrito em TypeScript com licença MIT, publicado no npm e como binários independentes para cinco plataformas, e tem cerca de 2 estrelas no GitHub. A versão 0.2.3, lançada em 22 de setembro de 2026, trouxe a ferramenta de download. Não tem vínculo com a Ratta.
Como instalar supernote-mcp
npx -y supernote-mcpsupernote-mcp vale a pena?
O supernote-mcp faz seis coisas e as faz sem rodeios. supernote_snapshot devolve a tela atual como PNG, as ferramentas de listar, ler e renderizar percorrem os cadernos salvos, e as de upload e download movem arquivos. Ler uma nota devolve como texto o reconhecimento de escrita do próprio tablet, o que custa a um modelo bem menos que imagens; a renderização é limitada a 20 páginas por chamada. Cada ferramenta desiste após 10 segundos com uma mensagem que aponta a causa provável, e nenhuma mexe no tablet antes de ser chamada.
As duas interfaces em que ele se apoia foram obtidas por engenharia reversa, e o README diz isso: o espelhamento de tela e o Browse & Access não são documentados para programas, e uma atualização de firmware pode mudá-los ou quebrá-los. A página de suporte da Ratta descreve o Browse & Access como um servidor de arquivos que se abre num navegador na mesma Wi-Fi, e nem ela nem o README mencionam senha ou PIN. Nada em nenhum dos dois sugere que o tablet limite quem se conecta, então, enquanto um botão estiver ligado, trate a tela ou os arquivos dele como abertos a qualquer pessoa naquela rede.
O porém: o agente ganha acesso a arquivos nos dois sentidos. supernote_upload_file envia qualquer arquivo local que o processo do servidor consiga ler, e supernote_download_file grava num caminho local, $TMPDIR por padrão. Se o endereço configurado falhar, o servidor varre toda a sua sub-rede na porta 8080 para achar o tablet; numa rede de escritório, essa varredura pode disparar um alarme, e SUPERNOTE_DISCOVER=0 a desliga. Uma VPN ou um proxy no computador derruba a conexão.
Nossa opinião: para quem tem um Supernote, planeja no papel e quer o esboço no chat sem exportá-lo, este é o caminho mais curto, e a configuração se resume a dois botões e um endereço IP. Ligue os recursos do tablet só durante a sessão e espere falhas depois de grandes atualizações de firmware até que o único desenvolvedor se atualize.
Onde ele se destaca
Uma gerente de produto que desenha fluxos num Supernote Manta durante as reuniões
Transformar o esboço desta tarde numa especificação escrita
Ligue o Screen Mirroring, peça ao agente uma captura da tela e deixe que ele redija a especificação a partir da imagem. Gratuito; cada captura é uma imagem no contexto do modelo.
Um estudante de pós-graduação com um semestre de anotações de aula num Nomad
Resumir minhas anotações sobre um tema antes de uma prova
Abra o Browse & Access, peça ao agente que liste /Note e depois leia como texto os cadernos certos com supernote_read_note. Notas sem texto reconhecido passam para páginas renderizadas, até 20 por chamada.
Uma advogada que faz anotações em PDFs no tablet
Mandar um rascunho para o meu Supernote e trazer de volta a cópia anotada
Envie o PDF com supernote_upload_file, faça as anotações no aparelho e depois baixe com supernote_download_file. Deixe o Browse & Access desligado na Wi-Fi compartilhada do escritório quando não estiver em uso.
Antes de decidir
- Configuração
- Ligue o Screen Mirroring ou o Browse & Access no tablet e anote o endereço IP; depois rode claude mcp add com SUPERNOTE_IP definido e npx -y supernote-mcp. Exige Node.js 18+, Bun ou o binário independente; uma reserva de DHCP mantém o IP fixo.
- Integrações
- Aparelhos Supernote com Screen Mirroring (da classe Manta, Nomad, A5X e A6X). Usa a biblioteca supernote-typescript para capturar quadros e ler arquivos .note. Qualquer cliente MCP via stdio.
- Dados e privacidade
- Roda localmente via stdio. Imagens da tela, texto das notas e conteúdo dos arquivos vão para o seu provedor de modelos. O espelhamento (porta 8080) e o servidor de arquivos (porta 8089) do tablet ficam acessíveis na rede local enquanto estão ligados. Os uploads leem qualquer arquivo local que o servidor consiga acessar.
- Custo em escala
- Gratuito sob MIT. O tablet é o único custo.
- Limites
- Mesma rede Wi-Fi, sem VPN nem proxy. Interfaces não documentadas podem quebrar com atualizações de firmware. A renderização é limitada a 20 páginas; as chamadas desistem após 10 segundos.
O que é bom
- Lê a escrita reconhecida como texto, não só como imagem
- Limite de 10 segundos com mensagens de erro claras
- Instalação por npm, Bun ou binário independente
- Só mexe no tablet quando uma ferramenta é chamada
O que não é
- Depende de interfaces não documentadas obtidas por engenharia reversa
- O espelhamento e o servidor de arquivos do tablet não pedem senha
- A descoberta de reserva varre toda a sub-rede
- Um único desenvolvedor e cerca de 2 estrelas
Ideal para
Donos de um Supernote Manta, Nomad, A5X ou A6X que escrevem à mão ao planejar ou em reuniões e querem que um agente leia essas páginas.
supernote-mcp: perguntas frequentes
- supernote-mcp vale a pena?
- Uma ponte enxuta e bem-feita que torna a escrita à mão num Supernote útil numa conversa com um agente, apoiada em interfaces não documentadas que a próxima atualização de firmware pode mudar. Damos nota 3.6 de 5.
- Quanto custa supernote-mcp?
- Gratuito e de código aberto (MIT). Exige um Supernote com Screen Mirroring ou Browse & Access.
- Quais são as desvantagens de supernote-mcp?
- Depende de interfaces não documentadas obtidas por engenharia reversa; o espelhamento e o servidor de arquivos do tablet não pedem senha; a descoberta de reserva varre toda a sub-rede; um único desenvolvedor e cerca de 2 estrelas.
- Para quem supernote-mcp é indicado?
- Donos de um Supernote Manta, Nomad, A5X ou A6X que escrevem à mão ao planejar ou em reuniões e querem que um agente leia essas páginas.
- Quanto custa supernote-mcp para uma equipe ou em produção?
- Gratuito sob MIT. O tablet é o único custo.
- supernote-mcp é seguro para dados da empresa?
- Roda localmente via stdio. Imagens da tela, texto das notas e conteúdo dos arquivos vão para o seu provedor de modelos. O espelhamento (porta 8080) e o servidor de arquivos (porta 8089) do tablet ficam acessíveis na rede local enquanto estão ligados. Os uploads leem qualquer arquivo local que o servidor consiga acessar.
Respostas verificadas em 14 de nov. de 2026.