Troubleshooting
Start with the Health check page: it finds most problems and says how to fix them.
My AI app doesn't show SolutionMCP's tools
- Restart the app completely. On a Mac, quit it from its menu; closing the window isn't enough.
- Check that the AI apps page says it's set up. If it shows Use this app's copy, click it.
- Some apps need tools turned on for each chat, or in their settings.
A tool is missing
- Check that it's on, on the Tools page, and that its toolset is on.
- Look at Not available on this computer at the bottom of the Tools page: it may be for another system, or need a program you don't have.
- For your own tools, look for a problem message on the Tools page.
Something was blocked
- Open the Activity page and click the call to see why.
- "Blocked" means a rule, the permission mode or the blocked-commands list refused it. Check Permissions.
- "You declined" includes approvals that weren't answered in time.
I'm never asked, the question never comes
- If your AI app can't ask, the SolutionMCP popup appears by the icon. Make sure SolutionMCP is running and With a pop-up on this computer is on under Permissions.
- On Windows, the icon may be hidden behind the ^ arrow by the clock.
A tool can't open a file
- The file must be inside a folder listed under Permissions → Folders the AI can use.
- Some places are always protected, like key and password folders.
- On a Mac, other apps' data needs Full Disk Access.
No icon
- Windows: look behind the ^ arrow next to the clock.
- Linux: GNOME needs the AppIndicator extension. Without a tray, the window opens instead.
An old icon, or SolutionMCP twice in the app menu (Linux)
The AppImage adds its own entry to the app menu. An entry you made yourself for an earlier version stays as it was,
with the icon it had then. Delete that one: right-click it in the menu and choose to remove or hide it, or delete its
file from ~/.local/share/applications. Notifications use the icon of SolutionMCP's own entry.
Updates don't work
SolutionMCP checks for updates at solution-mcp.com, so the computer needs to reach it (a firewall or a proxy may be in the way). An error saying the list of releases "wasn't used" means it wasn't signed with SolutionMCP's release key: the update is refused on purpose, so tell us at support@solution-mcp.com. See Updates.
Paired computers can't reach each other
- Both computers need SolutionMCP running.
- A firewall may block port 7627 on the computer whose tools you use. Allow SolutionMCP, or that port (TCP, and UDP for finding it when its address changes), for your home network.
- Away from home, see Away from home.
Something else
Look at the questions and answers, or describe the problem with your system and version, what you did and what happened. A screenshot helps.