Seu assistente de IA já sabe muita coisa sobre o problema de agora e nada sobre os oito meses de notas em que você já resolveu uma versão dele.
O servidor MCP do Notez fecha essa lacuna. O Model Context Protocol é um padrão aberto para conectar assistentes a ferramentas e dados externos, e o Notez vem com um servidor MCP que expõe o seu espaço de trabalho por esse protocolo.
Configuração
1. Gere uma chave. No Notez, vá em Configurações → Integrações, encontre Servidor MCP do Notez e clique em Gerar chave MCP. Copie o endpoint e o bearer token: o token aparece uma vez só.
2. Adicione a chave ao seu cliente. A página Integrações traz um comando pronto para colar no Claude Code, com o endpoint e o token já preenchidos, e também a configuração JSON para Claude Code, Cursor e Windsurf, com o local certo do arquivo para cada um. O Claude (web, desktop e celular), o ChatGPT e o VS Code não usam chave: eles se conectam pelo login, no cartão Conecte um aplicativo de IA da mesma página.
Copie dessa página em vez de digitar à mão: o cabeçalho de autorização precisa estar exatamente certo, senão todas as chamadas falham.
3. Reinicie o cliente e pergunte algo sobre as suas notas.
As ferramentas
Uma chave dá ao assistente 31 ferramentas: 13 de leitura e 18 de escrita. A tabela lista as que ele usa primeiro, e a Configuração do servidor MCP lista todas.
Ferramenta | O que faz |
|---|---|
| A qual espaço de trabalho esta chave está vinculada |
| Pesquisa e lista, com filtros e paginação |
| Uma nota, resumida ou completa |
| As notas filhas diretas de uma nota |
| A cadeia de navegação até a raiz |
| Todas as tags, com o número de notas de cada uma |
| Busca semântica por significado, até 5 resultados |
| Um quadro kanban com os cartões agrupados por coluna |
| Cria uma nota, com suporte a Markdown |
| Muda uma parte da nota e deixa o resto intacto |
| Move cartões entre as colunas de um quadro |
| Manda uma nota para a lixeira ou a traz de volta |
list_notes aceita busca por substring, filtros de tag, colunas do quadro, valores de propriedades personalizadas, datas de criação e de atualização, tipo de nota, só favoritos, só notas de nível superior, lixeira, ordenação e paginação. Assim o assistente navega por um espaço de trabalho grande sem puxar tudo para o contexto.
Dois limites que vale conhecer desde o início
Ele não apaga a estrutura. Uma chave lê e escreve: o assistente cria, edita, renomeia, coloca tags e move notas, manda notas para a lixeira e as restaura. Nenhuma ferramenta apaga uma tag, uma propriedade, uma opção ou uma coluna do quadro, então remover essas coisas fica por sua conta. O chat de IA do app usa as mesmas ferramentas, exceto as duas de upload de arquivos.
As chaves ficam presas ao espaço de trabalho. Uma chave gerada no espaço de trabalho "Trabalho" dá acesso só a ele. Para expor um segundo espaço de trabalho, mude para ele e gere uma chave separada. Rotacione qualquer chave na mesma tela.
Para que isso serve na prática
Fechar uma sessão com um registro escrito. O momento mais valioso de uma depuração é logo depois que tudo funciona, e é justamente quando você tem menos vontade de anotar alguma coisa. "Crie uma nota chamada Esgotamento do pool do Postgres com o que acabamos de descobrir, com a tag infra." Pronto, antes de você fechar o terminal.
Recuperar o contexto anterior. "Pesquise nas minhas notas tudo sobre rate limiting antes de projetarmos isto." O assistente lê o que você concluiu no passado em vez de deduzir tudo de novo, talvez de outro jeito.
Preparar reuniões. "Encontre todas as minhas notas com a tag acme dos últimos dois meses e resuma os assuntos em aberto."
Ver quem escreveu o quê. As notas criadas via MCP levam um selo MCP, então você sempre distingue o que o assistente escreveu do que você escreveu.
Sobre confiança
Uma chave MCP dá acesso de leitura e escrita a um espaço de trabalho inteiro. Trate-a como qualquer outra credencial: ela aparece uma vez, fica no arquivo de configuração do seu cliente e precisa ser rotacionada se vazar. Rotacionar é um clique na página Integrações e invalida a chave antiga na hora.
O vínculo com o espaço de trabalho é a proteção que conta aqui. Se você mantém notas pessoais e de trabalho em espaços de trabalho separados (a configuração recomendada), uma chave em um projeto de trabalho não alcança nada pessoal. O servidor garante isso em cada chamada de ferramenta; não depende de instruções no prompt.
Continue lendo
Segundo cérebro com IA: memória persistente para Claude e Cursor via MCP — um espaço de trabalho de notas como a memória que todo assistente lê e escreve, e o que deve entrar nela.
Suas anotações no Claude e no ChatGPT, sem chave de API — como adicionar o Notez ao Claude, ao ChatGPT ou ao VS Code com uma URL e um login, e como retirar o acesso depois.
O Claude Code agora coloca imagens nas suas anotações: upload de arquivos via MCP — como um assistente com acesso ao terminal coloca uma captura de tela em uma nota sem passá-la pelo chat.