---
title: "安装 Google Cloud Knowledge Catalog 插件"
summary: "从 Data Agent Kit 安装 knowledge-catalog@data-agent-kit。配置 DATAPLEX_PROJECT 和 ADC 凭证后，通过本地 dataplex MCP 查询目录。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Google Cloud", "MCP", "Knowledge Catalog", "Dataplex"]
canonical: /tips/knowledge-catalog-codex-plugin/
---

# 安装 Google Cloud Knowledge Catalog 插件

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

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

```bash
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 文档](https://docs.cloud.google.com/dataplex/docs/pre-built-tools-with-mcp-toolbox) 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：

```bash
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`。升级用清单名，不是仓库路径：

```bash
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。

## 来源

- [gemini-cli-extensions/knowledge-catalog](https://github.com/gemini-cli-extensions/knowledge-catalog)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [Google Cloud · Use Knowledge Catalog with MCP](https://docs.cloud.google.com/dataplex/docs/pre-built-tools-with-mcp-toolbox)