OpenCode 对接 Google 搜索 MCP
内容提要
本文介绍在 OpenCode 中接入 Google 搜索 MCP Server 的方法：先在 Ace Data Cloud 控制台获取 API Token 并写入环境变量，再在全局或项目级 opencode.json 中配置 serp 远程服务，使用 Bearer Token 鉴权且须将 oauth 设为 false，之后即可在终端直接搜索 Google，用于调试、调研和查文档。
延伸解读
为什么必须显式设置 oauth 为 false
AceData 的 MCP Server 使用 Bearer Token 鉴权，不走 OAuth 流程。但 OpenCode 默认会把 401 响应当作 OAuth 挑战并自动重定向，导致 opencode mcp list 出现 SSE error: Non-200 status code (401)。显式声明 "oauth": false 后，OpenCode 会直接以 Authorization: Bearer ... 调用，opencode mcp debug serp 也会回显 OAuth explici
全局配置与项目级配置的取舍
opencode.json 可放在 ~/.config/opencode/ 下作为全局配置，所有项目共用；也可放在项目根目录作为项目级配置，仅当前项目生效且会覆盖全局。全局适合个人机器一次配好；项目级适合团队共享或单仓库定制。若项目级文件会提交到 Git，务必用 {env:ACEDATACLOUD_API_KEY} 占位符而非真实 Token，避免泄露。
环境变量未导出时的常见坑
如果 Shell 里的 .env 没有显式 export，OpenCode 进程无法读取变量，opencode debug config 会显示 "Authorization": "Bearer "，即占位符没解析。此时需用 set -a && source .env && set +a 把变量传给 OpenCode。验证连接时运行 opencode mcp list 和 opencode mcp debug serp，看到 serp connected 即握手成功；失败则检查 Token 是否导出、oauth 是
Q&A
如何在 OpenCode 中配置 Google 搜索 MCP Server？
在 opencode.json 的 mcp 字段下添加 serp 服务，type 设为 remote，url 为 https://serp.mcp.acedata.cloud/mcp，enabled 为 true，oauth 为 false，headers 中 Authorization 设为 Bearer {env:ACEDATACLOUD_API_KEY}。配置文件可放在全局 ~/.config/opencode/opencode.json 或项目根目录的 opencode.json。
为什么配置 Google 搜索 MCP 时必须设置 oauth 为 false？
因为 AceData 的 MCP Server 使用 Bearer Token 鉴权，不走 OAuth 流程。OpenCode 默认会把 401 响应当作 OAuth 挑战并自动重定向，导致出现 SSE error: Non-200 status code (401)。显式设置 oauth: false 后，OpenCode 会直接以 Authorization: Bearer ... 调用，避免该错误。
如何获取 Google 搜索 MCP 所需的 API Token？
打开 Ace Data Cloud 控制台的应用列表，即可获取 API Token。首次申请会有免费额度。该 Token 与 Claude Code 共用，且一个 Token 可使用 Ace Data Cloud 提供的全部 MCP Server，无需单独为 Google 搜索申请。
配置后如何验证 OpenCode 是否成功连接 Google 搜索 MCP？
运行 opencode mcp list 和 opencode mcp debug serp，看到 serp connected 即表示握手成功。如果失败，检查 ACEDATACLOUD_API_KEY 是否已导出、oauth 是否为 false，以及 Authorization 是否包含 Bearer 前缀。
Google 搜索 MCP 在 OpenCode 中有哪些典型使用场景？
适合在 OpenCode 里调试生产问题、做技术选型调研、查官方文档、找 GitHub issue，以及任何需要搜索网页才能继续工作的场景。例如搜索 nginx 502 错误解决方案、Python 异步 ORM 性能对比、Kubernetes CronJob 官方文档等。
Google 搜索 MCP 提供了哪些搜索工具？
主要工具包括：serp_google_search（网页搜索，支持指定国家、语言、时间范围）、serp_google_images（图片搜索）、serp_google_news（新闻搜索）、serp_google_videos（视频搜索）、serp_google_maps / serp_google_places（地图/本地商户搜索）。
