Help
The SolutionMCP manual: every feature, step by step. It's the same text as Help in the app.
Getting started
- Welcome to SolutionMCPWhat SolutionMCP does for your AI apps, and how the pieces fit together.
- Install SolutionMCPDownload and install the app on a Mac, Windows or Linux.
- First-run setupEverything starts off: choose how careful SolutionMCP is, then your tools.
- The icon and the windowThe menu bar or tray icon, its popup, and the pages of the window.
- Set up your AI appsAdd SolutionMCP to Claude, Cursor, VS Code and other AI apps in one click.
- Try it outThings to ask your AI app, and what you'll see.
- UpdatesInstall and Relaunch, What's new, and updating from a terminal.
- Free, the trial and licensesWhat Free includes, the 14-day trial, and using a license on a computer.
- Removing SolutionMCPTake SolutionMCP out of your AI apps and off your computer.
The app, page by page
- The Overview pageThe numbers that matter, anything worth a look, and recent activity.
- The Tools pageTurn tools on and off, and choose when each one may run.
- Many tools: compact modeKeep the AI fast when you have hundreds of tools.
- Permission modesTrusted, Balanced, Strict or Read-only: how careful SolutionMCP is.
- ApprovalsWhen SolutionMCP asks before a tool runs, where the question appears, and what each answer does.
- Controlling other appsLet the AI read and use other apps' windows in the background, one program at a time.
- RulesAlways run, always ask or block specific tools, whatever the mode.
- Folders the AI can useWhere file tools may go, and what's always protected.
- Full Disk Access (Mac)Let tools reach Mail, Messages and other private places on a Mac.
- The Activity pageEvery tool call, what it did, and how it was decided.
- SecretsKeep API keys and passwords for your tools safe.
- Health checkCheck that everything is set up correctly.
- Use your other computers' toolsPair your computers, so the AI on one can use another's tools.
- Away from homeReach a paired computer when its address changes or you're elsewhere.
- Reachable from anywhereA permanent address for this computer, for Claude on the web and paired computers away from home.
- The Account pageYour plan, its computers, relay use this month, activity and your details.
- The background serviceShare this computer from startup, without the app or anyone signed in.
- Start at login and other settingsLight and dark, start at login, updates and the About page.
Built-in tools
- The built-in toolsFiles, the terminal, the web, memory and the other tools that come with SolutionMCP.
- Tools for your systemMail, Notes and Calendar on a Mac, PowerShell and Outlook on Windows, and more.
- Windows Subsystem for LinuxWork inside your WSL Linux distros from any AI app.
Making your own tools
- Tools and packs explainedWhat a tool and a pack are, and the three ways to make them.
- Your first toolMake a working tool in a few minutes with the tool editor, step by step.
- The tool editorEvery part of the tool editor, section by section.
- ParametersWhat the AI fills in, and the types you can choose.
- Programs, scripts and web requestsWhat a tool can run, and how values stay safe.
- Versions for each systemOne tool with a different version for Mac, Windows and Linux.
- What a tool can changeOnly looks, makes changes, or can delete: how tools decide to ask.
- Change and delete tools and packsEdit a tool, delete it, or delete a whole pack.
- Writing packs by handThe pack file format, for writing tools in a text editor.
- Templates and quotingFill in values with {{ }}, and how quoting keeps tools safe.
- RecipesTools that run other tools in a row.
- Shared code and commands run elsewhereShare helpers between a pack's scripts, and check commands sent elsewhere.
- Secrets in your toolsUse API keys in tools without writing them down.
- What a tool returnsText, data, pictures and files, and shaping the result.
- Prompts and resourcesReady-made instructions and documents for your AI apps.
- Let the AI make toolsAsk your AI app to make a tool for you.
- Ready-made packsPacks for Home Assistant, Ollama, GitHub, web search and more.
More
- The command lineEverything from a terminal with the solution-mcp program.
- The web dashboardThe same settings as a page in your browser.
- Apps that connect by URLChatGPT, claude.ai and other apps that connect over the web.
- Connecting other MCP serversRun other MCP servers behind SolutionMCP.
- The settings fileWhere SolutionMCP keeps its settings, and what's in the file.
- ProfilesDifferent settings for different AI apps.
- Privacy and securityWhat leaves your computer, what protects you, and what can't.