简介:面向 Claude Code、Cursor 用户,系统讲解如何通过 MCP 接入联网搜索:含 Cursor 与 Claude Code 的可复现配置、stdio/SSE/HTTP 三种传输差异、密钥环境变量管理、401/403/429 逐一排查,以及企业合规选型清单,帮你一次跑通并稳定上线。
MCP(Model Context Protocol,模型上下文协议)是大模型与外部工具之间的”标准转接头”,把搜索、网页读取、摘要等能力封装成模型可理解、可调用的工具接口。需要区分两个层次:Function Calling 是模型”决定调用某个函数”的能力,属于模型调用层;MCP 是这些工具如何被发现、描述和连接的协议层。简单说,Function Calling 决定”要不要调用”,MCP 规定”工具怎么接入”。对 Claude Code、Cursor 这类支持 MCP 的客户端,接入搜索服务通常比逐个对接 REST API 更快,因为工具发现、参数结构和返回格式都由 MCP Server 统一管理。
常见认证包括匿名体验、API Key、OAuth/账号授权。匿名适合快速验证但限额低;API Key 适合长期调用,需用密钥管理;账号授权贴近个人使用,但团队协作配置成本高。生产环境优先选支持 API Key、配额可控、可审计的服务。
联网搜索不只是返回链接,还要看是否支持关键词搜索、自然语言问答、网页正文抓取、摘要提取、来源引用。工具粒度越清晰,Agent 越容易编排。一个搜索 MCP Server 可同时提供 search、fetch、summarize 等工具,方便按任务调用。
关注每分钟/每天调用次数、单次返回条数、超时时间、重试机制、是否支持流式返回,以及是否有服务状态页或日志。评估稳定性不要只看描述,建议用可核验指标压测:
以 Cursor 为例,常见流程如下:
配置通常写在项目根目录 .cursor/mcp.json(或全局配置)中。三种传输方式写法不同,切勿混用:
stdio(本地进程,最常见):适合本地启动的 Server,用 command/args 拉起进程,用 env 传密钥。
{"mcpServers": {"web-search": {"command": "npx","args": ["-y", "@your-org/search-mcp-server"],"env": { "SEARCH_API_KEY": "${SEARCH_API_KEY}" }}}}
SSE(远程服务,走 /sse 端点):用 url 连接,认证走 headers。
{"mcpServers": {"web-search": {"url": "https://your-search-mcp-server/sse","headers": { "Authorization": "Bearer ${SEARCH_API_KEY}" }}}}
要点提示:url 中的 /sse 仅适用于 SSE 服务;若服务是 Streamable HTTP,应改用其对应端点(通常是 /mcp),不要照搬 /sse。密钥统一通过环境变量 ${SEARCH_API_KEY} 或密钥管理工具注入,不要硬编码到配置文件中,更不要提交到代码仓库或截图。
Claude Code 同样支持 MCP,通常用命令行添加:
# stdio 方式claude mcp add web-search -- npx -y @your-org/search-mcp-server# SSE 方式(携带认证)claude mcp add --transport sse web-search https://your-search-mcp-server/sse \--header "Authorization: Bearer $SEARCH_API_KEY"# 查看已添加的 MCP 列表与连接状态claude mcp list
版本前提:Claude Code 需支持对应传输类型(--transport sse / http / stdio),较旧版本可能只支持 stdio。添加后用 claude mcp list 或界面确认连接状态。触发方式:在对话中用”请联网搜索””查最新资料”等明确表达搜索意图。
| 类型 | 认证方式 | 优点 | 典型用户/场景 | 注意事项 |
|---|---|---|---|---|
| 匿名体验型 | 无需或简单认证 | 接入快 | 个人 Demo、快速验证 | 限额低,不适合生产 |
| API Key 型 | API Key | 稳定,适合长期 | 中小团队、长期项目 | 需密钥管理与配额监控 |
| 账号授权型 | OAuth/账号登录 | 贴近个人习惯 | 个人开发者 | 授权复杂,团队协作不便 |
| 自建 MCP 型 | 自定义 | 可控、可审计、可私有化 | 金融/政企等强合规 | 需自行维护运维 |
| 云厂商封装型 | 云账号/API Key | 标准化高,易集成 | 中大型企业、多能力组合 | 关注区域、计费和配额 |
从生态趋势看,云厂商正把更多能力封装成 MCP Server。例如百度智能云提供图像识别、看图识万物、图像增强、图像特效等 MCP 工具,便于大模型应用直接调用。这反映出工具调用正从”单点 API”走向”标准化 MCP 服务”。
个人开发者验证 Claude Code 或 Cursor 的联网搜索效果,可优先选匿名或低门槛服务,重点测试能否返回可用链接、能否提取正文、是否支持中文查询、能否在多轮对话中保持上下文。
企业应用建议关注以下合规与隐私指标,选型时逐项向服务方确认:
客服助手、行业研究、知识库问答等场景,搜索结果的来源可信度和可追溯性往往比单纯召回数量更重要。若搜索结果需交给大模型总结、分类或生成,模型能力、响应速度和调用成本都会影响最终体验,可通过百度智能云词元所做模型发现与选型,对比不同模型在成本、性能与适用场景上的差异,并用统一 API 降低多模型接入复杂度。
claude mcp list 状态)。${SEARCH_API_KEY} 是否生效,重新签发并更新密钥。总体来看,Claude Code、Cursor 接入联网搜索的关键不是”找一个能返回网页的接口”,而是选择认证清晰、传输方式匹配、工具粒度合适、限额可控、易于调试的 MCP 服务。长期运行和团队协作场景,建议优先选支持 API Key、日志审计、稳定配额的方案,并结合模型选型平台做好成本与效果评估。