Эта страница переведена с помощью Cloud Translation API.

Подключите Gemini CLI к Looker с помощью MCP Toolbox.

1. Перед началом работы

Вам потребуется доступ к работающему экземпляру Looker. Вам также понадобятся идентификатор клиента API (client_id) и секретный ключ клиента (client_secret).

Предварительные требования

Необходимо иметь запущенный экземпляр Looker.
Необходимо иметь доступ к командной строке Linux или macOS.

Что вы узнаете

Как установить Gemini CLI
Как установить MCP Toolbox
Как подключить Gemini CLI к Looker с помощью MCP Toolbox

Что вам понадобится

URL-адрес API-сервера Looker. Обычно он совпадает с URL-адресом Looker, но может потребоваться добавить номер порта, например :19999 , например: https://looker.example.com:19999 . Если что-то не работает должным образом, обратитесь к администратору Looker.

2. Подготовка

Вам необходимо получить client_id и client_secret.

Войдите в свою учетную запись Looker и щелкните профиль пользователя в правом верхнем углу экрана. Выберите «Учетная запись» . На экране «Учетная запись» рядом с надписью API Keys нажмите кнопку Manage .

На странице управления ключами API нажмите кнопку Create New API Key .

В созданной записи добавьте назначение MCP Toolbox или что-то подобное и поставьте галочку, чтобы сохранить. Затем скопируйте и вставьте client_id и client_secret в надежное место. Вам потребуется нажать на значок глаза рядом с секретом, чтобы увидеть и скопировать его.

Теперь вы можете закрыть окна браузера Looker.

3. Установите Gemini CLI.

Откройте приложение «Терминал», чтобы получить доступ к командной строке macOS или Linux.

Выполните следующую команду:

npm install -g @google/gemini-cli

Если по какой-либо причине это не сработает, обратитесь к https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation для получения информации о вариантах установки или помощи.

Теперь запустите Gemini CLI с помощью этой команды:

gemini

Вам будет предложено войти в систему. Следуйте этим инструкциям, и всё будет готово.

4. Установите MCP Toolbox.

Создать каталог MCP Toolbox

В терминале создайте директорию mcp-toolbox . Затем перейдите в эту директорию:

mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox

Определите архитектуру системы.

Выполните команду uname , чтобы узнать, какую операционную систему вы используете:

uname -a

Эта команда вернет строку, которая будет выглядеть примерно так:

Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux

Обратите особое внимание на конец этой строки. Если вы используете Linux, она будет заканчиваться на x86_64 GNU/Linux . Для macOS в конце строки будет указано Darwin и либо arm64 для процессора Apple, либо x86_64 i386 для процессора Intel.

Скачать MCP Toolbox

Если у вас установлена операционная система Linux, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox

Если у вас установлена macOS с процессором Apple, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox

Если у вас установлена macOS с процессором Intel, выполните следующую команду для загрузки MCP Toolbox:

curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox

Сделайте MCP Toolbox исполняемым файлом.

Чтобы сделать программу MCP Toolbox исполняемой, выполните следующую команду:

chmod +x toolbox

Получите полный путь к панели инструментов.

Чтобы получить полный путь к файлу панели инструментов, выполните следующую команду:

echo $HOME/mcp-toolbox/toolbox

В результате, вероятно, получится что-то подобное:

/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox

Сохраните результат в удобном месте.

5. Настройка Gemini CLI

Отредактируйте файл $HOME/.gemini/settings.json . Используйте свой любимый текстовый редактор. Если вы нечасто редактируете файлы в Linux или macOS, nano — хороший выбор.

Добавьте в JSON-файл следующий фрагмент:

  "mcpServers": {
    "looker": {
      "command": "FULL_PATH_TO_TOOLBOX",
      "args": [
        "--stdio",
        "--prebuilt",
        "looker"
      ],
      "env": {
        "LOOKER_BASE_URL": "URL_OF_LOOKER_INSTANCE",
        "LOOKER_CLIENT_ID": "CLIENT_ID",
        "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
        "LOOKER_VERIFY_SSL": "true"
      }
    }
  }

Замените значения полей FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID и CLIENT_SECRET на те, которые вы сохранили на предыдущих шагах. Сохраните отредактированный файл.

6. Используйте MCP Toolbox с Gemini CLI.

Запустите Gemini CLI, введя gemini в командной строке.

Чтобы получить список доступных инструментов, введите следующее в командной строке Gemini:

/mcp list looker

В результате должно получиться примерно так:

Configured MCP servers:

🟢 looker - Ready (33 tools)
  Tools:
  - add_dashboard_element
  - add_dashboard_filter
  - create_project_file
  - delete_project_file
  - dev_mode
  - generate_embed_url
  - get_connection_databases
  - get_connection_schemas
  - get_connection_table_columns
  - get_connection_tables
  - get_connections
  - get_dashboards
  - get_dimensions
  - get_explores
  - get_filters
  - get_looks
  - get_measures
  - get_models
  - get_parameters
  - get_project_file
  - get_project_files
  - get_projects
  - health_analyze
  - health_pulse
  - health_vacuum
  - make_dashboard
  - make_look
  - query
  - query_sql
  - query_url
  - run_dashboard
  - run_look
  - update_project_file

Теперь начните запрашивать у Gemini CLI информацию о доступных данных. Попробуйте выполнить одно из следующих действий:

Какие модели доступны в Looker?
Какие инструменты исследования доступны в MODEL_NAME ?
Какие показатели и параметры доступны в EXPLORE_NAME ?

Подставьте свои собственные значения для MODEL_NAME и EXPLORE_NAME .

Далее попробуйте составить несколько запросов на естественном языке, на которые можно ответить, используя данные из вашего экземпляра Looker: «Каков мой общий доход за 2025 год?», «Сколько виджетов я продал в 4 квартале?» и т. д.

7. Еще несколько подсказок для проверки.

Вы также можете попробовать запустить сохраненные Look-модели и панели мониторинга, создать новые Look-модели и панели мониторинга, и даже отредактировать модели LookML.

Запустите сохраненный запрос, введя команду, например, "Запустить запрос 'Monthly Inventory'". Gemini должен найти запрос с именем 'Monthly Inventory', затем выполнить соответствующий запрос и предоставить результаты.
Запустите панель мониторинга, введя запрос, например, "Свести данные с панели мониторинга 'отслеживание клиентов'". Gemini должен найти панель мониторинга с именем 'отслеживание клиентов', выполнить запросы, связанные с каждым элементом, и предоставить сводную информацию.
Чтобы создать сохраненный образ, попробуйте ввести запрос типа: «Создайте образ для отслеживания ежемесячной выручки с разбивкой по категориям товаров. Отобразите данные в виде столбчатой диаграммы с накоплением».
Чтобы создать информационную панель, попробуйте ввести запрос, например: «Создайте мне информационную панель мониторинга продаж на 2026 год».

Если вы являетесь разработчиком LookML, вы можете модифицировать LookML с помощью Gemini. Поэкспериментируйте с такими подсказками:

Запросите у Gemini список проектов LookML, используя команду "Какие проекты LookML доступны?".
Запросите у Gemini список файлов проекта. Введите вопрос: «Какие файлы доступны в проекте PROJECT_NAME ?». Подставьте название своего проекта.
Предложите Gemini добавить меру. "Создайте меру для усреднения значения поля sales_price в представлении VIEW_NAME ." Подставьте собственное имя представления.
Чтобы получить список подключений, используйте запрос "Какие подключения доступны в Looker?".
Получите связанные схемы. "Какие схемы содержатся в CONNECTION_NAME ?" Подставьте собственное имя подключения.
Получите связанные таблицы. "Какие таблицы находятся в CONNECTION_NAME в схеме SCHEMA_NAME ?" Подставьте свои собственные имена подключения и схемы.
Получите список столбцов таблицы. "Какие столбцы содержатся в таблице TABLE_NAME ?" Подставьте имя своей таблицы.
Теперь попросите Gemini добавить столбец в представление LookML. "Создайте измерение для столбца COLUMN_NAME ." Подставьте собственное имя столбца.

Используйте пользовательский интерфейс Looker для тестирования изменений и, возможно, для их фиксации. Инструменты Gemini и MCP не позволяют фиксировать изменения LookML и отправлять их в рабочую среду.