Troubleshooting
This section helps identify and resolve common issues encountered while using the MCP servers in Mobitru.
Most problems are related to configuration, session lifecycle, or network limitations between the MCP client (e.g., Copilot, Cursor, EliteA) and the Mobitru backend.
| Symptom | Likely Cause | Fix |
| 401 Unauthorized | Bad/missing API key | Update DEVICE_FARM_API_KEY and restart server |
| TLS/handshake errors on stage | Self-signed certs | Use NODE_TLS_REJECT_UNAUTHORIZED=0 only on staging |
| mobile_open_url fails | No active Appium/device context | Run mobile_use_device → mobile_appium_init first |
| Install fails for iOS | Expired provisioning profile | Install with resign (or with injection if needed) |
| Cannot run Safari | Playwright limitation | Use browserType: webkit |
| browser_tab_new no-op | Different session | Tabs only within same session |