安装 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 的 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.instanceUserroles/cloudaicompanion.userroles/geminidataanalytics.dataAgentStatelessUser,再准备 ADC 和 Looker 客户端:

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 loginLOOKER_LOCATION 在 Toolbox 源里默认是 us,仍应显式导出,插件不会自动填写。

清单 .claude-plugin/marketplace.json 的 name 是 looker-conversational-analytics,插件 name 也是 looker-conversational-analyticsplugin.json 0.3.8)。Toolbox 预置是 looker-conversational-analytics,MCP 表名却是 looker

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,保持工具调用审批。

来源