在远程服务器上调试问题时,遇到不熟悉的错误日志,传统做法是复制错误信息,切换到本地浏览器搜索,再切回终端。配置 Serp MCP Server 后,Claude Code 可以直接在终端内调用 Google 搜索,全程无需离开命令行。
使用 Google 搜索 MCP Server 之前,需要准备 Ace Data Cloud 的 API Token。流程如下:
- 1. 访问 Ace Data Cloud 控制台的应用列表页面
- 2. 登录后获取 API Token
- 3. 首次申请有免费额度可用于体验
Token 获取后请妥善保管,建议以脱敏形式展示(如 3b78cc40dd3b43db806a4300....),不要将完整 Token 提交到公开仓库、Issue、截图或聊天记录中。
使用 claude.ai 网页版或 Claude Desktop 的用户支持 OAuth 一键授权,无需手动填写 Token。

配置 Claude Code
以下三种配置方式任选一种即可。注意 -H 参数必须大写,小写 -h 是 --help;Authorization 后面的 Token 需替换为实际值。
方式一:仅当前项目可用(local)
适合试用场景,配置仅绑定运行命令时所在的项目目录。
claude mcp add serp --transport http https://serp.mcp.acedata.cloud/mcp -H "Authorization: Bearer YOUR_TOKEN_HERE" -s local
方式二:所有项目可用(user)
配置写入本机 ~/.claude.json 的用户级配置,之后任何项目打开 Claude Code 都能访问。
claude mcp add serp --transport http https://serp.mcp.acedata.cloud/mcp -H "Authorization: Bearer YOUR_TOKEN_HERE" -s user
方式三:随项目共享(project)
配置写入项目根目录的 .mcp.json,可提交到私有仓库供团队复用。
claude mcp add serp --transport http https://serp.mcp.acedata.cloud/mcp -H "Authorization: Bearer YOUR_TOKEN_HERE" -s project
项目级配置首次被 Claude Code 读取时可能显示 Pending approval,需要在会话中确认信任该配置,这是正常的安全机制。
验证配置
运行以下命令检查配置状态:
claude mcp list
输出中出现 serp: https://serp.mcp.acedata.cloud/mcp (HTTP) - ✓ Connected 即表示 Google 搜索 MCP 已接入成功。
三种 scope 的实测结果:
luma-local: ✓ Connected
luma-user: ✓ Connected
luma-project: ⏸ Pending approval (运行 claude 审批)
典型使用场景
配置完成后,在 Claude Code 会话中直接用自然语言调用搜索。
调试生产问题
SSH 到远程服务器后,遇到不认识的错误码,无需打开浏览器或断开 SSH:
搜索 nginx error 502 bad gateway upstream sent too big header 怎么解决
技术选型调研
可以限定时间范围,只看最新结果:
搜索 2025 年 Python 异步 ORM 性能对比,SQLAlchemy 2.0 async vs Tortoise ORM
查阅官方文档
直接搜索比凭记忆更可靠:
搜索 Kubernetes CronJob concurrencyPolicy 官方文档,Forbid 和 Replace 的区别
可用工具列表
工具说明
| serp_google_search | Google 网页搜索,支持国家、语言、时间范围 |
| serp_google_images | Google 图片搜索 |
| serp_google_news | Google 新闻搜索 |
| serp_google_videos | Google 视频搜索 |
| serp_google_maps / serp_google_places | 地图与本地商户搜索 |
总结
将 Google 搜索 MCP 接入 Claude Code 后,开发者可以在终端内直接完成信息检索,大幅减少上下文切换带来的效率损耗。对于经常使用 SSH 远程调试的开发者来说,这是一个值得配置的实用工具。
相关链接: