在 GitHub Copilot 中使用 MCP 网页搜索与抓取

​

Copilot CLI

​

1. 添加 Firecrawl

copilot mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth",
      "tools": ["*"]
    }
  }
}

​

2. 登录并验证

copilot

​

改用 API 密钥

copilot mcp add --transport http \
  --header "Authorization: Bearer $FIRECRAWL_API_KEY" \
  firecrawl https://mcp.firecrawl.dev/v2/mcp

​

VS Code

​

1. 添加 Firecrawl

{
  "servers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

​

2. 登录并验证

​

改用 API 密钥

{
  "inputs": [
    {
      "type": "promptString",
      "id": "firecrawl-api-key",
      "description": "Firecrawl API key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${input:firecrawl-api-key}"
      }
    }
  }
}

​

Copilot 编程智能体

​

前提条件

• 付费的 GitHub Copilot 套餐，且已为该仓库启用编程智能体。
• 仓库管理员权限，用于编辑 MCP 设置和 Agents 密钥。
• 一个 Firecrawl API 密钥。

​

设置步骤

1. 在你的仓库中，依次打开 Settings > Secrets and variables > Agents。
2. 点击 New repository secret，将其命名为 COPILOT_MCP_FIRECRAWL_API_KEY，粘贴你的 Firecrawl API 密钥并保存。Copilot 只会将名称以 COPILOT_MCP_ 开头的 Agents 密钥传递给 MCP 服务器。
3. 依次打开 Settings > Copilot > MCP servers。
4. 将以下配置粘贴到 MCP configuration 中，然后点击 Save MCP configuration：

{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer $COPILOT_MCP_FIRECRAWL_API_KEY"
      },
      "tools": ["firecrawl_search", "firecrawl_scrape", "firecrawl_map"]
    }
  }
}

5. 将一个议题分配给 Copilot。待其拉取请求出现后，选择 View session，在日志中展开 Start MCP Servers 步骤，确认其中列出了 Firecrawl 工具。

​

试一试

进行网页搜索，查找最新的 Next.js App Router 版本发布说明，并汇总各信息来源的内容。

抓取 https://docs.firecrawl.dev，并列出其一级章节。

​

故障排除

• 工具未显示： 确认只配置了一个 firecrawl 服务器，然后重启 Copilot CLI；或者在 VS Code 中运行 MCP: List Servers 并重启该服务器。
• 需要重新登录或返回 401： 重启服务器并完成浏览器登录。在完成身份验证之前，直接向 OAuth 服务器发送请求会返回 401，这属于正常现象。
• 使用 API 密钥的连接返回 401： 确认 URL 为 https://mcp.firecrawl.dev/v2/mcp (而非 /v2/mcp-oauth) ，且标头为 Authorization: Bearer <FIRECRAWL_API_KEY>。
• 组织策略： 如果你的 GitHub 组织限制在 Copilot 中使用 MCP 服务器，则需由管理员允许 Firecrawl 后才能连接。
• 编程智能体：会话日志中缺少 Firecrawl 工具： 确认 secret 名称与 COPILOT_MCP_FIRECRAWL_API_KEY 完全一致，且它是 Agents 密钥，而非 Actions secret。