FAQ and troubleshooting
Get answers to common questions and troubleshoot agent app and MCP connections.
Does Midmap include AI or agents?
No. Midmap is a local desktop board app. It does not include AI models or agents. You can manage boards yourself, or connect Midmap MCP to an agent app to use agent features.
Do I have to install the Midmap Skill?
No. You can use Midmap manually without the Skill. An MCP connection lets an agent app access your boards; the Midmap Skill provides dedicated instructions such as /midmap to start common tasks from an agent conversation.
What should I do if I can’t connect an agent app?
- In Midmap, open Settings → MCP and make sure the service is enabled and its status is Running.
- Check that the MCP configuration in the agent app matches the app entry you added in Midmap.
- If you changed the port, copy the configuration again and update the old one in the agent app.
- If Midmap reports that the port is in use, choose another port in MCP settings, then copy and update the configuration for the app.
- If the problem continues, check the MCP error details provided by the agent app.
What’s the difference between “Ask” and “Command”?
“Ask” is for discussing or clarifying a question; it does not ask the agent to change the board. “Command” assigns a specific task for the agent to carry out. You can continue to explain either type of request in the agent app.
How can I review changes made by an agent?
Check the operation notification and node change markers in Midmap. Keep the changes if they look right. If they do not, choose Reject to undo this round, then refine the command and try again.
Where is my board data stored?
Board data is stored on your device and is not uploaded to Midmap’s servers. Midmap does not currently offer account sync, cross-device sync, or cloud backup.
Can I recover a board that will not open?
If the current board data cannot be read, Midmap shows a recovery prompt. If a previous version is available, you can restore it and continue using the board. The previous version may not include your latest changes. Read the prompt carefully before choosing.
What happens if I delete an agent app entry?
The app using that entry can no longer connect to Midmap with it. To reconnect, add the app again in Midmap’s MCP settings and replace the old configuration in the agent app with the new one.