---
title: "安装 Looker Conversational Analytics 插件"
summary: "安装 looker-conversational-analytics@looker-conversational-analytics，配置 Looker 客户端凭证、ADC、LOOKER_PROJECT 和 LOOKER_LOCATION，使用自然语言分析数据。"
category: skills
level: intermediate
surfaces: [cli, app]
tags: ["plugins", "Looker", "MCP", "LOOKER_LOCATION", "looker-conversational-analytics@looker-conversational-analytics"]
canonical: /tips/looker-ca-codex-plugin/
---

# 安装 Looker Conversational Analytics 插件

安装 looker-conversational-analytics@looker-conversational-analytics，配置 Looker 客户端凭证、ADC、LOOKER_PROJECT 和 LOOKER_LOCATION，使用自然语言分析数据。

安装 looker-conversational-analytics@looker-conversational-analytics，配置 Looker 客户端凭证、ADC、LOOKER_PROJECT 和 LOOKER_LOCATION，使用自然语言分析数据。

这是 [gemini-cli-extensions/looker-conversational-analytics](https://github.com/gemini-cli-extensions/looker-conversational-analytics) 的 Codex 专节。插件把 MCP Toolbox 的预置 `looker-conversational-analytics` 封装为插件，用 Looker API 客户端密钥加上 GCP Conversational Analytics API，去列 LookML 模型 / Explore，再用 `ask_data_insights` 问数。认证是 Looker 客户端密钥 **加上** ADC，不是只靠库用户。

要 Codex **v0.150.0+**，本机有 Node / npx。先开 Conversational Analytics 相关 API，IAM 至少 `roles/looker.instanceUser`、`roles/cloudaicompanion.user`、`roles/geminidataanalytics.dataAgentStatelessUser`，再准备 ADC 和 Looker 客户端：

```bash
gcloud auth application-default login
gcloud services enable geminidataanalytics.googleapis.com cloudaicompanion.googleapis.com --project=YOUR_LOOKER_PROJECT
export LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
export LOOKER_CLIENT_ID=YOUR_LOOKER_CLIENT_ID
export LOOKER_CLIENT_SECRET=YOUR_LOOKER_CLIENT_SECRET
export LOOKER_PROJECT=YOUR_LOOKER_PROJECT
export LOOKER_LOCATION=YOUR_LOOKER_LOCATION
# 可选：LOOKER_VERIFY_SSL（默认 true）、LOOKER_SHOW_HIDDEN_MODELS / EXPLORES / FIELDS
```

不要把 Client Secret 写进 `http_headers`。该 stdio 服务 **不要** `mcp login`。`LOOKER_LOCATION` 在 Toolbox 源里默认是 `us`，仍应显式导出，插件不会自动填写。

清单 `.claude-plugin/marketplace.json` 的 name 是 `looker-conversational-analytics`，插件 name 也是 `looker-conversational-analytics`（`plugin.json` 0.3.8）。Toolbox 预置是 `looker-conversational-analytics`，MCP 表名却是 `looker`：

```bash
codex --version
codex plugin marketplace add gemini-cli-extensions/looker-conversational-analytics
codex plugin add looker-conversational-analytics@looker-conversational-analytics
codex plugin list
codex mcp list
```

IDE 扩展没有 `/plugins`。

插件会登记一台 **stdio** MCP，表名是 `looker`。command 是 `npx`，args 指定 `@toolbox-sdk/server@1.9.0 --prebuilt looker-conversational-analytics --stdio`。**不要** `codex mcp login looker`。插件已经带 MCP 时，不要再 `codex mcp add looker -- npx @toolbox-sdk/server` 叠一张用户层表。已经装了 `looker@data-agent-kit` 时，那份插件也占用表名 `looker`（外加 `looker-dev`），不要两台叠一张。


可选：`codex plugin marketplace upgrade looker-conversational-analytics` 后再 `plugin add` 一次。0.154 起先看当前会话的 `/plugins` 和 `/mcp`；没有再新开。`codex mcp list` 里应有 `looker`。连接失败先看 `LOOKER_PROJECT` / `LOOKER_LOCATION` / `LOOKER_CLIENT_ID` 是不是进了同一进程，ADC 是否有效，以及 npx 能不能拉到 Toolbox 1.9.0。发行仍是 Beta（pre-v1.0）。`ask_data_insights` 会打 Conversational Analytics API，保持工具调用审批。

## 来源

- [gemini-cli-extensions/looker-conversational-analytics](https://github.com/gemini-cli-extensions/looker-conversational-analytics)
- [MCP Toolbox · Looker Conversational Analytics prebuilt](https://mcp-toolbox.dev/integrations/looker/prebuilt-configs/looker-conversational-analytics/)
- [MCP Toolbox · looker-conversational-analytics tool](https://mcp-toolbox.dev/integrations/looker/tools/looker-conversational-analytics/)