Claude Code

Claude Code 集成

借助 CrawlForge MCP 让 Claude Code 获得实时网页访问能力。一条 claude mcp add 命令即可为所有项目注册服务器，或在仓库中放一个 .mcp.json 与团队共享。

前置条件

Claude Code

从 code.claude.com 安装

必需

Node.js 18+

从 nodejs.org 安装

必需

API 密钥

从控制台获取

免费

获取 CrawlForge API 密钥

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

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

Bash

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

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

提示： CLI 指南介绍了 crawlforge login 以及其他身份验证方式。

在 Claude Code 中注册服务器

选择你偏好的配置方式：

A方式 A：一条命令，用户作用域

运行一次，CrawlForge 即可在所有项目中使用：

Bash

claude mcp add crawlforge -s user -e CRAWLFORGE_API_KEY=cf_live_your_api_key_here -- npx -y crawlforge-mcp-server@latest mcp

-s user 会把条目写入 ~/.claude.json；去掉它则服务器仅限于当前项目。crawlforge init --client claude-code 会为你写入同样的条目。

B方式 B：项目级 .mcp.json

在仓库根目录创建 .mcp.json，与团队共享服务器：

.mcp.jsonJson

{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

不要提交真实密钥： Claude Code 会从每位开发者的 shell 展开 ${CRAWLFORGE_API_KEY}，并在项目服务器首次加载时要求每个人批准。

设置你的 API 密钥

将 cf_live_your_api_key_here 替换为你的密钥，或让配置生成器为你填入。

用你的密钥生成此配置： MCP 配置生成器会填入你的密钥，并输出适用于 Claude Code 的确切命令和 JSON。

限制工具列表（可选）

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。

安全： 切勿将你的 API 密钥提交到版本控制。请使用环境变量或配置文件。

测试集成

启动一个新的 Claude Code 会话，确认服务器已连接。

Bash

claude mcp list

检查状态 — claude mcp list 会显示每个服务器及其是否已连接；会话内的 /mcp 显示同样的信息
必要时重启 — 新服务器会被新会话识别，重新加载当前会话则不会
测试提示 — 试试下面的某个示例；Claude 会自行选择 CrawlForge 工具

示例提示

"搜索最新的 AI 资讯"

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

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

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

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

故障排查

`claude mcp list` 中没有该服务器？

再次运行 claude mcp add 命令，并检查它写入了哪个作用域
确认已安装 Node.js 18+：node --version
.mcp.json 中的项目服务器首次使用时需要交互式批准
启动新会话——重新加载当前会话是不够的

身份验证错误？

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

Claude 改用了内置的 fetch？

在 CLAUDE.md 中加一行，要求 Claude 在访问网页时优先使用 CrawlForge 工具
在 .claude/settings.json 中允许 mcp__crawlforge__*，避免权限提示
需要覆盖它的选择时，在提示中点名工具（"用 scrape 来…"）

仍有问题？ 请联系 simon@crawlforge.dev，并附上你的 Claude Code 版本、Node.js 版本以及 claude mcp list 的输出。

集成成功了吗？

探索所有可用工具，或按照 Claude Code 的分步教程操作。

查看全部工具 Claude Code 入门指南

{ "mcpServers": { "crawlforge": { "command": "npx", "args": [ "-y", "crawlforge-mcp-server@latest", "mcp" ], "env": { "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here" } } } }