CLI command
fleetdeck bridge
Expose a private native driver to FleetDeck.
Usage
bash
fleetdeck bridge DEVICE adb SERIAL
fleetdeck bridge DEVICE wda URL
fleetdeck bridge DEVICE mcp CONFIG.jsonExample
fleetdeck bridge device_123 adb R58M123456AArguments
| Argument | Required | Description |
|---|---|---|
DEVICE | required | FleetDeck device ID. Must identify the same physical phone as the native driver. |
DRIVER | required | adb, wda or mcp. |
SERIAL / URL / CONFIG.json | required | For adb: exact USB serial. For wda: private WDA base URL. For mcp: local JSON configuration path. |
Supply FLEETDECK_API_KEY through the environment. See environment configuration.
MCP configuration fields
presetstringrequiredSelects the native tool allowlist and device binding behavior.
Allowed:
"ios-mcp""mobile-mcp""iphone-mcp"endpointstringoptionalPrivate native MCP HTTP endpoint. Provide endpoint or command; endpoint takes precedence when both are set.
commandstringoptionalNative MCP executable for stdio transport, used when endpoint is absent.
argsstring[]optionalArguments for the stdio executable. Defaults to an empty array.
devicestringoptionalUpstream native device identity to bind calls to, when required by the selected preset. Distinct from the FleetDeck DEVICE positional argument.
Behavior
- adb targets one explicit serial. wda targets one explicit WebDriverAgent base URL. mcp loads a JSON config such as {"preset":"ios-mcp","endpoint":"http://127.0.0.1:8090/mcp"}.
- The bridge advertises only its real capabilities, polls with a stable process identity, executes each claimed action at most once and never replays after completion-report failure.
- Keep native MCP services private. Some upstream tools can access bridge-host files and are not part of the FleetDeck allowlist.
Output and exit
Long-running process. Errors are reported to stderr; SIGINT/SIGTERM closes the driver.
See all exit codes and error recovery.
