---
title: "安装 Google Cloud Bigtable 技能插件"
summary: "从 Data Agent Kit 安装 bigtable@data-agent-kit。插件提供技能，通过 gcloud 和 cbt 操作 Bigtable，不会自动登记 MCP 服务。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Bigtable", "skills", "Google Cloud", "data-agent-kit", "cloud-bigtable-ecosystem"]
canonical: /tips/bigtable-codex-plugin/
---

# 安装 Google Cloud Bigtable 技能插件

从 Data Agent Kit 安装 bigtable@data-agent-kit。插件提供技能，通过 gcloud 和 cbt 操作 Bigtable，不会自动登记 MCP 服务。

从 Data Agent Kit 安装 bigtable@data-agent-kit。插件提供技能，通过 gcloud 和 cbt 操作 Bigtable，不会自动登记 MCP 服务。

这是 [Data Agent Kit](https://github.com/GoogleCloudPlatform/data-agent-kit) 产品表里的 Bigtable 行，指向 [GoogleCloudPlatform/cloud-bigtable-ecosystem](https://github.com/GoogleCloudPlatform/cloud-bigtable-ecosystem)。不是 Claude 的 `/plugin marketplace add GoogleCloudPlatform/cloud-bigtable-ecosystem`，不是 `gemini extensions install https://github.com/GoogleCloudPlatform/cloud-bigtable-ecosystem`，也不是源仓 README Codex 节那套 `git clone` 再开 `/plugins` 浏览器。官方 Codex 主路径仍是 DAK 的 `plugin add`。

要 Codex **v0.117.0+**。本机要有 `gcloud` 和 `cbt`（控制面 / 数据面），再准备 ADC：

```bash
gcloud auth application-default login
# 技能走 CLI，不是插件环境变量：不要 export BIGTABLE_PROJECT
```

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 是 `bigtable`，source 钉 `cloud-bigtable-ecosystem.git` ref `v0.4.0`。源仓 `.codex-plugin/plugin.json` 是 `0.0.1`，只声明 `skills: "./skills/"`：**没有** `mcpServers`，**没有** `.codex-plugin/.mcp.json`。

```bash
codex --version
codex plugin marketplace add GoogleCloudPlatform/data-agent-kit
codex plugin add bigtable@data-agent-kit
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

`plugin list` 应看到 `bigtable@data-agent-kit`。`mcp list` **不会**因为这条插件多出一张 Bigtable 表：plugin.json 未声明 MCP。仓根 `.mcp.json` 里那条远程 `https://bigtableadmin.googleapis.com/mcp` 是给其他客户端使用的，**不要**发明 `codex mcp add bigtable --url https://bigtableadmin.googleapis.com/mcp`。也不要 `codex mcp login bigtable`。

技能 [skills/bigtable](https://github.com/GoogleCloudPlatform/cloud-bigtable-ecosystem/tree/v0.4.0/skills/bigtable) 分为控制面和数据面：`gcloud` 管实例 / 集群 / 备份 / IAM / 建表和视图；`cbt` 管列族、读写和 GC。SQL API 只读，DDL 走 CLI。非模拟器改库前要先确认。技能文档里的 `${BIGTABLE_PROJECT}` / `${BIGTABLE_INSTANCE}` 是 gcloud 示例变量，**不是** `plugin add` 的必填 env，


- 本地模拟器才用 `BIGTABLE_EMULATOR_HOST=localhost:8086`。那是 gcloud / cbt 的模拟器开关，不是插件安装步骤。模拟器还不支持 GoogleSQL。

可选：`codex plugin marketplace upgrade data-agent-kit` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins`；没有再新开。连接失败先看 ADC、`gcloud` / `cbt` 是否在 PATH，以及当前项目 / 实例参数是不是你在对话里给的。发行仍是 Beta（pre-v1.0）。保持工具调用审批。

## 来源

- [GoogleCloudPlatform/cloud-bigtable-ecosystem](https://github.com/GoogleCloudPlatform/cloud-bigtable-ecosystem)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [cloud-bigtable-ecosystem · skills/bigtable](https://github.com/GoogleCloudPlatform/cloud-bigtable-ecosystem/tree/v0.4.0/skills/bigtable)