简介:本文拆解接入搜索 MCP 前必须确认的三个门槛(认证方式、传输协议、限额与稳定性),给出 Claude Code 与 Cursor 的完整配置步骤与 JSON 示例,并对比官方托管型、云厂商封装型、开源自建型三类搜索 MCP 服务的适用场景,附常见连接故障排查思路,帮你选到最合适的联网搜索方案。
MCP(Model Context Protocol,模型上下文协议)在大模型与工具融合的路径中已成为主流技术范式,它相当于大模型与具体工具之间的”转接头”,把工具调用逻辑标准化。在 MCP 出现之前,模型要调用外部工具,必须为每个工具单独开发插件,而插件是捆绑在特定平台上的——A 平台写的插件在 B 平台用不了。MCP 之后,同一个 Search Server 可以同时被 Claude Code、Cursor 以及其他支持 MCP 的客户端复用。
Claude Code 和 Cursor 本身原生支持 MCP,所以接搜索能力时,走 MCP 通常比逐个对接 REST API 更快。但”能不能接”和”接得好不好用”是两件事,评估一个搜索服务的 MCP 接入,重点看三点:
1. 认证要求。 是否支持匿名体验、是否需要账号 OAuth 授权、是否必须填 API Key,以及不同认证方式对应的调用限额差异。多数搜索服务商的官方托管 Server 都要求 API Key,开源自建方案(如基于 SearXNG 的社区 Server)才可以做到完全免 Key。
2. 传输方式与配置形态。 主流是 stdio(本地进程,客户端拉起命令)和 SSE / streamable HTTP(远程 URL)。本地 stdio 适合跑在你自己机器上的服务,远程 SSE 适合云厂商托管的 Server。配置形态直接决定了配置文件怎么写。
3. 限额与稳定性。 免费额度是按次、按天还是按月计算,超限后是报错还是降级;远程 SSE 服务的连接稳定性也要提前验证。
顺带一提,搜索只是 MCP 工具的一类。百度智能云已经把多项 AI 开放能力封装成 MCP Server,比如图像识别(https://aip.baidubce.com/mcp/image_recognition/sse)提供车辆检测、菜品识别、通用物体和场景识别等能力,图像增强(https://aip.baidubce.com/mcp/image_enhance/sse)提供图像去雾、超分、文档矫正等。如果你的 Agent 除了联网搜索还需要模型推理能力,可以在百度智能云词元所上做模型发现与选型,对比不同模型的能力和调用成本,再用统一 API 接入,避免为每个模型单独适配一套调用逻辑。
Claude Code 提供命令行方式,最省事:
# 本地 stdio 型(以 npx 拉起的搜索 Server 为例)claude mcp add search-web -- npx -y @modelcontextprotocol/server-search# 远程 SSE / HTTP 型claude mcp add --transport sse search-web https://your-search-endpoint/sse
也可以直接编辑项目根目录的 .mcp.json,把配置纳入版本管理,团队共享:
{"mcpServers": {"search-web": {"type": "sse","url": "https://your-search-endpoint/sse","headers": { "Authorization": "Bearer <YOUR_API_KEY>" }}}}
接入后用 claude mcp list 确认连接状态。作用域要注意区分:local 只对当前项目生效,project 写入 .mcp.json 可共享,user 全局生效。把带密钥的配置提交到仓库是常见事故,建议密钥走环境变量注入。
Cursor 的入口是 Settings → MCP → Add new MCP Server ,最新版本需要通过配置 JSON 来添加 MCP Server。典型配置如下:
{"mcpServers": {"AISearch": {"url": "第一步中配置的百度AI搜索MCP-SSE组件URL"}}}
如果用的是需要鉴权的云端组件,密钥通常放在 URL 或请求头里。以百度智能云 AppBuilder 的 AI 搜索 MCP-SSE 组件为例,api_key 的格式为 Bearer+<AppBuilder API Key>,注意保留中间的”+”,形如 Bearer+bce-v3/ALTAK-xuZRMCVTC9######。
配好之后,在 Cursor 新版的 chat(旧版的 composer)中使用”搜索”相关关键词即可触发搜索组件调用。
一个高频坑: Cursor 对 MCP SSE 组件存在连接不稳定的情况,遇到无法连接时,可以尝试点击「Enable」按钮后刷新组件状态。如果反复失败,按顺序排查:URL 是否带全 https:// 与路径、密钥是否漏了 Bearer+ 前缀、本机代理是否拦截了 SSE 长连接、服务端额度是否已耗尽。
| 类型 | 代表方案 | 认证 | 传输 | 适合谁 |
|---|---|---|---|---|
| 搜索厂商官方托管 | Tavily、Brave Search、Exa、Perplexity Sonar 等 | API Key 必填,多有免费额度 | stdio + 远程 HTTP | 想开箱即用、看重结果质量的个人与小团队 |
| 云厂商封装 | 百度智能云千帆 / AI 搜索 MCP-SSE 组件 | API Key(Bearer+...) |
SSE | 国内网络环境、需要与云上其他 AI 能力同栈 |
| 开源自建 | SearXNG + 社区 MCP Server | 可免 Key | stdio | 数据不出内网、需要自定义搜索源与排序 |
| 抓取增强型 | Firecrawl 类 Server | API Key | HTTP | 需要正文抽取、Markdown 化,而不只是链接列表 |
具体额度和计费以各家官方文档为准,接入前务必确认限额刷新周期。另外,若通过 API 直接访问云上 MCP 服务,还要留意认证机制(AK/SK 或 API Key)和区域选择——例如音视频类服务分为华北-北京、华南-广州、华东-苏州三个 Region,且服务区域需与 BOS 存储区域保持一致。搜索类 Server 一般无此约束,但同一套”先确认区域与鉴权方式”的排查思路是通用的。
MCP 的价值在于标准化和复用,但它不是所有场景的最优解:
按这个顺序走,通常半天内就能得到一个稳定可用的联网搜索 Agent,而不必先啃一堆 REST 文档。