AI-apps koppelen (bèta)

Laatst bijgewerkt: 2026-11-20

AI-apps op je computer — Claude Code, Claude Desktop, Cursor, VS Code en andere die het Model Context Protocol (MCP) spreken — kunnen je vault via Plainva lezen: erin zoeken, notities en hun secties lezen, structuren, backlinks, databases, taken en recente notities, en een notitie in Plainva openen. Uit zichzelf wijzigen ze niets: een app die je dat toestaat mag wijzigingen voorstellen, en die wachten tot je beslist (zie hieronder). Dit hoort bij de experimentele AI-functies en werkt alleen op de desktop.

De omgekeerde richting — de assistent van Plainva die hulpmiddelen gebruikt van servers die je zelf koppelt — staat beschreven onder Externe hulpmiddelen in AI-assistent.

Een derde weg — Plainva start een AI-agent van een andere maker in de map van de vault, met zijn sessie in het AI-tabblad — staat beschreven in Externe agents.

Zo werkt het

Plainva levert naast de app een klein hulpprogramma mee, plainva-mcp. Een AI-app start het, en het hulpprogramma verbindt via een privékanaal van deze computer met het draaiende Plainva — een named pipe op Windows, een socket in een privémap op macOS en Linux. Er wordt nooit een netwerkpoort geopend. Plainva moet draaien met de vault open; anders krijgt de app een duidelijke melding.

Inschakelen

  1. Open Instellingen → AI en zet AI op dit apparaat gebruiken aan; de regels voor AI-apps op deze computer staan verderop in de kaart Andere programma’s.
  2. Zet op de kaart AI-apps op deze computer de schakelaar AI-apps op deze computer deze vault laten lezen aan.
  3. Stel de app in (zie hieronder). Bij de eerste verbinding vraagt Plainva welke app het is, welk programma haar startte en welke mappen ze mag lezen. Er is niets aangevinkt: kies uit de mappen op het hoogste niveau van de vault of De hele vault, dan Toestaan. Weigeren wijst de app af, en Plainva vraagt tien minuten lang niet opnieuw naar haar. Onder de mappen staat Mag wijzigingen voorstellen — uit zolang je het niet aanvinkt; wat het toestaat, staat verderop.

De app bewaart voor de volgende keer een geheim in de sleutelhanger van het systeem. Mappen gelden per app en per vault: in een andere vault vraagt de app opnieuw. Open je een andere vault, dan worden de apps die met de vorige verbonden waren losgekoppeld; de nieuwe lezen ze pas als ze opnieuw verbinden. Zolang Volledig lokaal aan staat (zie AI-assistent), rust de server: geen enkele app kan de vault lezen, en een app die verbinding maakt, wordt geweigerd.

Een app instellen

Wat een app ziet

Alleen de mappen die je hebt toegestaan, en alleen wat je privacyregels naar een cloudmodel laten gaan dat het internet op kan — een app geldt als zo’n model, omdat Plainva niet ziet wat ze met het gelezene doet: notities met cloud: deny of web: deny, of in een map met een van die regels, bestaan niet voor een app — noch hun tekst noch hun titels —, links ernaar worden achtergehouden, en plaatsen uit het journaal gaan nooit mee. Ook een notitie in een toegestane map waarvan de naam niet te beoordelen is zoals hij er staat — hij eindigt op een spatie of een punt, bevat een dubbele punt of staat niet in samengestelde Unicode-vorm — blijft erbuiten, en het antwoord zegt hoeveel notities zijn weggelaten. Plainva’s eigen mappen (.plainva, .agent) en de regels zelf zijn nooit leesbaar. Elk pad in een verzoek en in een antwoord wordt twee keer gecontroleerd: in het app-venster en in het native deel van Plainva. Een maplink in een toegestane map die ergens anders heen leidt, wordt niet gevolgd, en een database antwoordt alleen met waarden uit notities die de app mag lezen: een aantal of som over links naar andere mappen laat die notities weg. Een link in wat een app leest, blijft alleen staan als hij naar een notitie leidt die de app mag lezen; elke andere – ook een naar een notitie die niet bestaat – wordt achtergehouden. Een zoekopdracht vindt een notitie niet via de tekst van een achtergehouden link en laat een notitie bij twijfel weg; een wijziging die een achtergehouden link zou raken of de plaatsaanduiding ervan in een notitie zou zetten, wordt geweigerd.

De instellingen tonen de apps die je op deze computer hebt toegestaan met hun mappen in deze vault (geen in deze vault bij een app die alleen elders is toegestaan) en de laatste verzoeken. Verwijderen trekt de toestemming van een app in elke vault in. Dat geldt meteen — ook voor een app die op dat moment verbonden is.

Zolang de versleutelde workspace van de geopende vault op dit apparaat niet open is — hij is vergrendeld, of dit apparaat heeft er geen sleutel voor —, antwoordt Plainva geen enkele app: elk verzoek — ook een lijst of een zoekopdracht — wordt geweigerd met een melding die zegt welk van de twee het is, een verzoek dat loopt wanneer je vergrendelt krijgt niets van wat het vond, en een app die verbinding maakt hoort het meteen. Ontgrendel de workspace of richt hem op dit apparaat in, en dezelfde verbinding antwoordt weer. Een toestemming gaat op de naam van een map: hernoem je een toegestane map, dan ziet de app hem niet meer tot je hem opnieuw toestaat, en een nieuwe map met de oude naam zou voor de app zichtbaar zijn.

Naast de tools biedt Plainva vijf van zijn vaardigheden aan als prompts, in Plainva’s eigen taal, en de naslag van het bestandsformaat als resource (plainva://format): de prompts zijn daily-orientation, weekly-review, project-status, meeting-prep en task-triage; project-status vraagt om de naam van het project en meeting-prep om de vergadering. Een app die prompts ondersteunt, toont ze tussen zijn opdrachten.

Een app wijzigingen laten voorstellen

Lezen is nooit een toestemming om te schrijven. Of een app ook wijzigingen mag voorstellen, is een apart antwoord: Mag wijzigingen voorstellen in de vraag bij de eerste verbinding, of later de schakelaar … mag wijzigingen voorstellen in de instellingen — per app en per vault, en uit totdat je hem aanzet. Hij geldt vanaf het volgende verzoek van de app; Plainva laat een verbonden app meteen weten dat haar hulpmiddelen zijn veranderd (een app die de nieuwste protocolrevisie gebruikt, hoort het alleen als ze erom heeft gevraagd) — of de app ze dan zonder opnieuw verbinden toont, ligt aan de app.

Een app die je het hebt toegestaan krijgt zes extra hulpmiddelen, en geen daarvan wijzigt de vault:

Een webadres dat een app meebrengt, wordt zo geschreven dat niets het opent of laadt (https[://]…), net als bij de assistent. De eigen privacyregels van een notitie (plainva.ai) stelt geen app in, en in een versleutelde workspace wordt niets voorgesteld, opgesteld of gepland. De lijst met recente verzoeken in de instellingen toont de acht nieuwste en markeert de verzoeken waarover Plainva het jou heeft gevraagd (vraag gesteld), de verzoeken die je hebt afgewezen (afgewezen) en de verzoeken die niet zijn doorgelaten (geweigerd); een verzoek dat is doorgelaten, draagt geen woord.

Grenzen