联网搜索-大模型服务平台百炼(Model Studio)-阿里云帮助中心

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

说明

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

前提条件

已订阅 Coding Plan，详情请参见快速开始。
已在 Coding Plan 工具（如 Claude Code、Qwen Code）中完成接入配置，且能正常对话，详情请参见接入AI工具。
已获取百炼 API Key。此处的 API Key 为百炼通用 API Key（格式为 sk-xxx），用于调用 MCP 服务，与 Coding Plan 专属 API Key（格式为 sk-sp-xxx）不同。

开通联网搜索 MCP

进入百炼的MCP广场，找到联网搜索 MCP 服务。
单击立即开通 > 确认开通。
- 联网搜索、网页抓取、代码解释器等 MCP 服务限时免费，每月 2000 次免费额度。如果使用第三方MCP服务，该MCP服务可能收费，以MCP服务的介绍信息为准。
开通成功后，可以获取以下配置信息：
1. Streamable HTTP Endpoint：MCP 服务的连接地址。联网搜索 MCP 的连接地址为https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp。
2. API Key：即百炼 API Key，是 MCP 服务的鉴权密钥。

接入工具

将 MCP 服务添加到 AI 编程工具中。

OpenClaw

在终端执行如下命令安装 MCPorter。
```
npm install -g mcporter
```

在终端执行如下命令，启用 MCPorter。

openclaw config set skills.entries.mcporter.enabled true

在~/.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"
```
在~/.openclaw/workspace目录下，执行如下命令确认MCP已安装。
```
mcporter list
```
在终端执行如下命令使配置生效。
```
openclaw gateway restart
```
发送提问用 mcporter 搜索阿里云的新闻即可看到搜索结果。

OpenCode

在 OpenCode 配置文件~/.config/opencode/opencode.json中写入 MCP 配置信息，并将YOUR_API_KEY替换为上一步骤获取的 API Key。
```
{
  "mcpServers": {
    "WebSearch": {
      "httpUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```
若opencode.json中已有其他配置（如 provider），将 mcp 字段合并到现有配置中即可。配置完成后，保存文件。
在终端中执行以下命令进入 OpenCode。
```
opencode
```
在对话框执行/mcps确认websearch状态是否为 Enabled。确认后按 Esc 退出。
发送提问用websearch MCP搜索阿里云的新闻即可看到搜索结果。
为了避免和其他工具混淆，建议提问时明确提及 websearch MCP。

Claude Code

在终端中执行以下命令来添加联网搜索MCP服务。
说明
执行命令前，请将命令中的 YOUR_API_KEY 替换为开通联网搜索MCP时使用的阿里云百炼 API Key。
```
claude mcp add WebSearch https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp -t http -H "Authorization: Bearer YOUR_API_KEY"
```
终端返回 Added SSE MCP server xx 即表示添加成功。
执行以下命令进入 Claude Code。
```
claude
```
在对话框执行/mcp命令，确认websearch的状态为 connected。首次添加可能需要等待状态从 connecting 变成 connected。
按 Esc 退出 MCP 列表后，发送提问用websearch MCP搜索阿里云的新闻即可看到搜索结果。
为了避免和其他工具混淆，建议提问时明确提及 websearch MCP。

Qwen Code

添加联网搜索 MCP。
1. 将以下命令复制到终端。
```
qwen mcp add WebSearch \
  -t http \
  "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp" \
  -H "Authorization: Bearer YOUR_API_KEY"
```
2. 将命令中的 YOUR_API_KEY 替换为开通联网搜索 MCP时获取的阿里云百炼 API Key。
3. 在终端执行更新后的命令。
  说明
  终端返回MCP server "WebSearch" added to user settings. (http)并不代表 MCP 添加成功，其连接状态需通过以下步骤确认。
在终端执行以下命令进入 Qwen Code。
```
qwen
```
在Qwen Code对话框执行/mcp命令以确认 MCP 连接状态。
发送提问用 websearch MCP 搜索阿里云的新闻即可看到搜索结果。
为了避免和其他工具混淆，建议提问时明确提及websearch MCP。

Kilo CLI

在配置文件~/.config/kilo/opencode.json中写入 MCP 配置信息，并将YOUR_API_KEY替换为上一步骤获取的 API Key。配置完成后，保存文件。
```
{
  "mcp": {
    "websearch": {
      "type": "remote",
      "url": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```
若opencode.json中已有其他配置（如 provider），将 mcp 字段合并到现有配置中即可。配置完成后，保存文件。
在终端中执行以下命令查看 MCP 状态。Connected 即表示连接成功。
```
kilocode mcp list
```
在终端中执行以下命令进入 Kilo CLI。
```
kilo
```
发送提问用websearch MCP搜索阿里云的新闻即可看到搜索结果。
为了避免和其他工具混淆，建议提问时明确提及 websearch MCP。

Kilo Code IDE 插件

打开Kilo Code IDE插件配置联网搜索 MCP 信息，并将YOUR_API_KEY替换为上一步骤获取的 API Key。配置完成后，保存文件。

{
  "mcpServers": {
    "websearch": {
      "type": "streamable-http",
      "url": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

当联网搜索的MCP状态显示为绿色时，表示添加成功。

返回对话界面，发送提问用websearch MCP搜索阿里云的新闻即可看到搜索结果。
为了避免和其他工具混淆，建议提问时明确提及 websearch MCP。

常见问题

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

常见原因及排查方式：

SSE Endpoint 地址错误：检查 URL 是否拼写正确，完整 URL 为 https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/sse。
API Key 无效：确认使用的是百炼通用 API Key（非 Coding Plan 专属 API Key），且 Key 处于启用状态。
网络不通：确认当前网络可以访问。

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

请确保联网搜索 MCP 服务连接成功并可用。
在对话中明确提及工具名称，例如：用 websearch MCP 搜索阿里云的新闻。