Skip to main content
BRICKS Foundation implements the Chrome DevTools Protocol (CDP), providing a frontend-like debugging experience for your applications. Connect via Chrome DevTools to inspect the DOM, debug JavaScript, profile performance, and view console logs. You can also connect CDP-supported tools like Puppeteer or Playwright to write automation scripts or connect via AI agents. An MCP endpoint is also provided for AI agent integration.

​
Enable DevTools on the device

1

Open advanced settings

On the device, open Settings and navigate to the advanced settings section.
2

Enable Chrome DevTools

Toggle Chrome DevTools on. The device starts a DevTools server on the local network on port 19851. If that port is already in use, it increments to the next available port.

​
Discover devices

Use the BRICKS CLI to scan your local network for devices with DevTools enabled: 
bricks devtools scan
Devices must have Enable LAN Discovery turned on in advanced settings for network scanning to work. This is enabled by default.

​
DevTools endpoints

Once you find a device, use bricks devtools open to view all available endpoints: 
bricks devtools open <device-address>
This displays connection URLs for:
EndpointDescription
Web UIOpen this URL in your browser to access the DevTools landing page
CDPChrome DevTools Protocol endpoint for direct connection
MCPModel Context Protocol endpoint for AI agent integration
MCP SSEMCP endpoint using Server-Sent Events transport

​
Open the DevTools page

Open the Web UI URL in your browser to access the DevTools landing page. From there you can inspect the running application, view available debug targets, and connect to the device.

​
Connect with Chrome

You can also connect directly through Chrome:
  1. Open chrome://inspect in Chrome
  2. Your device appears in the list of remote targets
  3. Click inspect to open a DevTools window connected to the running application

​
Connect AI agents via MCP

The device’s MCP endpoint allows AI agents to interact with the running application. Use mcporter to bridge the device’s MCP endpoint as a local STDIO server: 
npx mcporter --url http://<device-ip>:19851/mcp --header "Authorization: Bearer <passcode>"
This lets AI coding agents (Claude Code, Codex, etc.) connect to and interact with the device through the Model Context Protocol.

​
What you can do with DevTools

With Chrome DevTools connected, you can:
  • Elements — Inspect and modify the rendered DOM
  • Console — View logs, warnings, and errors from the application
  • Sources — Debug JavaScript with breakpoints
  • Network — Monitor network requests made by generators
  • Performance — Profile rendering and script execution
  • Memory — Analyze memory usage and detect leaks

​
Next steps

Remote debugging

Debug devices remotely via BRICKS Controller without local network access.

Debug panel

Use the on-device overlay to inspect runtime state.