CloudBrowser Docs
  1. Inegrations
CloudBrowser Docs
  • Documentation
    • Introduction
      • What is CloudBrowser?
      • What is Headless browsers?
      • Getting started
      • Playwright
    • Fundamentals
      • Create a Browser Session
      • Use a Browser Profile
      • Manage a Browser Profile
    • Features
      • Stealth Mode
      • Proxies
      • Live View
      • Session Inspector
      • Downloads
      • Uploads
    • User Cases
      • Form Submissions
      • Web Scraping
      • Automated Tests
    • Guides
      • Improving Performance
      • Optimizing Cost
      • Browser Regions
      • Using Profile ID
      • Plans and Pricing
      • Concurrency & Rate Limits
      • Handling Authentication
      • Enerprise Security
    • Inegrations
      • Get Started with Intergrations
      • CloudBrowser MCP Server
      • CloudBrowser MCP Service
  • APIs and SDKs
    • Node.js SDK
    • Profile
      • Get session list
      • Update Instance Fingerprint
    • sessions
      • Create Browser Session
      • Start Session
      • Close Session
    • files
      • Upload File
      • Download File
    • plugin
      • Upload Plugin
      • Get Plugin List
      • Update Environment Fingerprint
  • Changelog
  1. Inegrations

CloudBrowser MCP Server

Enhancing AI Assistants with Web Automation via MCP Protocol

Cloud Browser MCP Server Integration Guide

Overview

The Model Context Protocol (MCP) is an open standard that enables AI assistants (like Claude) to collaborate with external tools through structured communication channels, expanding their capabilities. With MCP, AI can access real-time data, perform web operations, extract structured information, and complete complex tasks involving multiple tools.

This system implements the MCP protocol through cloud-based browser automation services, allowing AI to directly perform web browsing, searching, form filling, button clicking and other behaviors in the conversation context without human intervention.

Additionally, we provide our own Cloud Browser MCP Server implementation solution, supporting rapid integration and expansion of AI's web interaction capabilities.

Core Features

  1. Real-time Data Access

    • Break through training data limitations: Get the latest web information (such as news, prices, weather) to ensure the timeliness of output content.
    • Dynamic queries: Automatically retrieve specified websites and return summaries or key indicators based on user instructions.
  2. Interactive Automation

    • Web operations: Simulate user behavior (such as clicking, inputting, navigating), supporting complex processes (such as login, shopping cart operations).
    • Cross-platform tasks: Switch between different websites as needed to perform tasks such as price comparison and data scraping.
  3. Structured Data Extraction

    • Precise scraping: Extract specific fields (such as product prices, user reviews) from web pages and output them in JSON, tables and other formats.
    • Logical processing: Combine rule engines or custom scripts to filter invalid data and generate analysis results.
  4. Seamless Integration Experience

    • In-dialogue operations: All web interaction results are directly returned to the AI dialogue interface without manual window switching.
    • Visual assistance: Provide screenshots, logs and other debugging information to facilitate verification of operation results.

Typical Application Scenarios

ScenarioFunctional Description
Market ResearchAutomatically search for industry reports, competitive analysis data and generate summaries
Price ComparisonScrape product prices on multiple e-commerce platforms and output optimal purchasing solutions
Form SubmissionFill in and submit online forms (such as registration, appointment) according to user needs
Content MonitoringRegularly check target website updates and push new content or key changes
Data CollectionExtract structured data from public web pages for subsequent analysis or database construction

Technical Advantages

  1. Standardized Protocol Support

    • MCP protocol compatibility: Follow open standards to ensure compatibility with various AI models and tools.
    • Modular design: Flexible integration with browser automation tools such as Puppeteer, supporting custom extensions.
  2. High Performance Execution

    • Cloud deployment: Distributed nodes handle high-concurrency tasks to ensure response speed.
    • Low-latency interaction: Optimize network routing and caching strategies to reduce operation waiting time.
  3. Security and Compliance

    • Proxy integration: Support high-anonymity proxies to reduce the risk of IP blocking.
    • Compliance control: Automatically detect target website robots.txt and terms of use to avoid violations.
    • Data desensitization: Encrypt sensitive information (such as passwords, identity information) during transmission and storage.

