安装 Google Cloud Knowledge Catalog 插件

从 Data Agent Kit 安装 knowledge-catalog@data-agent-kit。配置 DATAPLEX_PROJECT 和 ADC 凭证后，通过本地 dataplex MCP 查询目录。

codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add knowledge-catalog@data-agent-kit
export DATAPLEX_PROJECT=YOUR_PROJECT_ID
gcloud auth application-default login
codex plugin list
codex mcp list

清单 .agents/plugins/marketplace.json 的 name 是 data-agent-kit，展示名 Data Agent Kit。Knowledge Catalog 插件名是 knowledge-catalog，分类 Data Governance & Management，源仓是 gemini-cli-extensions/knowledge-catalog。同一份清单里还有 BigQuery、Spanner、AlloyDB 等，不要一次全装；这条只装目录插件。

GCP Dataplex 文档 Codex 节写成 codex plugin install dataplex@data-agent-kit：CLI 动词是 add 不是 install，插件 id 是 knowledge-catalog 不是 dataplex。dataplex 是插件登记的 MCP 表名，不是 marketplace 插件名。以插件仓 README 为准。

先开目标项目的 Dataplex API。DATAPLEX_PROJECT 填 GCP 项目 ID，不要填项目号。本机要有 Application Default Credentials：

gcloud auth application-default login

文档 IAM 写 Dataplex Catalog Viewer；插件 README 写 Dataplex Data Reader 加 Service Usage Consumer。按你实际要查的资产向管理员要角色，不要把 Owner 写进 AGENTS.md。

插件会登记 stdio MCP。表名官方就是 dataplex（小写按这份），命令是 npx -y @toolbox-sdk/server@1.9.0 --prebuilt dataplex --stdio，并转发 DATAPLEX_PROJECT。本机要有 Node.js / npx。这是本地 MCP Toolbox 预置服务，不要 mcp login，也不要再 mcp add dataplex 叠一张。会话里 /mcp 或 codex mcp list 应看到 dataplex。插件已经登记时，不要手写 Cursor 那种 ./PATH/TO/toolbox --prebuilt dataplex JSON，也不要把托管端 https://dataplex.googleapis.com/mcp 抄成这条主路径。

0.154 起先看当前会话；当前会话 /plugins 或 /mcp 没有再新开。桌面改 marketplace.json 仍要重启应用。IDE 扩展没有 /plugins。CLI 装好的插件，Codex 桌面也能用。网页 Cloud 不读本机 marketplace。改完用 codex plugin marketplace list 核对清单名是 data-agent-kit。升级用清单名，不是仓库路径：

codex plugin marketplace upgrade data-agent-kit

这份发行还是 Beta（pre-v1.0）：技能名、工具集和目录布局可能改。marketplace 条目可能钉旧 ref，升级后再 plugin add。保持工具调用审批，并按需启用插件。

改完用 codex plugin list 核对 knowledge-catalog@data-agent-kit；用户层对照 codex mcp get dataplex 看传输是 stdio。