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
- 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.
- Zet op de kaart AI-apps op deze computer de schakelaar AI-apps op deze computer deze vault laten lezen aan.
- 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
- Claude Code: kopieer de Opdracht voor Claude Code uit de instellingen en voer die uit in een terminal.
- Claude Desktop: Pakket maken… schrijft een bestand
plainva.mcpb; open het, en Claude Desktop installeert Plainva. - Andere apps (JSON): kopieer de configuratie en voeg die toe aan de MCP-instellingen van de app, bijvoorbeeld aan de
mcp.jsonvan Cursor.
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 wijziging in een notitie — in de tekst of in een van de eigenschappen — wordt een voorstel in de marge van de notitie, ondertekend met de naam van de app en “(AI-app)”. Daar neem je elke wijziging apart over of wijs je haar af, zoals bij elk voorstel (zie Opmerkingen en voorstellen).
- Een nieuwe notitie wordt een concept onder Te beslissen in het AI-tabblad. Ze bestaat zodra je daar Aanmaken kiest.
- Hernoemen, verplaatsen en verwijderen vragen eerst. Plainva laat in het eigen venster zien wat er zou gebeuren — bij hernoemen ook de notities waarvan de links zouden volgen —, en de app toont een melding dat Plainva wacht. Pas na Toestaan in Plainva, en zodra de app verdergaat, doet Plainva het zoals wanneer je het met de hand doet; de app hoort alleen of het is gebeurd. Bij verwijderen opent Plainva dan het eigen verwijdervenster, en er verdwijnt niets voordat je daar bevestigt. Een app die zo’n melding niet kan tonen — ze heeft MCP-protocolrevisie 2026-07-28 of nieuwer nodig en moet je een vraag in een formulier kunnen stellen — krijgt deze drie hulpmiddelen niet aangeboden.
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
- Alleen desktop: telefoons draaien zulke apps niet, en iOS noch Android laat een app een andere een privékanaal aanbieden.
- ChatGPT en claude.ai in de browser kunnen er niet bij: ze verbinden alleen met servers op internet, en Plainva draait er geen.
- Een app wijzigt de vault nooit uit zichzelf: wat ze schrijft, wacht als voorstel of concept, en hernoemen, verplaatsen of verwijderen heeft jouw ja in Plainva nodig.