---
title: "安装 Google Cloud Looker 插件"
summary: "安装 looker@data-agent-kit，通过 Looker API 客户端凭证连接实例。插件提供 looker 和 looker-dev 两个本地 MCP 服务。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Looker", "MCP", "Google Cloud", "data-agent-kit"]
canonical: /tips/looker-codex-plugin/
---

# 安装 Google Cloud Looker 插件

安装 looker@data-agent-kit，通过 Looker API 客户端凭证连接实例。插件提供 looker 和 looker-dev 两个本地 MCP 服务。

安装 looker@data-agent-kit，通过 Looker API 客户端凭证连接实例。插件提供 looker 和 looker-dev 两个本地 MCP 服务。

这是 [gemini-cli-extensions/looker](https://github.com/gemini-cli-extensions/looker) 的 Codex 专节。插件把 MCP Toolbox 的预置 `looker` / `looker-dev` 打成 Agent Plugin，用 Looker API 客户端密钥连你的实例，用于查询数据、管理仪表板和编辑 LookML。

要 Codex **v0.117.0+**，本机有 Node / npx。先准备 Looker 实例和 API 客户端：

```bash
export LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
export LOOKER_CLIENT_ID=YOUR_LOOKER_CLIENT_ID
export LOOKER_CLIENT_SECRET=YOUR_LOOKER_CLIENT_SECRET
# 可选：LOOKER_VERIFY_SSL、LOOKER_SHOW_HIDDEN_MODELS、LOOKER_SHOW_HIDDEN_EXPLORES、LOOKER_SHOW_HIDDEN_FIELDS
```

`LOOKER_BASE_URL` 是实例主机，不是 `LOOKER_INSTANCE_URL/mcp` 那条托管 MCP。密钥写进启动 Codex 的进程环境；插件 `.mcp.json` 用 `env_vars` 转发，不要把 Client Secret 写进 `http_headers`。

清单 `.agents/plugins/marketplace.json` 的 name 是 `data-agent-kit`，插件 name 是 `looker`：

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

IDE 扩展没有 `/plugins`。

插件会登记两台 **stdio** MCP：`looker`（查数、看板）和 `looker-dev`（LookML 开发）。command 是 `npx`，args 指定 `@toolbox-sdk/server@1.9.0 --prebuilt looker|looker-dev --stdio`。**不要** `codex mcp login looker`。插件已经带 MCP 时，不要再 `codex mcp add looker -- npx @toolbox-sdk/server` 叠一张用户层表。


可选：`codex plugin marketplace upgrade data-agent-kit` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `looker` 和 `looker-dev`。连接失败先看这三个环境变量是不是进了同一进程，以及 npx 能不能拉到 Toolbox。

## 来源

- [gemini-cli-extensions/looker](https://github.com/gemini-cli-extensions/looker)
- [GoogleCloudPlatform/data-agent-kit](https://github.com/GoogleCloudPlatform/data-agent-kit)
- [Google Cloud · Use Looker with MCP](https://docs.cloud.google.com/looker/docs/connect-ide-to-looker-using-mcp-toolbox)