# 在 OpenCode 中通过 MCP 使用网页搜索与抓取 (/zh/quickstarts/opencode)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 435 · updated: 2026-07-30 -->
Related: [Node.js](/zh/quickstarts/nodejs.md), [Next.js](/zh/quickstarts/nextjs.md), [Express](/zh/quickstarts/express.md), [NestJS](/zh/quickstarts/nestjs.md), [Fastify](/zh/quickstarts/fastify.md), [Hono](/zh/quickstarts/hono.md)

通过 MCP 为 [OpenCode](https://opencode.ai) 添加 Firecrawl 的搜索、抓取、爬取和浏览器工具。

<div id="quick-setup">
  ## 快速开始 [#快速开始]
</div>

<div id="1-get-your-api-key">
  ### 1. 获取 API 密钥 [#1-获取-api-密钥]
</div>

在 [firecrawl.dev/app](https://www.firecrawl.dev/app) 注册，然后复制您的 API 密钥。

<div id="2-add-firecrawl-to-opencode">
  ### 2. 将 Firecrawl 添加到 OpenCode [#2-将-firecrawl-添加到-opencode]
</div>

OpenCode 会从 `~/.config/opencode/config.json` (全局) 或项目中的 `./opencode.json` 读取配置。添加：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "firecrawl": {
      "type": "local",
      "command": ["npx", "-y", "firecrawl-mcp"],
      "environment": {
        "FIRECRAWL_API_KEY": "fc-YOUR-API-KEY"
      }
    }
  }
}
```

将 `fc-YOUR-API-KEY` 替换为你的 Firecrawl API 密钥。

<div id="3-start-opencode">
  ### 3. 启动 OpenCode [#3-启动-opencode]
</div>

```bash
opencode
```

OpenCode 会在启动时加载 MCP 服务器。请确认已接入 Firecrawl：

```
/mcp
```

<div id="quick-demo">
  ## 快速演示 [#快速演示]
</div>

```
进行网页搜索，查找 "Bun 2.0 changelog" 并总结排名靠前的结果。
```

```
抓取 https://docs.firecrawl.dev/introduction and list the code examples.
```

```
爬取 https://example.com/blog and save each post as markdown.
```

<div id="remote-hosted-url-no-nodejs-required">
  ## Remote Hosted URL (无需 Node.js) [#remote-hosted-url-无需-nodejs]
</div>

```json
{
  "mcp": {
    "firecrawl": {
      "type": "remote",
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}
```

此配置使用免密钥 Firecrawl 工具集。若需连接账户或进行无人值守设置，请参阅[托管 MCP 连接模式](/zh/developer-guides/mcp-setup-guides/oauth)；请将 API 密钥存储在 Authorization 请求头或安全密钥存储中，切勿放入 URL。

<div id="troubleshooting">
  ## 故障排查 [#故障排查]
</div>

* **服务器未连接** — 运行 `opencode doctor` 检查 MCP 加载错误。
* **`npx` 权限被拒绝** — 安装 Node.js 18+，并确保 shell 已正确识别该安装 (`which npx`) 。