Skip to main content
最佳实践

联网搜索

在 Token Plan 支持的编程工具中添加联网搜索工具,使模型能够检索实时信息。

适用范围

本文适用于需要通过 MCP 扩展联网搜索能力的工具,如 Qwen Code、Claude Code 等。部分工具(如 Cursor)已内置联网搜索功能,无需额外添加联网搜索服务。

前提条件

  1. 已订阅 Token Plan,详情请参见快速开始
  2. 已在 Token Plan 支持的工具(如 Claude Code、Qwen Code)中完成接入配置,且能正常对话,详情请参见接入客户端/开发工具
  3. 已获取百炼 API Key。此处的 API Key 为百炼通用 API Key(格式为 sk-xxx),用于调用 MCP 服务,与 Token Plan 专属 API Key(格式为 sk-sp-xxx)不同。

开通或升级联网搜索 MCP

联网搜索 MCP 已从旧版 SSE 协议升级为新版 Streamable HTTP 协议。请根据您的情况选择对应的操作步骤:
  • 首次开通(新用户)
  • 升级协议(已开通用户)
  1. 进入百炼的MCP广场,找到联网搜索 MCP 服务。
  2. 单击立即开通确认开通
    • 联网搜索 MCP 全部用户前 2000 次调用免费,免费额度用尽后按 29 元/千次计费。如果使用第三方 MCP 服务,该 MCP 服务可能收费,以 MCP 服务的介绍信息为准。
    • 部分MCP服务支持个人FC资源部署,按实际调用时长和次数计费,适用于需要专属资源、指定资源地域等场景。
  3. 开通成功后,可以获取以下配置信息:
    1. Streamable HTTP Endpoint:MCP 服务的连接地址。联网搜索 MCP 的连接地址为https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp
    2. API Key:即百炼 API Key,是 MCP 服务的鉴权密钥。

接入工具

将 MCP 服务添加到 AI 编程工具中。
  • OpenClaw
  • OpenCode
  • Claude Code
  • Qwen Code
  • Cline
  • Kilo CLI
  • Kilo Code IDE 插件
  1. 在终端执行如下命令安装 MCPorter。
npm install -g mcporter
  1. 在终端执行如下命令,启用 MCPorter。
openclaw config set skills.entries.mcporter.enabled true
  1. ~/.openclaw /workspace目录下,执行如下命令。执行命令前,将命令中的 YOUR_API_KEY 替换为开通或升级联网搜索 MCP时获取的阿里云百炼 API Key。
mcporter config add WebSearch https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp --transport http --header "Authorization=Bearer YOUR_API_KEY" --scope home
  1. ~/.openclaw /workspace目录下,执行如下命令确认MCP已安装。
mcporter list
mcporter 0.7.3 Listing 1 server(s) (per-server timeout: 30s)
- websearch (1 tool, 2.4s)
[ok] Listed 1 server (1 healthy).
  1. 在终端执行如下命令使配置生效。
openclaw gateway restart
  1. 发送提问用 mcporter 搜索阿里云的新闻即可看到搜索结果。 系统返回包含 4 条阿里云相关新闻的卡片,每条新闻显示标题、来源及发布时间,底部提示是否需要抓取某篇新闻的详细内容。

常见问题

无法连接联网搜索 MCP 服务怎么办?

常见原因及排查方式:
  1. 未开通或者未升级联网搜索 MCP 服务:请确认已在百炼 MCP 广场开通或升级联网搜索 MCP 服务,详情请参见开通或升级联网搜索 MCP
  2. 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
  3. API Key 错误:请确认使用了有效的百炼通用 API Key(格式为 sk-xxx,非 Token Plan 专属 API Key),并已在命令中正确替换 YOUR_API_KEY。
  4. 免费额度用尽:联网搜索 MCP 全部用户前 2000 次调用免费,免费额度用尽后按 29 元/千次计费,请确认账户余额充足。
  5. 网络不通:确认当前网络可以访问。

对话中模型没有调用联网搜索怎么办?

  1. 请确保联网搜索 MCP 服务连接成功并可用。
  2. 在对话中明确提及工具名称,例如:用 websearch MCP 搜索阿里云的新闻
模型体验
  • 3D模型生成
  • 音乐生成
模型调优
模型压缩目录节点
用量统计与性能监控
资产中心
服务支持