Common issues
Updated July 7, 2026
MCP tools missing, connection failures, and plugin setup problems.
MCP tools do not show up
- Confirm AIOS Desktop is running.
- Restart your MCP client (Cursor, Claude, etc.).
- Re-copy the MCP connection settings from the desktop app.
- Check that the plugin is configured and shows a healthy status.
Plugin connection fails
- Verify hostnames, API keys, and ports in the plugin settings.
- For self hosted services, confirm the URL is reachable from your machine.
- Use the plugin's API test tool when available.
Help article looks empty
If a page looks empty right after an update, wait a minute and refresh. If it still does not load, use the contact options on singla.ai.