Browser tích hợp của Cursor hữu ích khi bạn kiểm tra ứng dụng local. Nó có thể mở trang, click, nhập dữ liệu và chụp screenshot. Nhưng với web thật, đó vẫn là một webview bị cô lập: session không bền, fingerprint không được quản lý và không có proxy identity nhất quán.
TL;DR: kết nối Cursor với Clawbrowser qua CDP (Chrome DevTools Protocol). Agent dùng Chromium thật với profile bền, fingerprint được quản lý và proxy routing. Cài runtime, chạy profile, rồi đưa endpoint local cho Cursor.
Vì sao browser tích hợp của Cursor chưa đủ
Cursor có browser tool dựa trên sandboxed webview chạy như MCP server extension. Với localhost, nó ổn: navigate, click, type, scroll, screenshot, console output và network traffic.
Khi đi ra ngoài môi trường local, các giới hạn xuất hiện:
| Giới hạn | Điều xảy ra |
|---|---|
| Sandboxed webview | Không phải Chromium instance thật. Website có thể thấy API thiếu và window properties bất thường. |
| Không có session persistence | Cookies và localStorage gắn với workspace, không đáng tin giữa các lần chạy. |
| Không quản lý fingerprint | Canvas hash, WebGL renderer và navigator properties gần như cố định qua mỗi request. |
| Không có proxy support | Toàn bộ traffic đi qua IP mặc định của máy. IP datacenter dễ bị đánh dấu. |
| Vấn đề ổn định | Cursor 2.3.18+ từng có regression với click, scroll và tìm element. |
Nếu agent cần login, scrape sau Cloudflare hoặc chạy workflow nhiều bước trên production site, webview tích hợp không phải nền tảng phù hợp.
CDP đem lại gì
CDP (Chrome DevTools Protocol) là giao diện chuẩn để điều khiển browser Chromium bằng code. Playwright dùng connectOverCDP, Puppeteer dùng puppeteer.connect, còn CDP client mở WebSocket tới debugging port.
Khi kết nối Cursor với browser bên ngoài qua CDP, bạn có:
- Browser thật với rendering engine đầy đủ, extension và API chuẩn
- Session bền với cookies và trạng thái login qua nhiều lần chạy agent
- Điều khiển trang đầy đủ bằng cùng protocol mà Playwright và Puppeteer dùng
- Anti-detection khi browser giữ fingerprint và proxy nhất quán trong một identity
Kết nối chỉ là một WebSocket URL chuẩn. Bất kỳ tool nào nói CDP đều có thể gắn vào browser có CDP endpoint. Clawbrowser mở endpoint cho từng profile.
Kết nối Cursor với Clawbrowser: từng bước
Điều kiện cần
- macOS (Apple Silicon), Linux (x64 hoặc arm64) hoặc Windows
- Đã cài Cursor
- Clawbrowser API key từ
app.clawbrowser.ai
Bước 1: cài Clawbrowser
Tải và giải nén bootstrapper clawctl:
# macOS (Apple Silicon)
archive="clawctl-macos-arm64.tar.gz"
curl -fL --retry 3 -o "$archive" \
"https://github.com/clawbrowser/clawctl/releases/latest/download/${archive}"
tar -xzf "$archive"Với Linux, dùng clawctl-linux-amd64.tar.gz hoặc clawctl-linux-arm64.tar.gz. Không cần Docker hay sudo.
Đặt API key:
./clawctl config set api-keyBước 2: chạy browser profile
Khởi động Clawbrowser với profile có tên. Mỗi profile có fingerprint, cookie storage và proxy tùy chọn riêng:
# Start a profile and open the verification page
clawctl start --profile cursor-dev --url clawbrowser://verify/ --json
# Get the CDP endpoint for this profile
clawctl endpoint --profile cursor-dev --jsonLệnh endpoint trả về URL như http://127.0.0.1:9222. Đây là CDP endpoint mà Cursor agent sẽ dùng.
Bước 3: kết nối từ Cursor qua MCP
Cách đơn giản nhất là dùng MCP server tích hợp của Clawbrowser. Nó đưa navigation, screenshots, clicks, tab management và profile startup thành MCP tools để Cursor gọi trực tiếp. Server tự quản lý CDP bên trong.
Chạy installer để ghi cấu hình MCP local:
clawctl install --agent all --jsonCursor sẽ đọc MCP server từ cấu hình đó.
Cách khác: Microsoft Playwright MCP
Nếu bạn muốn dùng Microsoft Playwright MCP server chính thức, trỏ nó tới CDP endpoint của Clawbrowser trong Cursor Settings > MCP > Add Server:
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": [Cả hai cách đều cho Cursor quyền điều khiển browser ở mức cao. MCP server của Clawbrowser thêm quản lý profile và fingerprint.
Bước 4: kiểm tra kết nối
Yêu cầu Cursor agent mở một trang test:
Navigate to https://browserleaks.com/canvas and take a screenshot. Tell me what canvas fingerprint hash you see.
Nếu kết nối đúng, bạn sẽ thấy canvas fingerprint thật từ profile Clawbrowser, không phải hash chung của sandboxed webview.
Kết nối CDP trực tiếp từ code
Nếu Cursor agent viết và chạy script thay vì dùng MCP tools, kết nối trực tiếp bằng Playwright hoặc Puppeteer:
Playwright (Python)
from playwright.async_api import async_playwright
async def browse_with_clawbrowser():
async with async_playwright() as p:
# Connect to Clawbrowser's CDP endpointPlaywright (Node.js)
const { chromium } = require('playwright');
const browser = await chromium.connectOverCDP('http://127.0.0.1:9222');
const page = browser.contexts()[0].pages()[0];
Puppeteer
const puppeteer = require('puppeteer');
const browser = await puppeteer.connect({
browserURL: 'http://127.0.0.1:9222'
});Ba framework đều kết nối tới cùng CDP endpoint. Clawbrowser xử lý identity layer bên dưới: Canvas, WebGL, AudioContext, font, độ phân giải, timezone, navigator properties và proxy routing nhất quán trong profile.
Vì sao anti-detection quan trọng với Cursor agent
Khi Cursor agent dùng browser chuẩn để duyệt web, hệ thống anti-bot kiểm tra browser identity qua nhiều bề mặt:
| Tín hiệu | Nội dung kiểm tra | Standard Chrome | Clawbrowser |
|---|---|---|---|
| Canvas hash | GPU rendering fingerprint | Static, matches known automation profiles | Unique per profile, consistent with reported GPU |
| WebGL renderer | Graphics card identifier | Exposes real hardware | Matches the profile's simulated hardware |
| Navigator properties | Browser version, platform, language | Generic Chromium values | Consistent with profile's OS and locale |
| Timezone | System timezone vs IP geo | Mismatches with proxy location | Auto-aligned with proxy geography |
| CDP detection | Runtime.enable traces |
Detectable via leaked CDP artifacts | Engine-level patches suppress CDP signals |
Chromium chuẩn điều khiển qua CDP để lại dấu vết mà anti-bot đọc được rất nhanh. Clawbrowser vá ở tầng engine, không dựa vào JavaScript overrides dễ bị phát hiện qua descriptors hoặc prototype chains.
Đó là khác biệt giữa Cursor nối tới chrome --remote-debugging-port=9222, dễ bị chặn, và Cursor nối tới Clawbrowser, nơi identity của browser nhất quán hơn.
Quản lý nhiều profile
Mỗi profile Clawbrowser được cô lập. Bạn có thể chạy nhiều profile cùng lúc cho nhiều tài khoản hoặc dự án:
# Create three profiles with different locations
clawctl create --profile account-a --location sweden --json
clawctl create --profile account-b --location germany --json
clawctl create --profile account-c --location japan --json
Mỗi profile có fingerprint riêng, proxy IP riêng và storage riêng. Nền tảng nhìn thấy các user độc lập từ nhiều máy và quốc gia khác nhau.
Cursor agent có thể đổi profile bằng cách kết nối tới CDP endpoint khác, hoặc quản lý nhiều profile song song từ một script.
Browser tích hợp Cursor vs CDP vs Clawbrowser
| Cursor built-in | Chrome via CDP | Clawbrowser via CDP | |
|---|---|---|---|
| Browser engine | Sandboxed webview | Real Chromium | Real Chromium (patched) |
| Session persistence | Workspace-scoped | Manual profile dirs | Named profiles with auto-persistence |
| Fingerprint management | None | None | 20+ surfaces managed per profile |
| Proxy support | None | Manual flag | Profile-bound, geo-aligned |
| Anti-bot survival | Blocked instantly | Blocked within minutes | Passes Cloudflare, DataDome, PerimeterX |
| Multi-account | Not possible | Separate --user-data-dir |
Built-in profile isolation |
| Setup complexity | Zero (built in) | Moderate | Three commands |
Dùng browser tích hợp để kiểm tra app trên localhost. Dùng Clawbrowser qua CDP cho mọi luồng chạm tới web thật.
FAQ
Cách này có chạy với agent mode của Cursor không?
Có. Agent mode của Cursor dùng được mọi MCP server, kể cả server kết nối browser bên ngoài qua CDP. Action sẽ chạy trong Clawbrowser thay vì sandboxed webview.
Tôi có cần cài Playwright hoặc Puppeteer không?
Chỉ cần nếu agent viết và chạy automation script. Với workflow MCP, server tự giữ kết nối CDP bên trong.
Có thể dùng lại login session giữa các project Cursor không?
Có. Profile Clawbrowser giữ cookies, localStorage và IndexedDB. Đăng nhập một lần rồi dùng lại profile đó ở workspace khác.
Nếu browser tool của Cursor gây nhầm với browser bên ngoài thì sao?
Bạn có thể tắt browser tích hợp trong Settings > Features > Browser. Hai browser cũng có thể cùng tồn tại vì chúng độc lập.
Clawbrowser có miễn phí không?
Có. Clawbrowser miễn phí, open source và MIT-licensed. Không tính theo seat, không giới hạn usage, không subscription runtime. Bạn cần API key từ app.clawbrowser.ai để xác thực cài đặt.
Bắt đầu
Ba lệnh để kết nối Cursor agent với browser thật:
# Install Clawbrowser
clawctl install --json
# Set your API key
clawctl config set api-keyTrỏ MCP server hoặc Playwright script tới endpoint trả về. Cursor agent sẽ duyệt web bằng browser có fingerprint được quản lý, session bền và proxy routing.
Đọc thêm về CDP tại Trình duyệt CDP cho AI agent. Về fingerprinting, xem Browser fingerprinting và 20 tín hiệu anti-bot.
Đọc tiếp
Bài viết liên quan
CDP và MCP: khi nào dùng cái nào để điều khiển trình duyệt bằng AI
CDP điều khiển trình duyệt. MCP kết nối AI. Tìm hiểu khi nào dùng Chrome DevTools Protocol và khi nào dùng Model Context Protocol cho automation trình duyệt bằng AI agent.
Đọc bài viết →
Clawbrowser vs Donut Browser: hoàn toàn miễn phí hay freemium
Clawbrowser vs Donut Browser: cả hai đều Chromium, open source, CDP + MCP. So sánh tính năng, bảng giá, ví dụ code và khi nào nên chọn từng anti-detect browser.
Đọc bài viết →