# CloudBrowser [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/CloudBrowser-AI/cloudbrowser-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cloudbrowser

## Description
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.

## Tools
Capabilities this server exposes over MCP:

- **browser_workspace** — Show your active browsers and saved sessions in a workspace beside the conversation. Does not allocate or connect a browser. Optionally show a connected browser and its current screenshot. Use the sessionId and address from the selected browser to continue work.
- **resume_saved_session** — Resume an existing saved session owned by the connected account. Reuses an active browser with the label, otherwise opens one metered browser with a 180-second idle timeout, restoring cookies and storage, not tabs. Only call after the user requests resume. Never retry an ambiguous allocation or change requestId to retry. Close the returned browser when finished.
- **open_browser** — Open one remote browser in the cloud with the connected CloudBrowser account. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Browsers open without stealth fingerprints.
- **close_browser** — Close a specific browser
- **get_browsers** — Get list of active browsers
- **start_remote_desktop** — Start remote desktop access to a browser
- **stop_remote_desktop** — Stop remote desktop access to a browser
- **get_saved_sessions** — Get list of saved sessions
- **remove_saved_session** — Delete a saved session
- **connect_to_browser** — Connect to CloudBrowser browser for direct control
- **navigate_to_url** — Navigate the connected browser to a URL that the user asked for. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Stop at logins, MFA and CAPTCHAs and hand control to the user; this tool does not solve CAPTCHAs.
- **get_page_content** — Get the HTML content of the current page to answer the user's request about it. Use it only for websites and accounts that the user owns or is authorized to use, and follow their terms. Not for crawling or bulk data extraction from third-party websites.
- **click_element** — Click on a page element
- **type_text** — Type text into an element
- **get_elements** — Get information about elements matching a selector
- **take_screenshot** — Take screenshot of the current page
- **disconnect_browser** — Disconnect this control session from a browser. The browser keeps running; use close_browser to stop it.
- **get_connected_browsers** — List the browsers that this caller has connected for direct control

## Claude Desktop Quick Installation
No generated config for this server: it installs through its own setup steps.

The project's own setup steps (from https://github.com/CloudBrowser-AI/cloudbrowser-mcp), copied verbatim. Run them in order; they are not an mcpServers config.

1. Add to Claude Code:

```sh
claude mcp add --transport http cloudbrowser https://mcp.cloudbrowser.ai
```

2. Add to Codex:

```sh
codex mcp add cloudbrowser --url https://mcp.cloudbrowser.ai
```

3. Sign in:

```sh
codex mcp login cloudbrowser
```

4. Add to VS Code:

```sh
code --add-mcp '{"name":"cloudbrowser","type":"http","url":"https://mcp.cloudbrowser.ai"}'
```

5. Add to Gemini CLI:

```sh
gemini mcp add --transport http cloudbrowser https://mcp.cloudbrowser.ai
```

## Documentation

## What CloudBrowser MCP server does

CloudBrowser exposes cloud-hosted Chrome through MCP so an AI client can operate a browser on the user’s behalf. Agents can open browsers, connect to them, visit requested URLs, inspect page content and elements, click controls, enter text, run scripts, and capture screenshots. Browser instances belong to the connected CloudBrowser account and follow its usage plan.

The service also supports saved browser sessions. A saved session can be listed, removed, or resumed later, restoring cookies and storage. Resuming does not restore open tabs. Remote desktop access lets a user watch a browser or take control while it is running.

## How it works

The hosted MCP endpoint is `https://mcp.cloudbrowser.ai` and uses Streamable HTTP. A compatible client authenticates through OAuth 2.1 with PKCE and dynamic client registration. The user signs in to CloudBrowser and approves access; an API token can also be supplied in the client’s secret settings using the `Authorization` header.

A typical workflow is to inspect the workspace or active browsers, open or select a browser, connect to it, and then perform page operations. Disconnecting ends the control connection while leaving the browser running; closing the browser stops it. Resuming a saved session reuses an active browser when available, or opens a metered browser with a 180-second idle timeout.

## Setup and configuration

Add `https://mcp.cloudbrowser.ai` as a custom MCP connector or HTTP server in the client. The documented setup paths cover Claude Desktop and claude.ai, Claude Code, Codex CLI, Cursor, VS Code, and Gemini CLI. ChatGPT can use the endpoint as a custom connector in developer mode. OAuth sign-in is required, and a CloudBrowser account is needed.

No API key needs to be copied during the normal OAuth flow. If using a CloudBrowser API token instead, keep it in the client’s protected secret configuration rather than placing it in prompts. The account’s CloudBrowser plan governs browser usage.

## Tools and capabilities

- Manage browser instances with `open_browser`, `close_browser`, `get_browsers`, and `get_connected_browsers`.
- Connect to or disconnect from a browser without confusing control-session state with browser lifetime.
- Navigate pages, retrieve HTML content, inspect matching elements, click, type, evaluate scripts, and take screenshots.
- List, resume, and remove saved sessions.
- Start and stop remote desktop access.
- Display workspace information, including an optional connected-browser screenshot.
- Detect CAPTCHA pages and expose them for user handling.

## Limitations and notes

Use browser actions only with websites and accounts the user owns or is authorized to use, and follow those sites’ terms. Page-content retrieval is intended for answering questions about the current page, not crawling or bulk extraction from third-party sites.

CloudBrowser browsers open without stealth fingerprints. Login prompts, MFA, verification walls, and CAPTCHAs remain with the user; the navigation flow stops rather than solving them. A resumed session restores cookies and storage but not tabs. Close metered browsers when finished, and do not retry an ambiguous browser allocation by changing its request ID.

_Full upstream README: https://allmcps.com/mcp/cloudbrowser/readme_