FleetDeckDocs

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.json
Example
fleetdeck bridge device_123 adb R58M123456A

Arguments

ArgumentRequiredDescription
DEVICErequiredFleetDeck device ID. Must identify the same physical phone as the native driver.
DRIVERrequiredadb, wda or mcp.
SERIAL / URL / CONFIG.jsonrequiredFor 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

presetstringrequired

Selects the native tool allowlist and device binding behavior.

Allowed:"ios-mcp""mobile-mcp""iphone-mcp"
endpointstringoptional

Private native MCP HTTP endpoint. Provide endpoint or command; endpoint takes precedence when both are set.

commandstringoptional

Native MCP executable for stdio transport, used when endpoint is absent.

argsstring[]optional

Arguments for the stdio executable. Defaults to an empty array.

devicestringoptional

Upstream 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.