安装 Google Cloud AlloyDB 插件

安装 alloydb@data-agent-kit，配置 ADC 凭证和 ALLOYDB_POSTGRES_* 实例信息，通过本地 alloydb-postgres MCP 连接数据库。

这是 gemini-cli-extensions/alloydb 的 Codex 专节。插件把 MCP Toolbox 的预置 alloydb-postgres 打成 Agent Plugin，用 ADC 加实例坐标连 AlloyDB for PostgreSQL，用于创建集群、查看 schema 和执行 SQL。

要 Codex v0.117.0+，本机有 Node / npx。先开 AlloyDB API，IAM 至少 roles/alloydb.client（管资源再加 roles/alloydb.admin），再准备 ADC：

gcloud auth application-default login
export ALLOYDB_POSTGRES_PROJECT=YOUR_ALLOYDB_POSTGRES_PROJECT
export ALLOYDB_POSTGRES_REGION=YOUR_ALLOYDB_POSTGRES_REGION
export ALLOYDB_POSTGRES_CLUSTER=YOUR_ALLOYDB_POSTGRES_CLUSTER
export ALLOYDB_POSTGRES_INSTANCE=YOUR_ALLOYDB_POSTGRES_INSTANCE
export ALLOYDB_POSTGRES_DATABASE=YOUR_ALLOYDB_POSTGRES_DATABASE
# 可选：ALLOYDB_POSTGRES_USER、ALLOYDB_POSTGRES_PASSWORD、ALLOYDB_POSTGRES_IP_TYPE（PUBLIC / PRIVATE / PSC，默认 PUBLIC）

用户和密码可留空，默认走 IAM 数据库用户。私有网络必须把 Codex 跑在同一 VPC。不要把密码写进 http_headers。

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

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

IDE 扩展没有 /plugins。

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

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