快速配置
选择适合您环境的设置。
最后验证: 2026-04-27
验证环境: Node.js 22，@brave/brave-search-mcp-server 使用 stdio
安装命令:
npx -y @brave/brave-search-mcp-server --transport stdio本地配置
JSON 本地配置 json
{
"brave-search": {
"command": "npx",
"args": ["-y", "@brave/brave-search-mcp-server", "--transport", "stdio"],
"env": {
"BRAVE_API_KEY": "${BRAVE_API_KEY}"
}
}
}验证提示词
搜索 “Model Context Protocol official docs”，返回最像官方来源的前 3 个结果。
成功时应看到
应看到 Brave Search 返回的标题、URL 和摘要。
常见陷阱与修复
- ⚠️ 注意: API 密钥注册和端点选择。
- 🔑 始终将 API 密钥存储在环境变量中，切勿硬编码在 JSON 中。
- 🛡️ 如果可用，从只读权限开始，以安全地验证连接。
安全检查
- 把 BRAVE_API_KEY 放在环境变量里，不要提交到 JSON 配置。
- 把搜索结果当作不可信网页内容，引用前先验证来源。
常见错误
| 错误 | 原因 | 修复方法 |
|---|---|---|
401 Unauthorized | 缺少 BRAVE_API_KEY，或密钥无效。 | 创建 Brave Search API key，并在启动 OpenClaw 前设置 BRAVE_API_KEY。 |
Rate limit exceeded | 免费额度或当前套餐额度已用完。 | 等待额度恢复，减少重复搜索，或升级 Brave Search API 套餐。 |
No search results | 服务已启动，但查询或工具没有返回匹配结果。 | 换一个更宽泛的查询，并确认 API key 已开通网页搜索能力。 |
示例提示词
连接后，尝试这些提示词以测试功能：
- 搜索网络上最新的 MCP 基准测试，并总结前 3 个来源。
- 找到解释 Model Context Protocol 的可靠来源。
- 收集三篇关于 AI 工具的近期文章并进行总结。