CloudBrowser MCP Server Integration Guide

Development Test Environment Setup

Local Operation Method

  1. Install dependencies:
npm install
  1. Build the project:
npm run build

After the build is completed, the index.js file will be generated in the dist/ directory.

  1. Start the debugging server:
npm run inspector

Quick Start Deployment

Method 1: Start through build files

  1. Execute npm install and npm run build to build the project (as described above).
  2. Modify Claude Desktop's configuration file (usually located at ~/.claude/config.json or similar path) and add the following configuration:
{
  "mcpServers": {
    "cloudbrowser": {
      "command": "node",
      "args": ["path/to/mcp-server-cloudbrowser/cloudbrowser/dist/index.js"],
      "env": {
        "API_KEY": "<YOUR_CLOUDBROWSER_API_KEY>"
      },
      "transportType": "stdio"
    }
  }
}

⚠️ Please replace <YOUR_CLOUDBROWSER_API_KEY> with your actual API Key.

  1. Restart the Claude Desktop application, and you can see the available functions under the 🔨 icon in the toolbar.
  2. Start using! For example: navigate pages, take screenshots, click buttons, extract text, etc.

Method 2: Start via NPM (no build required)

Suitable for quick verification or CI/CD processes:

{
  "mcpServers": {
    "cloudbrowser": {
      "command": "cmd",
      "args": [
        "/c", 
        "npx", 
        "-y", 
        "@browsercloud/mcp-server-cloudbrowser"
      ],
      "env": {
        "API_KEY": "<YOUR_CLOUDBROWSER_API_KEY>"
      },
      "transportType": "stdio"
    }
  }
}

Supported Tool Interfaces (CloudBrowser API)

Tool NameDescriptionInput Parameters
cloudbrowser_navigateNavigate to specified URLurl (string)
cloudbrowser_evaluateExecute JavaScript script in browser consolescript (string)
cloudbrowser_get_current_urlGet current page URLNone
cloudbrowser_screenshotScreenshot entire page or specified elementname, selector, width, height
cloudbrowser_clickClick element on pageselector (CSS selector)
cloudbrowser_fillFill input boxselector, value
cloudbrowser_get_textExtract text content from page or specified elementselector (optional)

Resource Access

  1. Console Logs
    View browser console output to locate script errors.

  2. Screenshot Resources

    • Access method: screenshot://
    • Type: PNG image
    • Purpose: Record operation process and verify interaction accuracy

Precautions

  1. Comply with Website Policies

    • Check the target website's robots.txt file and terms of service before automation.
    • Avoid high-frequency requests that may cause excessive server load.
  2. Data Usage Compliance

    • Only extract publicly accessible data, prohibit scraping user private information.
    • Data storage must comply with privacy regulations such as GDPR, CCPA.
  3. Error Handling Mechanism

    • Implement exponential backoff strategies to deal with anti-scraping protections.
    • Record failure logs and support retries to ensure task integrity.

Troubleshooting

If you encounter issues with your configuration:

  1. Verify your API key and project ID are correct
  2. Ensure the port you're trying to use isn't already in use
  3. Check that your JSON syntax is valid when using the --cookies flag
  4. Reload your MCP client after making configuration changes

Summary

Through the MCP protocol and cloud-based browser automation services, the capabilities of AI assistants have expanded from text generation to dynamic data interaction and task execution. This enhancement not only improves automation efficiency but also provides a reliable technical foundation for cross-platform collaboration. Under the premise of following compliance principles, developers and enterprises can fully utilize this capability to build smarter and more efficient solutions.

At the same time, we provide a complete Cloud Browser MCP Server implementation solution to help you quickly deploy and integrate MCP services, expanding AI's web interaction capabilities.

Previous
Get Started with Intergrations
Next
CloudBrowser MCP Service
Built with