你在远程服务器上用 Claude Code 排查一个 OOM 问题。看到了一条不太熟悉的内核日志。以前只能复制错误信息,切到本地浏览器搜索,再切回终端。
但如果 Claude Code 能直接搜 Google 呢?
获取 API Token
使用 Serp MCP Server 之前,你需要一个 AceData Cloud 的 API Token。获取方式非常简单:
- 打开 AceData Cloud 平台,支持 GitHub、Google 或微信登录,注册后自动获得免费额度
- 登录后,在首页即可看到你的 API Token,点击复制按钮即可获取

- 如果额度用完,可以前往 控制台 充值,支持支付宝、微信和 Stripe
一个 Token 即可使用所有 MCP Server,无需为每个服务单独申请。
💡 如果你不想手动配置,也可以直接在 Claude.ai 网页版中使用,通过 OAuth 连接,无需 API Token。详见 Claude + Google Search MCP 图文教程。
配置 Claude Code
一行命令搞定:
1 |
claude mcp add serp --transport http https://serp.mcp.acedata.cloud/mcp \ |
⚠️ 注意:
-H必须大写。小写-h是--help,不是 header 参数。
不加 -s 默认是 local scope,只在当前项目目录下生效。建议明确指定 scope:
| Scope | 命令参数 | 配置文件 | 作用范围 |
|---|---|---|---|
local(默认) |
不加 -s,或 -s local |
~/.claude.json |
仅在运行命令时所在的项目目录下生效 |
user |
-s user |
~/.claude.json |
全局生效,所有项目都能用 |
project |
-s project |
项目根目录 .mcp.json |
仅当前项目,可提交到 git 共享给团队 |
将 你的Token 替换为上一步复制的 API Token。添加后 Claude Code 自动加载搜索工具。
典型场景
调试生产问题
SSH 到远程服务器,遇到不认识的错误码:
1 |
搜索 nginx error 502 bad gateway upstream sent too big header 怎么解决 |
不需要开浏览器,不需要断开 SSH。
技术选型调研
1 |
搜索一下 2025 年 Python 异步 ORM 的性能对比,SQLAlchemy 2.0 async vs Tortoise ORM |
可以限定时间范围,只看最新结果。
查官方文档
1 |
搜索 Kubernetes CronJob concurrencyPolicy 的官方文档,Forbid 和 Replace 的区别 |
直接搜官方文档比凭记忆靠谱。
完整工具列表
| 工具 | 说明 |
|---|---|
| serp_google_search | Google 搜索(网页/图片/新闻/视频等) |
支持指定国家、语言、时间范围。
团队共享配置
项目根目录放 .mcp.json,团队 clone 后自动能用:
1 |
{ |
其他编辑器配置
- Cursor —
.cursor/mcp.json中mcpServers下添加同样配置 - VS Code —
.vscode/mcp.json中servers下添加同样配置 - Windsurf —
.windsurf/mcp.json,格式同 Cursor