跳到正文
Cline

Cline 集成

借助 CrawlForge MCP 让 Cline 获得实时网页访问能力。在 Cline 的 MCP 设置文件中加一个 mcpServers 条目即可添加服务器,autoApprove 则可为你信任的工具跳过逐次确认。

前置条件

Cline

必需

Node.js 18+
从 nodejs.org 安装

必需

API 密钥
从控制台获取

免费

1
获取 CrawlForge API 密钥
下面的配置通过 npx 启动服务器,因此无需任何全局安装——只需要一个密钥。

在终端登录:CLI 会打开一个浏览器页面,你在其中批准一个新密钥,随后密钥会保存到 ~/.crawlforge/config.json。

Bash
npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

或者从控制台复制一个密钥,在下一步粘贴到配置中。

2
配置 Cline
选择你偏好的配置方式:

A方式 A:MCP Servers 面板

在 Cline 面板中点击 MCP Servers 图标,打开 Configure 选项卡并点击 Configure MCP Servers。这会打开 cline_mcp_settings.json;在 mcpServers 下添加服务器:

cline_mcp_settings.jsonJson
{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

disabled: false 会启用服务器。把工具名加入 autoApprove(例如 "scrape"),即可在无需确认的情况下运行它们。

B方式 B:Cline CLI

Cline CLI 读取结构相同的 ~/.cline/mcp.json,cline mcp 会打开一个向导用于添加、编辑或禁用服务器。

3
设置你的 API 密钥
将 cf_live_your_api_key_here 替换为你的密钥,或让配置生成器为你填入。

限制工具列表(可选)

CrawlForge 提供 31 个工具。在同一个 env 块中设置 CRAWLFORGE_TOOL_GROUPS,即可只加载你需要的分组,例如 basic,search:

Json
"env": {
  "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
  "CRAWLFORGE_TOOL_GROUPS": "basic,search"
}

分组:basic、search、crawl、extract、batch、research、tracking、llmstxt、stealth、templates、scrape、agent。

4
测试集成
打开 Cline,确认服务器已连接。
  • 打开 Cline — 点击活动栏中的 Cline 图标
  • 检查服务器 — MCP Servers 面板会以绿点显示 crawlforge 及其工具列表
  • 测试提示 — 试试下面的某个示例;除非工具在 autoApprove 中,否则 Cline 会在每次调用前询问

示例提示

"搜索最新的 AI 资讯"

"从 example.com 提取所有链接"

"爬取文档站点并对其进行总结"

"从这个电商站点提取产品价格"

全部 31 个工具及其参数请参阅完整的 API 参考。

故障排查

服务器无法连接?

  1. 检查 cline_mcp_settings.json 是否为有效 JSON
  2. 确认已安装 Node.js 18+:node --version
  3. 在 MCP Servers 面板中点击 Retry Connection 并查看错误
  4. 完全重启 VS Code

身份验证错误?

  1. 检查 API 密钥是否以 cf_live_ 开头
  2. 运行 crawlforge login 保存一个新密钥
  3. 从控制台生成新的 API 密钥

工具没有被使用?

  1. 确认设置文件中该服务器未被 disabled
  2. 在 MCP Servers 面板中启用该服务器的开关
  3. Cline 询问时批准工具调用,或把该工具加入 autoApprove

集成成功了吗?

探索所有可用工具,或按照 Cline 的分步教程操作。