Conectar apps de IA (Beta)
Última revisão: 2026-11-20
Apps de IA no seu computador — Claude Code, Claude Desktop, Cursor, VS Code e outros que falam o Model Context Protocol (MCP) — podem ler o seu vault pelo Plainva: pesquisar nele, ler notas e suas seções, estruturas, backlinks, bancos de dados, tarefas e notas recentes, e abrir uma nota no Plainva. Sozinhos eles não mudam nada: um app a que você permitir pode sugerir alterações, e elas esperam até você decidir (veja abaixo). Isso faz parte das funções experimentais de IA e funciona só no desktop.
O sentido contrário — o assistente do Plainva usando ferramentas de servidores que você mesmo conecta — está descrito em Ferramentas externas na página Assistente de IA.
Um terceiro caminho — o Plainva inicia um agente de IA de outro fabricante na pasta do vault, com a sessão dele na aba de IA — está descrito em Agentes externos.
Como funciona
O Plainva traz ao lado do app um pequeno programa auxiliar, plainva-mcp. Um app de IA o inicia, e o programa auxiliar se conecta ao Plainva em execução por um canal privado deste computador — um named pipe no Windows, um socket numa pasta privada no macOS e no Linux. Nenhuma porta de rede é aberta. O Plainva precisa estar rodando com o vault aberto; caso contrário, o app recebe uma mensagem clara.
Ativar
- Abra Configurações → IA e ative Usar IA neste dispositivo; as linhas dos apps de IA neste computador ficam no cartão Outros programas, mais abaixo na página.
- Ative Deixar apps de IA deste computador lerem este vault.
- Configure o app (veja abaixo). Na primeira conexão, o Plainva pergunta qual app é, qual programa o iniciou e quais pastas ele pode ler. Nada vem marcado: escolha entre as pastas de nível superior do vault ou O vault inteiro e depois Permitir. Recusar afasta o app, e o Plainva não pergunta por ele de novo durante dez minutos. Abaixo das pastas fica Pode sugerir alterações — desativado enquanto você não marcar; o que isso permite está descrito mais abaixo.
O app guarda um segredo no chaveiro do sistema para a próxima vez. As pastas valem por app e por vault: em outro vault, o app pergunta de novo. Ao abrir outro vault, os apps conectados ao anterior são desconectados; eles só leem o novo depois de se conectarem de novo. Enquanto Totalmente local está ligado (veja Assistente de IA), o servidor descansa: nenhum app pode ler o vault, e um app que se conecta é recusado.
Configurar um app
- Claude Code: copie o Comando para o Claude Code das configurações e execute-o em um terminal.
- Claude Desktop: Criar pacote… grava um arquivo
plainva.mcpb; abra-o, e o Claude Desktop instala o Plainva. - Outros apps (JSON): copie a configuração e adicione-a às configurações MCP do app, por exemplo ao
mcp.jsondo Cursor.
O que um app vê
Só as pastas que você permitiu, e só o que suas regras de privacidade deixam ir para um modelo na nuvem que pode acessar a internet — um app é tratado como tal, porque o Plainva não vê o que ele faz com o que lê: notas com cloud: deny ou web: deny, ou numa pasta com uma dessas regras, não existem para um app — nem o texto nem os títulos —, links para elas são retidos, e lugares do diário nunca vão. Uma nota em uma pasta permitida cujo nome não pode ser avaliado como está — ela termina com um espaço ou um ponto, contém dois-pontos ou não está na forma Unicode composta — também fica de fora, e a resposta diz quantas notas ficaram de fora. As pastas do próprio Plainva (.plainva, .agent) e as próprias regras nunca podem ser lidas. Cada caminho de uma solicitação e de uma resposta é verificado duas vezes: na janela do app e na parte nativa do Plainva. Um link de pasta dentro de uma pasta permitida que leva a outro lugar não é seguido, e um banco de dados responde só com valores feitos de notas que o app pode ler: uma contagem ou uma soma sobre links para outras pastas deixa essas notas de fora. Um link no que um app lê só fica se levar a uma nota que o app pode ler; qualquer outro — também um para uma nota que não existe — é retido. Uma busca não encontra uma nota pelo texto de um link retido e, na dúvida, a deixa de fora; uma alteração que tocaria um link retido ou levaria seu marcador para uma nota é recusada.
As configurações listam os apps que você permitiu neste computador com suas pastas neste vault (nenhuma neste vault para um app permitido só em outro lugar) e as últimas solicitações. Remover retira a permissão de um app em todos os vaults. Isso vale na hora — também para um app que esteja conectado naquele momento.
Enquanto o workspace criptografado do vault aberto não estiver aberto neste dispositivo — porque está bloqueado ou porque este dispositivo não tem nenhuma chave para ele —, o Plainva não responde a nenhum app: toda solicitação — também uma lista ou uma busca — é recusada com uma mensagem que diz qual dos dois casos é, uma solicitação em andamento quando você o bloqueia não recebe nada do que encontrou, e um app que se conecta fica sabendo na hora. Desbloqueie o workspace ou configure-o neste dispositivo, e a mesma conexão volta a responder. Uma permissão vale pelo nome da pasta: se você renomear uma pasta permitida, o app deixa de vê-la até você permitir de novo, e uma pasta nova com o nome antigo ficaria visível para ele.
Além das ferramentas, o Plainva oferece cinco de suas habilidades como prompts, no próprio idioma do Plainva, e a referência do formato de arquivo como um recurso (plainva://format): os prompts são daily-orientation, weekly-review, project-status, meeting-prep e task-triage; project-status pede o nome do projeto e meeting-prep a reunião. Um app que aceita prompts os lista entre seus comandos.
Deixar um app sugerir alterações
Ler nunca é uma permissão para escrever. Se um app também pode sugerir alterações é uma resposta à parte: Pode sugerir alterações na pergunta da primeira conexão, ou depois o interruptor … pode sugerir alterações nas configurações — por app e por vault, e desativado até você ativar. Vale a partir da próxima solicitação do app; o Plainva avisa na hora a um app conectado que as ferramentas dele mudaram (um app que usa a revisão mais recente do protocolo só recebe o aviso se pediu para ser avisado) — se ele então as mostra sem se reconectar depende do app.
Um app a que você permitiu recebe mais seis ferramentas, e nenhuma delas muda o vault:
- Uma alteração em uma nota — no texto ou em uma das propriedades — vira uma sugestão na margem da nota, assinada com o nome do app e “(app de IA)”. Ali você aceita ou recusa cada alteração, como em qualquer sugestão (veja Comentários e sugestões).
- Uma nota nova vira um rascunho em A decidir, na aba de IA. Ela existe quando você escolhe Criar ali.
- Renomear, mover e excluir perguntam antes. O Plainva mostra na própria janela o que aconteceria — ao renomear, também as notas cujos links acompanhariam — e o app mostra um aviso de que o Plainva está esperando. Só depois de Permitir no Plainva, e quando o app continuar, o Plainva faz isso do jeito que faz quando você faz à mão; o app só fica sabendo se aconteceu. Para excluir, o Plainva então abre a própria caixa de diálogo de exclusão, e nada desaparece antes de você confirmar ali. A um app que não consegue mostrar esse aviso — ele precisa da revisão 2026-07-28 do protocolo MCP ou mais nova e precisa poder lhe fazer uma pergunta em um formulário —, essas três ferramentas não são oferecidas.
Um endereço da web que um app traz é escrito de modo que nada o abra nem o carregue (https[://]…), como acontece com o assistente. As regras de privacidade da própria nota (plainva.ai) não são definidas por nenhum app, e dentro de um workspace criptografado nada é sugerido, rascunhado ou planejado. A lista de solicitações recentes nas configurações mostra as oito mais novas e marca as que o Plainva perguntou a você (pergunta feita), as que você negou (negada) e as que não passaram (recusada); uma solicitação que passou não leva nenhuma palavra.
Limites
- Só no desktop: celulares não executam esses apps, e nem o iOS nem o Android deixam um app oferecer a outro um canal privado.
- ChatGPT e claude.ai no navegador não o alcançam: eles só se conectam a servidores na internet, e o Plainva não mantém nenhum.
- Um app nunca muda o vault sozinho: o que ele escreve espera como sugestão ou rascunho, e renomear, mover ou excluir precisa do seu sim no Plainva.