---
title: "安装 Google Cloud Storage 插件"
summary: "从 gemini-cli-extensions/google-cloud-storage 安装 google-cloud-storage@google-cloud-storage，配置 ADC 和 CLOUD_STORAGE_PROJECT，访问存储桶与对象。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Cloud Storage", "GCS", "MCP", "Google Cloud"]
canonical: /tips/gcs-codex-plugin/
---

# 安装 Google Cloud Storage 插件

从 gemini-cli-extensions/google-cloud-storage 安装 google-cloud-storage@google-cloud-storage，配置 ADC 和 CLOUD_STORAGE_PROJECT，访问存储桶与对象。

从 gemini-cli-extensions/google-cloud-storage 安装 google-cloud-storage@google-cloud-storage，配置 ADC 和 CLOUD_STORAGE_PROJECT，访问存储桶与对象。

这是 [gemini-cli-extensions/google-cloud-storage](https://github.com/gemini-cli-extensions/google-cloud-storage) 的 Codex 专节。插件把 MCP Toolbox 的预置 `cloud-storage` 封装为插件，并带一套 GCS 技能，用 ADC 连项目里的桶和对象。

本机要有 Node / npx，现行 Codex 能跑 `plugin marketplace add`。先开 Cloud Storage API，IAM 至少 `roles/storage.objectViewer`（改对象再加 `roles/storage.objectAdmin`，管桶再加 `roles/storage.admin`），再准备 ADC：

```bash
gcloud auth application-default login
# 可选：gcloud auth login（只给本机 gcloud CLI 用）
export CLOUD_STORAGE_PROJECT=YOUR_CLOUD_STORAGE_PROJECT
```

不要把密钥写进 `http_headers`。ADC 是这条本机 stdio 的认证，**不要** `mcp login`。

清单名是 `google-cloud-storage`，插件 name 是 `google-cloud-storage`（`plugin.json` 1.1.0）。MCP 表名和 Toolbox 预置都是 `cloud-storage`：

```bash
codex plugin marketplace add gemini-cli-extensions/google-cloud-storage
codex plugin add google-cloud-storage@google-cloud-storage
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

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


可选：`codex plugin marketplace upgrade google-cloud-storage` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `cloud-storage`。连接失败先看 ADC、`CLOUD_STORAGE_PROJECT` 是不是进了同一进程，以及 npx 能不能拉到 Toolbox 1.9.0。`delete_bucket` / `delete_object` / `move_object` / `write_object` / `upload_object` 会改数据，保持工具调用审批。

## 来源

- [gemini-cli-extensions/google-cloud-storage](https://github.com/gemini-cli-extensions/google-cloud-storage)
- [MCP Toolbox · Cloud Storage prebuilt](https://mcp-toolbox.dev/integrations/cloud-storage/prebuilt-configs/cloud-storage/)
- [Google Cloud · Use the Cloud Storage MCP server](https://docs.cloud.google.com/storage/docs/use-cloud-storage-mcp)