FAQ
Frequently asked questions
The short answers. The detail is in How it works and Limits and compliance.
Data and privacy
Does Shield send my data to RAGbase?
No. Shield runs on your computer. It sends nothing to RAGbase and sends no usage statistics.
Is this anonymisation?
No. It is local, reversible pseudonymisation. Names become codes, but facts, dates and amounts stay readable. You keep the table that puts the real names back.
Does the GDPR still apply?
Yes. For you, the holder of the code table, pseudonymised data remain personal data (GDPR art. 4(5) and recital 26). Shield is a protection measure. It does not release you from your duties: see the compliance sheet.
Where are the real names stored?
In an encrypted vault, one per dossier, on your computer: the "RAGbase Shield" folder in your Library on a Mac (~/Library/Application Support/RAGbase Shield), or in your personal folder on Windows (C:\Users\<name>\RAGbase Shield). The key is in the Mac keychain, or in the Windows Credential Manager.
I lost my computer. What happens?
The vaults are encrypted: without the key, they cannot be read. Encrypt the disk too (FileVault on a Mac, BitLocker on Windows). Without the vault, nobody can put the real names back into an old answer.
Using the AI
What exactly does the AI see?
The masked text (PERSONNE_A, SOCIETE_A, ADRESSE_1...), the facts, dates, amounts, courts and articles of law. It sees the dossier under a code (DOSSIER_1) and the masked file names. It sees neither the real names, nor the vault, nor the key.
Can I attach a file to the chat?
No. A file attached to the conversation reaches Anthropic, the provider of Claude, before Shield can act. The same goes for a folder chosen as the work folder of the conversation (the folder control near the message field): Claude reads its real content. Only a folder chosen in the Shield window is protected. So do not add the client folder to the conversation: write "Protect a folder with Shield" and choose it in the Shield window.
I pasted text with a real name into the chat. What now?
Shield cannot recall text already sent. You can delete the conversation in the AI app; how long it is kept then depends on the provider's terms. From now on, write the person's code, not the name.
Names and codes
How do I talk about a person in the chat?
Write their code, for example "Draft a formal notice to PERSONNE_B", or their role, such as "the landlord": Claude reads the documents with the codes and finds the right one. Do not type the real name: text typed into the conversation is not masked. No screen shows the codes next to the real names, and the real name comes back in the final document, on your computer.
Does Shield find every name?
No. Detection is never complete: a rare, foreign or misspelt name can slip through. Shield finds numbers with a check digit, emails, phone numbers, addresses, case references, names after a title or a common first name, and companies with a legal form. Read the sensitive passages again: a name on its own can be missed.
A name must not be masked (a court expert, an authority). What do I do?
A detected name is always replaced by a code: there is no setting to keep it in clear. Tell Claude who it is, with the code, for example "PERSONNE_C is the court expert": the real name comes back in the final document, on your computer. Lawyers' toque numbers are masked too.
What if the AI invents a code that does not exist?
When you restore, Shield lists the codes it does not know, and the miscopied codes it leaves as they are (for example "personne_a" in lower case). Check them before you use the text.
Why does a restored name not have the exact spelling of the document?
Shield puts back the value stored in the dossier, in the first spelling seen. "M. Mercadier" can come back as "M. Thibault Mercadier". Always read the restored document again.
Files
Claude shows a warning when I add Shield. Is this normal?
Yes. When you add Shield, Claude shows two warnings. The first, in the "Add marketplace" window: "Only add marketplaces you trust…". The second, after "Add": "This plugin includes local MCP servers". Then, under "Connectors & tools", Claude shows "Can send data to other services" and "Can run code without asking". Claude shows the first for anything that does not come from its own catalogue, and the others for anything that holds a program. "Local MCP server" is the name Claude gives to a program that runs on your computer. The "service" Claude speaks of is Shield itself, on your computer. Shield is free and open source: its code is public on GitHub. Shield sends nothing to RAGbase, and your original documents and the real names stay on your computer.
I added Shield, but Claude does not use it. What do I do?
Open a new conversation and write "Protect a folder with Shield". If your Claude app has a "Cowork" tab, use that tab: the plain chat does not start Shield. If nothing changes, check these points. On Windows, Cowork needs the virtualization of the PC. If Cowork shows a message about virtualization or the "Virtual Machine Platform", do what the message asks, or ask your IT team to do it. Then restart the PC. The add is finished only after "Continue". If you closed the window "This plugin includes local MCP servers" without clicking "Continue", click the button of the site again. You were perhaps in the Code tab of the app when you clicked the button: leave the Code tab, then click the button of the site again. The Claude app was perhaps signed out when you clicked: sign in, then click the button of the site again. Your Claude account is perhaps a free one: Shield needs a paid Claude plan.
My firm uses Claude Team or Enterprise: can I add Shield?
Yes, if the administrator of the Claude account allows it: the administrator can block this. The Claude app then shows "Adding marketplaces is blocked by your organization's policy. Contact your administrator." Ask the administrator to allow Shield.
I have a Mac and a PC: what do I do?
Add Shield on each of them, each time with the button of the computer you are on: "Add Shield to Claude on Mac" on the Mac, "Add Shield to Claude on Windows" on the PC. Your Claude account keeps what you add: on each computer you will see both lines, "RAGbase Shield (Mac)" and "RAGbase Shield (Windows)". This is normal: on each computer, only the right one runs.
Why does Shield refuse my folder?
One dossier is one client. Shield refuses a folder with more than 2,000 files or more than 2 GB. Choose the folder of the client, not the folder that holds all your clients.
Why is the first reading long?
Shield reads every document of the folder on your computer and replaces the names before Claude sees anything: a name found in one document is then hidden in all of them. For a large folder, this first reading takes a few minutes. During this reading, Claude tells you how far it has got.
Are scanned PDFs supported?
No: there is no OCR. Shield tells you a PDF has no text and does not read it. Read: PDF with text, DOCX, XLSX, TXT, MD, EML, HTML. Written: DOCX and MD.
Security
Our firm uses a data loss prevention (DLP) tool. Will it work?
Shield codes are short and do not have the shape of the data a DLP looks for: IBAN_1 does not look like an IBAN. A masked text should therefore not trigger those rules. Run a test with your tool.
How do I report a security problem?
Privately: through GitHub private vulnerability reporting on the RAGbase Shield repository, or to contact@ragbase.ai. Do not open a public ticket. Send fictional data only, never real client data.
Price and offline use
How much does Shield cost?
Nothing. Shield is free and open source (Apache-2.0). You pay only for your AI subscription.
Does Shield work without the Internet?
Shield does: it makes no network call. The AI does not: it runs at the provider. For an AI that runs on your own machines, see the "Going further" block at the bottom of the page.