安装 Spanner 插件

从 Data Agent Kit 安装 spanner@data-agent-kit，配置 ADC 和 SPANNER_PROJECT 等实例信息，通过本地 spanner MCP 查询数据库。

这是 gemini-cli-extensions/spanner 的 Codex 专节。插件把 MCP Toolbox 的预置 spanner 封装为插件，用 ADC 加实例连接参数连 Cloud Spanner，用于查看 schema 和执行 SQL。

要 Codex v0.117.0+，本机有 Node / npx。先开 Spanner API，IAM 至少 roles/spanner.databaseReader（写库再加 roles/spanner.databaseUser），再准备 ADC：

gcloud auth application-default login
export SPANNER_PROJECT=YOUR_SPANNER_PROJECT
export SPANNER_INSTANCE=YOUR_SPANNER_INSTANCE
export SPANNER_DATABASE=YOUR_SPANNER_DATABASE
# 可选：SPANNER_DIALECT=googlesql 或 postgresql，默认 googlesql

不要把项目号写进 http_headers 当密钥。方言不要抄成 AlloyDB 那套 ALLOYDB_POSTGRES_*。

清单 .agents/plugins/marketplace.json 的 name 是 data-agent-kit，插件 name 是 spanner：

codex --version
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add spanner@data-agent-kit
codex plugin list
codex mcp list

IDE 扩展没有 /plugins。

插件会登记一台 stdio MCP，表名就是 spanner。command 是 npx，args 指定 @toolbox-sdk/server@1.9.0 --prebuilt spanner --stdio。不要 codex mcp login spanner。插件已经带 MCP 时，不要再 codex mcp add spanner -- npx @toolbox-sdk/server 叠一张用户层表。

可选：codex plugin marketplace upgrade data-agent-kit 后再 plugin add 一次。0.154 起先看当前会话的 /plugins 和 /mcp；没有再新开。codex mcp list 里应有 spanner。连接失败先看 ADC 和三个必填 SPANNER_* 是不是进了同一进程，以及 npx 能不能拉到 Toolbox。