在 Token Plan 支持的编程工具中添加联网搜索工具,使模型能够检索实时信息。
适用范围
本文适用于需要通过 MCP 扩展联网搜索能力的工具,如 Qwen Code、Claude Code 等。部分工具(如 Cursor)已内置联网搜索功能,无需额外添加联网搜索服务。
前提条件
- 已订阅 Token Plan,详情请参见快速开始。
- 已在 Token Plan 支持的工具(如 Claude Code、Qwen Code)中完成接入配置,且能正常对话,详情请参见接入客户端/开发工具。
- 已获取百炼 API Key。此处的 API Key 为百炼通用 API Key(格式为 sk-xxx),用于调用 MCP 服务,与 Token Plan 专属 API Key(格式为 sk-sp-xxx)不同。
开通或升级联网搜索 MCP
联网搜索 MCP 已从旧版 SSE 协议升级为新版 Streamable HTTP 协议。请根据您的情况选择对应的操作步骤:
- 首次开通(新用户)
- 升级协议(已开通用户)
- 进入百炼的MCP广场,找到联网搜索 MCP 服务。
-
单击立即开通确认开通。
- 联网搜索 MCP 全部用户前 2000 次调用免费,免费额度用尽后按 29 元/千次计费。如果使用第三方 MCP 服务,该 MCP 服务可能收费,以 MCP 服务的介绍信息为准。
- 部分MCP服务支持个人FC资源部署,按实际调用时长和次数计费,适用于需要专属资源、指定资源地域等场景。
-
开通成功后,可以获取以下配置信息:
- Streamable HTTP Endpoint:MCP 服务的连接地址。联网搜索 MCP 的连接地址为
https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp。 - API Key:即百炼 API Key,是 MCP 服务的鉴权密钥。
- Streamable HTTP Endpoint:MCP 服务的连接地址。联网搜索 MCP 的连接地址为
接入工具
将 MCP 服务添加到 AI 编程工具中。
- OpenClaw
- OpenCode
- Claude Code
- Qwen Code
- Cline
- Kilo CLI
- Kilo Code IDE 插件
- 在终端执行如下命令安装 MCPorter。
- 在终端执行如下命令,启用 MCPorter。
- 在
~/.openclaw /workspace目录下,执行如下命令。执行命令前,将命令中的 YOUR_API_KEY 替换为开通或升级联网搜索 MCP时获取的阿里云百炼 API Key。
- 在
~/.openclaw /workspace目录下,执行如下命令确认MCP已安装。
- 在终端执行如下命令使配置生效。
-
发送提问
用 mcporter 搜索阿里云的新闻即可看到搜索结果。 系统返回包含 4 条阿里云相关新闻的卡片,每条新闻显示标题、来源及发布时间,底部提示是否需要抓取某篇新闻的详细内容。
常见问题
无法连接联网搜索 MCP 服务怎么办?
常见原因及排查方式:
- 未开通或者未升级联网搜索 MCP 服务:请确认已在百炼 MCP 广场开通或升级联网搜索 MCP 服务,详情请参见开通或升级联网搜索 MCP。
-
Streamable HTTP Endpoint 地址错误:
- 请检查 URL 是否拼写正确,完整 URL 为
https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp。 - 如果使用的 URL 为
https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/sse,说明开通的是旧版 SSE 协议,请将协议升级至Streamable HTTP。
- 请检查 URL 是否拼写正确,完整 URL 为
- API Key 错误:请确认使用了有效的百炼通用 API Key(格式为 sk-xxx,非 Token Plan 专属 API Key),并已在命令中正确替换 YOUR_API_KEY。
- 免费额度用尽:联网搜索 MCP 全部用户前 2000 次调用免费,免费额度用尽后按 29 元/千次计费,请确认账户余额充足。
- 网络不通:确认当前网络可以访问。
对话中模型没有调用联网搜索怎么办?
- 请确保联网搜索 MCP 服务连接成功并可用。
- 在对话中明确提及工具名称,例如:
用 websearch MCP 搜索阿里云的新闻。


