← All help topics

Folders the AI can use

SolutionMCP's file tools only work inside the folders you allow. Everything else on your computer is out of reach. By default that's your home folder, which holds your documents, downloads and desktop.

Change the folders

On the Permissions page, under Folders the AI can use:

  • Type a folder, like ~/Documents or D:\Shared, and click Add folder. ~ means your home folder.
  • Click Remove next to a folder to take it out.
  • Turn on Read-only to let the file tools read but never change or delete anything.

With no folders at all, the file tools can't open anything.

Always protected

Some places stay blocked even inside your folders, because they hold keys, passwords and private data:

  • SSH, GPG and cloud keys and credentials, like the .ssh and .aws folders and .env files
  • browser passwords and cookies
  • on a Mac: your keychains, Mail and Messages data
  • on Windows: the Credential Manager
  • SolutionMCP's own settings: the AI can't change its own permissions, and can't read your secrets

Good to know

  • Shortcuts and links can't escape: a path is checked where it really leads, not where it seems to.
  • Deleting with the file tools moves things to the Trash or Recycle Bin, so you can get them back.
  • The terminal tool (shell_run) isn't limited to these folders, which is why it asks first in Balanced mode.
  • On a Mac, some folders also need Full Disk Access.