1. Trước khi bắt đầu
Bạn phải có quyền truy cập vào một thực thể Looker đang chạy. Bạn sẽ cần có client_id và client_secret của API.
Điều kiện tiên quyết
- Có một phiên bản Looker đang chạy
- Có quyền truy cập vào dòng lệnh Linux hoặc macOS
Kiến thức bạn sẽ học được
- Cách cài đặt Gemini CLI
- Cách cài đặt MCP Toolbox
- Cách kết nối Gemini CLI với Looker bằng Hộp công cụ MCP
Bạn cần có
- URL của máy chủ Looker API. URL này thường giống với URL Looker, nhưng bạn có thể phải thêm một số cổng như
:19999, ví dụ:https://looker.example.com:19999. Nếu mọi thứ không hoạt động đúng cách, hãy thử hỏi quản trị viên Looker.
2. Chuẩn bị
Bạn cần truy xuất client_id và client_secret.
Đăng nhập vào phiên bản Looker của bạn rồi nhấp vào hồ sơ người dùng ở góc trên cùng bên phải màn hình. Chọn Tài khoản. Trên màn hình Tài khoản, bên cạnh nhãn API Keys, hãy nhấn vào nút Manage.
Trên trang quản lý Khoá API, hãy nhấn vào nút Create New API Key.
Trong mục mới tạo, hãy thêm mục đích MCP Toolbox hoặc nội dung tương tự rồi nhấp vào dấu đánh dấu để lưu. Sau đó, hãy sao chép và dán client_id và client_secret vào một nơi an toàn. Bạn cần nhấn vào biểu tượng mắt bên cạnh khoá bí mật để xem và sao chép khoá đó.
Bây giờ, bạn có thể đóng cửa sổ trình duyệt Looker.
3. Cài đặt Gemini CLI
Mở ứng dụng dòng lệnh để chuyển đến dòng lệnh macOS hoặc Linux.
Chạy lệnh sau:
npm install -g @google/gemini-cli
Nếu vì lý do nào đó mà bạn không thể cài đặt, hãy tham khảo https://github.com/google-gemini/gemini-cli?tab=readme-ov-file#-installation để biết các lựa chọn cài đặt hoặc được trợ giúp.
Bây giờ, hãy chạy Gemini CLI bằng lệnh sau:
gemini
Bạn sẽ được yêu cầu đăng nhập. Hãy làm theo những hướng dẫn đó và bạn sẽ sẵn sàng.
4. Cài đặt Hộp công cụ MCP
Tạo thư mục Hộp công cụ MCP
Trong ứng dụng thiết bị đầu cuối, hãy tạo một thư mục mcp-toolbox. Sau đó, hãy nhập thư mục đó:
mkdir $HOME/mcp-toolbox
cd $HOME/mcp-toolbox
Xác định cấu trúc hệ thống
Chạy lệnh uname để tìm hiểu loại hệ thống bạn đang dùng:
uname -a
Lệnh này sẽ trả về một chuỗi có dạng như sau:
Linux hostname.example.com 6.16.12-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.16.12 (2025-11-10) x86_64 GNU/Linux
Hãy chú ý đến cuối dòng đó. Nếu bạn đang dùng Linux, tên tệp sẽ kết thúc bằng x86_64 GNU/Linux. Đối với macOS, thông tin này sẽ cho biết Darwin và arm64 cho bộ xử lý Apple hoặc x86_64 i386 cho bộ xử lý Intel ở gần cuối chuỗi đó.
Tải Hộp công cụ MCP xuống
Nếu bạn có Linux, hãy chạy lệnh sau để tải MCP Toolbox xuống:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/linux/amd64/toolbox
Nếu bạn có macOS với bộ xử lý Apple, hãy chạy lệnh sau để tải MCP Toolbox xuống:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/arm64/toolbox
Nếu bạn có macOS với bộ xử lý Intel, hãy chạy lệnh sau để tải MCP Toolbox xuống:
curl https://storage.googleapis.com/genai-toolbox/v0.26.0/darwin/amd64/toolbox
Tạo tệp thực thi MCP Toolbox
Chạy chương trình MCP Toolbox bằng cách chạy lệnh sau:
chmod +x toolbox
Lấy đường dẫn đầy đủ đến hộp công cụ
Lấy đường dẫn đầy đủ đến tệp hộp công cụ bằng cách chạy lệnh sau:
echo $HOME/mcp-toolbox/toolbox
Điều này có thể dẫn đến kết quả như sau:
/home-or-User/YOUR-USER-NAME/mcp-toolbox/toolbox
Lưu kết quả ở nơi thuận tiện.
5. Định cấu hình Gemini CLI
Chỉnh sửa tệp $HOME/.gemini/settings.json. Sử dụng trình chỉnh sửa văn bản mà bạn muốn. Nếu không thường xuyên chỉnh sửa tệp trong Linux hoặc macOS, thì nano là lựa chọn phù hợp.
Thêm khổ thơ sau vào tệp 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"
}
}
}
Thay thế thông tin bạn đã lưu ở các bước trước cho FULL_PATH_TO_TOOLBOX, URL_OF_LOOKER_INSTANCE, CLIENT_ID và CLIENT_SECRET. Lưu tệp đã chỉnh sửa.
6. Sử dụng Hộp công cụ MCP với Gemini CLI
Khởi động Gemini CLI bằng cách nhập gemini tại dòng lệnh.
Liệt kê các công cụ hiện có bằng cách nhập nội dung sau vào câu lệnh cho Gemini:
/mcp list looker
Bài kiểm thử của bạn sẽ có dạng như sau:
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
Bây giờ, hãy bắt đầu hỏi Gemini CLI về dữ liệu có sẵn. Hãy thử một số cách sau:
- Looker có những mô hình nào?
- Có những dữ liệu khám phá nào trong MODEL_NAME?
- Những chỉ số và phương diện nào có trong EXPLORE_NAME?
Thay thế bằng các giá trị của riêng bạn cho MODEL_NAME và EXPLORE_NAME.
Tiếp theo, hãy thử đưa ra một số câu hỏi bằng ngôn ngữ tự nhiên mà dữ liệu trong phiên bản Looker của bạn có thể trả lời: "Tổng doanh thu của tôi trong năm 2025 là bao nhiêu?" "Tôi đã bán được bao nhiêu tiện ích trong quý 4?", v.v.
7. Các câu lệnh khác bạn có thể thử
Bạn cũng có thể thử chạy các Look và bảng điều khiển đã lưu, tạo Look và bảng điều khiển, thậm chí chỉnh sửa các mô hình LookML.
- Chạy một Look đã lưu bằng cách nhập một câu lệnh như "Chạy Look "Kho hàng hằng tháng"." Gemini nên tìm kiếm một báo cáo có tên là "Kho hàng hằng tháng", sau đó chạy truy vấn liên quan và chia sẻ kết quả.
- Chạy trang tổng quan bằng cách đưa ra một câu lệnh như "Tóm tắt trang tổng quan "theo dõi khách hàng"." Gemini nên tìm kiếm một trang tổng quan có tên là "theo dõi khách hàng", chạy các cụm từ tìm kiếm liên kết với từng ô và đưa ra bản tóm tắt.
- Để tạo một Look đã lưu, hãy thử dùng câu lệnh như "Tạo một Look để theo dõi doanh thu hằng tháng của tôi theo từng danh mục sản phẩm. Hiển thị dữ liệu dưới dạng biểu đồ cột xếp chồng."
- Để tạo trang tổng quan, hãy thử một câu lệnh như "Xây dựng cho tôi một trang tổng quan về tình hình kinh doanh năm 2026".
Nếu là nhà phát triển LookML, bạn có thể sửa đổi LookML bằng Gemini. Thử nghiệm với các câu lệnh như sau:
- Đưa ra câu lệnh cho Gemini để nhận danh sách các dự án LookML bằng câu hỏi "Có những dự án LookML nào?"
- Đưa ra câu lệnh cho Gemini để truy xuất danh sách tệp dự án. "Có những tệp nào trong dự án PROJECT_NAME?" Thay thế bằng tên dự án của riêng bạn.
- Ra lệnh cho Gemini thêm một chỉ số. Tạo một thông tin đo lường để tính giá trị trung bình của trường sales_price trong chế độ xem VIEW_NAME. Thay thế bằng tên chế độ xem của riêng bạn.
- Truy xuất danh sách các kết nối bằng cách hỏi "Looker có những kết nối nào?"
- Lấy các lược đồ được liên kết. "What schemas are in CONNECTION_NAME?) Thay thế bằng tên mối kết nối của riêng bạn.
- Lấy các bảng được liên kết. "Những bảng nào có trong CONNECTION_NAME trong giản đồ SCHEMA_NAME?" Thay thế bằng tên mối kết nối và tên giản đồ của riêng bạn.
- Lấy các cột cho một bảng. "TABLE_NAME có những cột nào?" Thay thế bằng tên bảng của riêng bạn.
- Giờ đây, hãy yêu cầu Gemini thêm một cột vào chế độ xem LookML. "Tạo một phương diện cho cột COLUMN_NAME." Thay thế bằng tên cột của riêng bạn.
Sử dụng giao diện người dùng Looker để kiểm thử các thay đổi và có thể xác nhận các thay đổi đó. Gemini và MCP Toolbox không thể xác nhận các thay đổi về LookML và chuyển các thay đổi đó sang môi trường thực tế.