安装 AlloyDB Omni 插件

安装 alloydb-omni@data-agent-kit，使用 ALLOYDB_OMNI_* 参数连接实例。数据库名和用户名必填，密码要求取决于实例配置。

这是 gemini-cli-extensions/alloydb-omni 的 Codex 专节。插件把 MCP Toolbox 的预置 alloydb-omni 封装为插件，用数据库用户连本机 / 容器 / RPM 上的 AlloyDB Omni，用于查看 schema 和执行 SQL、看复制和列存。

要 Codex v0.117.0+，本机有 Node / npx，并且已经有一台在跑的 Omni 实例。这不是 Cloud AlloyDB，不要 gcloud auth application-default login，也不要发明 ALLOYDB_OMNI_PROJECT：

export ALLOYDB_OMNI_DATABASE=YOUR_ALLOYDB_OMNI_DATABASE
export ALLOYDB_OMNI_USER=YOUR_ALLOYDB_OMNI_USER
export ALLOYDB_OMNI_PASSWORD=YOUR_ALLOYDB_OMNI_PASSWORD
# 可选：ALLOYDB_OMNI_HOST（默认 localhost）、ALLOYDB_OMNI_PORT（默认 5432）、ALLOYDB_OMNI_QUERY_PARAMS

DATABASE 和 USER 必填。PASSWORD 看实例（Toolbox 文档标可选）。不要把密码写进 http_headers。不要抄 POSTGRES_HOST / POSTGRES_DATABASE。

清单 .agents/plugins/marketplace.json 的 name 是 data-agent-kit，插件 name 和 MCP 表名都是 alloydb-omni：

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

IDE 扩展没有 /plugins。

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

可选：codex plugin marketplace upgrade data-agent-kit 后再 plugin add 一次。0.154 起先看当前会话的 /plugins 和 /mcp；没有再新开。codex mcp list 里应有 alloydb-omni。连接失败先看 Omni 实例是不是在听、三个必填 ALLOYDB_OMNI_* 是不是进了同一进程，以及 npx 能不能拉到 Toolbox 1.9.0。发行仍是 Beta（pre-v1.0）。保持工具调用审批。