Skip to main content
The MCP server supports both physical and simulated Android devices, as well as simulated iOS devices (macOS only).

​
Requirements

  • ADB installed and in PATH
  • A physical Android device with USB debugging enabled, or an Android emulator

​
Connect a Device

Option 1: Physical Device
  1. Enable USB debugging in Developer Options on your device
  2. Connect your device via USB
Option 2: Android Emulator
  1. Open Android Studio
  2. Go to Device Manager and launch an emulator

​
Verify Connection

adb devices

​
Custom ADB Server

If using a custom ADB server (e.g., Docker, WSL):
export ADB_SERVER_SOCKET="tcp:localhost:5037"
You may need to restart your IDE after setting custom ADB socket.

​
Troubleshooting

  1. Android: Run adb devices to verify device connection
  2. iOS: Run xcrun simctl list devices booted to check running simulators
  3. Ensure USB debugging is enabled (Android)
  4. Try restarting ADB: adb kill-server && adb start-server
  1. Ensure device screen is unlocked
  2. For Android, verify screencap permission
  3. For iOS, ensure simulator is fully booted
  1. Verify the MCP server is running: minitap-mcp --server
  2. Check the server URL in your IDE configuration
  3. Ensure the port is not blocked by firewall
  4. Try restarting the MCP server
  1. Verify your MINITAP_API_KEY is set correctly
  2. Get a new API key at platform.minitap.ai/api-keys
  3. Check that the API key has not expired
  1. Restart your IDE after configuration changes
  2. Verify the MCP server URL is correct
  3. Check the MCP server logs for errors
  4. Ensure the server is accessible at the configured URL