跳到正文
CrawlForge MCP
Zed

Zed 集成

借助 CrawlForge MCP 让 Zed 的 Agent 面板获得实时网页访问能力。Zed 把 MCP 服务器称为 context servers；在 settings.json 中加一个 context_servers 块即可添加 CrawlForge。

前置条件

Zed
从 zed.dev 下载

必需

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
配置 Zed
选择你偏好的配置方式：

A方式 A：编辑 settings.json

使用 zed: open settings file（或 Cmd+, / Ctrl+,）打开设置，并添加一个 context_servers 块：

~/.config/zed/settings.jsonJson
{
  "context_servers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

在 macOS 和 Linux 上，Zed 读取 ~/.config/zed/settings.json；项目中的 .zed/settings.json 会将服务器限定在该仓库内。

B方式 B：设置界面

进入 Settings → AI → MCP Servers，点击 Add Server → Add Local Server，输入同样的 command、args 和 env。Zed 会为你把条目写入 settings.json。

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
测试集成
打开 Agent 面板，确认服务器正在运行。
  • 打开 Agent 面板 — 点击状态栏中的 Agent 图标
  • 检查服务器 — 服务器启动后，Settings → AI → MCP Servers 会以绿色状态显示 crawlforge
  • 测试提示 — 试试下面的某个示例；智能体会自行选择 CrawlForge 工具

示例提示

"搜索最新的 AI 资讯"

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

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

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

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

故障排查

服务器无法加载？

  1. 检查 settings.json 是否为有效 JSON
  2. 确认已安装 Node.js 18+：node --version
  3. 在 ~/.config/zed/logs/Zed.log 中查找 context_servers 错误
  4. 完全重启 Zed

身份验证错误？

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

Agent 面板中没有提供这些工具？

  1. 在 Settings → AI → MCP Servers 中为你的智能体配置文件启用该服务器的工具
  2. 发送提示前确认服务器显示为运行中
  3. 更改设置后开启新的线程

集成成功了吗？

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

查看全部工具Zed AI 教程