1# Browser Use Cloud and Platform Notes
2 
3Use this reference when the task is about Browser Use cloud, not just local browser control.
4 
5## Authentication
6 
7Browser Use cloud commands require API auth.
8 
9Core command:
10 
11```bash
12browser-use cloud login <api-key>
13```
14 
15Alternative:
16- use `BROWSER_USE_API_KEY`
17 
18## Cloud browser flow
19 
20```bash
21browser-use cloud connect
22browser-use state
23browser-use close
24```
25 
26## REST passthrough
27 
28Examples:
29 
30```bash
31browser-use cloud v2 GET /browsers
32browser-use cloud v2 POST /tasks '{"task":"Search for AI news","url":"https://google.com"}'
33browser-use cloud v2 poll <task-id>
34```
35 
36Use this for:
37- tasks
38- cloud browsers
39- profiles
40- workspaces
41- files
42- billing/platform objects exposed by Browser Use API
43 
44## Tunnels
45 
46Use tunnels when a cloud browser must reach localhost.
47 
48```bash
49browser-use tunnel 3000
50browser-use tunnel list
51browser-use tunnel stop 3000
52browser-use tunnel stop --all
53```
54 
55Typical flow:
56 
571. start local dev server
582. create tunnel
593. connect cloud browser
604. open tunneled URL
61 
62## Profiles
63 
64The CLI can sync or manage profiles for cloud usage.
65Commands include:
66 
67```bash
68browser-use profile list
69browser-use profile sync --all
70browser-use profile auth --apikey <key>
71```
72 
73## MCP mode
74 
75The CLI also supports stdio MCP mode:
76 
77```bash
78browser-use --mcp
79```
80 
81Use this when another agent/client should drive Browser Use as an MCP server.
82