MCP 服务器——用 AI 智能体驱动 Clearcote

将 Claude Desktop、Cursor 或 Cline 接入 Clearcote MCP 服务器，让模型通过 20 个工具驱动同一个共享浏览器。身份画像（persona）只需通过环境变量设置一次，工具接口因此保持简洁——智能体只管执行任务，底层的身份始终保持一致。

配置 MCP 客户端

把 Clearcote 加入客户端的 MCP 配置（下例为 Claude Desktop；Cursor/Cline 的格式相同）：

json

{
  "mcpServers": {
    "clearcote": {
      "command": "npx",
      "args": ["-y", "clearcote-mcp"],
      "env": {
        "CLEARCOTE_FINGERPRINT": "acct-1",
        "CLEARCOTE_PLATFORM": "windows",
        "CLEARCOTE_PROXY": "http://host:8080",
        "CLEARCOTE_GEOIP": "1"
      }
    }
  }
}

两种方式运行的都是同一个 Python 服务器，因此需要 Python 3.10+。请先用 pip 安装——之后 npx 启动器会复用这份安装——或者在配置中改用 "command": "clearcote-mcp"。mcp 的版本锁定让服务器停留在它构建时所对应的 MCP 库版本上（clearcote-mcp 0.1.0 无法在 mcp 2.x 上运行）：

bash

pip install -U clearcote clearcote-mcp "mcp[cli]<2"

没有许可证密钥时，服务器运行开源版构建。在 env 中加入 CLEARCOTE_LICENSE_KEY（或运行一次 clearcote login），即可运行最新的授权版构建——GitHub 免费版或 Pro 均可。免费密钥需要 clearcote SDK 0.30.0 或更高版本，上面的命令会一并安装。

工具

共有二十个工具，驱动同一个共享浏览器：

工具	作用
`navigate`	在当前标签页打开一个 URL（返回最终 URL 和页面标题）
`read_page`	以 text/markdown 形式读取当前的实时页面
`page_elements`	列出最多 200 个可见的链接、按钮和输入框，能取到 CSS 选择器的会一并给出
`click`	点击一个 DOM 元素
`fill_field`	向 input / textarea 输入内容
`press_key`	按下一个按键（Enter、Tab 等）
`wait_for`	等待 selector 匹配的元素出现
`screenshot_page`	整页 PNG 截图，保存到沙盒目录（返回文件路径）
`list_tabs / new_tab / close_tab`	列出 / 新建 / 关闭标签页
`save_profile / load_profile`	把 Cookie 和存储数据保存到沙盒中的一个命名文件，之后再从中恢复 Cookie——登录一次，复用会话
`get_egress_info`	公网 IP 和当前生效的身份画像
`get_cdp_endpoint`	返回 CDP URL，供直接使用 CDP 的客户端连接

……此外还有 get_page_html、evaluate_js、current_page、get_cookies（只读）和 save_page_pdf（仅限无头模式）。智能体读取页面、做出判断、执行操作——全部通过同一个身份画像一致的 Clearcote 实例完成。

通过环境变量设置身份画像

身份画像的基础项通过 CLEARCOTE_* 环境变量设置，模型完全不必考虑身份问题。如需使用其余的指纹选项，请直接调用 SDK。

bash

CLEARCOTE_FINGERPRINT=acct-1          # seed -> stable identity
CLEARCOTE_PLATFORM=windows            # windows | linux | macos | android
CLEARCOTE_BRAND=Edge                  # Chrome (default) | Edge | Opera | Vivaldi
CLEARCOTE_ACCEPT_LANGUAGE=en-US
CLEARCOTE_TIMEZONE=America/New_York
CLEARCOTE_PROXY=http://user:pass@host:8080
CLEARCOTE_GEOIP=1                     # timezone + language + WebRTC follow the proxy exit
CLEARCOTE_HEADLESS=0                  # show the window (default: headless)
CLEARCOTE_LICENSE_KEY=cc_lic_...      # optional -> the latest licensed build

带认证的代理需要授权版构建；开源版构建无法把代理凭据传给浏览器。

防护措施

如果工具调用的 URL 指向 localhost、私有网络或云元数据端点，该调用会被拒绝。这只是防止误操作的保护，并不是沙盒：通过 evaluate_js 运行的脚本、页面自行跳转的链接，仍然可以访问这些地址。设置 CLEARCOTE_ALLOW_PRIVATE_EGRESS=1 即可放行（例如用于测试本地开发服务器）。
截图、PDF 和保存的会话会写入 <temp>/clearcote-mcp（可通过 CLEARCOTE_MCP_WRITE_DIR 更改位置）。
每次工具调用在 90 秒后超时（CLEARCOTE_MCP_TOOL_TIMEOUT）。
MCP 客户端一启动服务器，浏览器就会随之启动。使用 GitHub 免费版密钥时，这会立即占用你唯一的浏览器席位；设置 CLEARCOTE_MCP_PREWARM=0 可改为在首次工具调用时才启动浏览器。

MCP 服务器直接启动浏览器，不带 Playwright 的自动化标志，因此 navigator.webdriver 保持为 false，引擎也会把常见的 CDP 副作用隔离在页面之外。自动化有两种方式：运行在浏览器外部的 LLM（即本 MCP 服务器），或者在浏览器进程内运行的内置 AI 智能体。

需要原始端点而不是 MCP？请参阅部署与 Docker。