Looker 代管的 MCP 伺服器

Looker 代管的 MCP 伺服器是內建整合功能，可將 Model Context Protocol (MCP) 伺服器直接嵌入 Looker 平台。AI 代理 (例如 Gemini CLI、Claude Desktop、Cursor 和 Copilot) 可透過這項功能，安全地連至 Looker 執行個體，並與業務資料和 LookML 模型互動。

Looker 會託管伺服器，因此您不必部署及維護自己的中介軟體基礎架構，就能享有隨插即用、安全且受控管的閘道，取得可靠的業務洞察資料。

如果您使用客戶託管的執行個體，或偏好自行管理基礎架構，可以使用獨立的 MCP Toolbox for Databases 建立連線。MCP Toolbox 是開放原始碼 MCP 伺服器，可在本機電腦或自有伺服器上執行，做為 AI 代理和 Looker 執行個體之間的橋梁。詳情請參閱「搭配使用 Looker 與 MCP、Gemini CLI 和其他代理」說明文件頁面。

事前準備

如要使用 Looker 代管的 MCP 伺服器，必須符合下列條件：

執行個體需求

• 您必須使用 Looker (Google Cloud Core) 或 Looker (原始) 執行個體。
• 執行個體必須由 Looker 代管。

所需權限

• 管理工具存取權：必須具備管理員 Looker 角色。
• 如要註冊或啟用 AI 代理做為 OAuth 用戶端：您必須具備管理員 Looker 角色。
• 將 AI 代理連結至 Looker 代管的 MCP 伺服器：您需要使用標準 Looker 登入憑證，在 OAuth 連線程序中進行驗證。AI 代理必須先由 Looker 管理員註冊為 OAuth 用戶端。連結後，AI 代理會沿用已驗證使用者的 Looker 角色和存取權。

設定代管 MCP 伺服器

設定工具存取權，以便設定代管 MCP 伺服器。

調整工具設定

根據預設，受管理 MCP 伺服器的所有工具都會停用。Looker 管理員必須明確啟用 AI 代理可使用的工具。如要瞭解如何啟用工具，請參閱「管理員設定 - Model Context Protocol (MCP)」說明文件頁面。

調整 CORS 設定

如果 MCP 用戶端直接在網路瀏覽器中執行，且想使用 CORS 與 Looker 代管的 MCP 伺服器通訊，Looker 管理員必須將該用戶端網站的網域，新增至管理面板中的嵌入網域許可清單。

透過 OAuth 註冊 AI 代理

如要將 AI 代理連至 Looker 代管的 MCP 伺服器，管理員必須在 Looker「管理」面板的「管理 OAuth 用戶端」頁面，啟用或註冊 AI 代理做為 OAuth 用戶端應用程式。

您可以從「應用程式庫」啟用預先設定的 AI 用戶端，或在「自訂用戶端」分頁註冊自訂用戶端：

• 應用程式庫 (建議)：使用預先設定、由 Looker 管理的 OAuth 用戶端註冊，適用於熱門 AI 代理和開發人員工具，例如 Cursor、VS Code、Claude Code、Claude Desktop、ChatGPT、Gemini CLI、Cline、Windsurf、Antigravity 和 Looker Extension for VS Code。
• 自訂用戶端：如果應用程式庫中沒有您的 AI 工具，或您需要設定自訂重新導向 URI 或通訊埠，請註冊新的自訂 OAuth 用戶端。

方法 1：從應用程式庫啟用預先設定的 AI 代理

建議您先查看「應用程式庫」分頁。

如要啟用預先設定的 AI 代理用戶端，請按照下列步驟操作：

1. 在 Looker 的「管理」面板中，前往「驗證」部分，然後選取「管理 OAuth 用戶端」。
2. 選取「Application Library」分頁標籤。
3. 找出 AI 代理的用戶端應用程式 (例如 Cursor、Claude Code、Cline 或 Gemini CLI)。您可以使用搜尋列，依名稱篩選。
4. 將「啟用」切換鈕設為「開啟」。
5. 複製用戶端資料列中顯示的用戶端 ID。設定 AI 代理的 MCP 設定時 (例如在 mcp.json 或啟動旗標中)，您需要提供這個用戶端 ID。如果沒有 Looker 管理員角色的 Looker 使用者需要使用這個用戶端，請將用戶端 ID 分配給他們。

重新導向 URI 和動態通訊埠處理

Looker 要求 OAuth 重新導向 URI 必須與註冊值完全相符，且不支援萬用字元重新導向 URI。部分 AI 工具在啟動 OAuth 回呼時，預設會使用動態或臨時本機通訊埠 (例如 Claude Code 或 Cline)。為支援這些工具，Looker 會為每個程式庫用戶端預先註冊固定的預設通訊埠 (例如 Claude Code 和 Cline 的通訊埠 8080，或 Gemini CLI 的通訊埠 7777)。

如要使用預先設定的程式庫用戶端搭配動態通訊埠，請選擇下列其中一個選項：

• 設定用戶端使用預先註冊的靜態通訊埠：在工具的設定或啟動指令中，指定預先註冊的通訊埠。例如：
  • Claude Code：使用 --callback-port 8080 旗標執行 Claude Code (或在 mcp.json 中設定 "callbackPort": 8080)。
  • Cline：將 OAuth 回呼通訊埠設為 8080。
  • Gemini CLI：設定環境變數 export OAUTH_CALLBACK_PORT=7777。
  • VS Code：使用預先註冊的靜態 URI http://127.0.0.1:33418/。
• 註冊自訂用戶端：如要使用其他通訊埠或自訂回呼網址，請按照下一節的說明，使用偏好的重新導向 URI 註冊自訂用戶端。

方法 2：註冊自訂 AI 代理用戶端

如果應用程式庫未列出您的 AI 代理，或您需要使用自訂回呼網址或通訊埠，請按照管理員設定 - 管理 OAuth 用戶端說明文件中的步驟註冊自訂用戶端。新增用戶端後，請複製「用戶端 ID」，以便在設定 MCP 用戶端時使用。

程式輔助註冊 (API Explorer 或 API)

如果是自動化部署作業 (例如 CI/CD 管道或佈建指令碼)，Looker 管理員可以透過程式輔助方式註冊 OAuth 用戶端。

curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
-H "Authorization: token ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "redirect_uri": "REDIRECT_URI",
  "display_name": "CLIENT_NAME",
  "description": "OAuth client to access MCP server using CLIENT_NAME",
  "enabled": true
}'

設定 MCP 用戶端

註冊 AI 代理後，即可將其連結至代管 MCP 端點，做為 MCP 用戶端。請參閱代理程式說明文件，完成用戶端設定。

• 伺服器網址： LOOKER_INSTANCE_URL/mcp
• 驗證：OAuth 2.1

設定範例 (mcp.json)

本節說明如何設定各種開發人員工具，使用 Looker 代管的 MCP 伺服器連線至 Looker 執行個體。MCP 伺服器位於 IDE 和 Looker 之間，為 AI 工具提供安全高效的控制層。選取特定工具的分頁標籤，即可查看設定操作說明。

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp",
            "oauth": {
              "clientId": "CLIENT_GUID",
              "callbackPort": 8080
            }
          }
        }
      }
  

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }
  

      {
        "mcpServers": {
          "looker": {
            "url": "LOOKER_INSTANCE_URL/mcp",
            auth: {
              "CLIENT_ID": "CLIENT_GUID"
            }
          }
        }
      }
  

      {
        "servers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }
  

      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "LOOKER_INSTANCE_URL/mcp"
          }
        }
      }
  

使用用戶端進行驗證

使用 mcp.json 設定完成 MCP 用戶端設定後，當您首次嘗試透過該用戶端與 Looker 互動時，系統會啟動 OAuth 2.1 驗證流程。這通常需要用戶端開啟瀏覽器視窗，您必須使用標準憑證登入 Looker 執行個體，並授予應用程式權限，允許其代表您存取 Looker。

這個登入程序是互動式驗證步驟，可讓 MCP 用戶端取得存取權杖，以便日後提出要求。

詳情請參閱用戶端說明文件。

連結後，客戶會沿用您的 Looker 角色和內容存取權。用戶端也能存取 Looker 管理員為 MCP 伺服器啟用的 AI 工具。如需所有可能工具的清單，請參閱「使用 AI 工具」說明文件。

安全性與管理

代管 MCP 伺服器會沿用 Looker 現有的安全性和管理架構。

• 權限界限：伺服器會強制執行嚴格的使用者層級權限。AI 代理無法存取已驗證使用者無權查看的資料或模型。
• VPC Service Controls：如果 Looker (Google Cloud Core) 執行個體使用 VPC Service Controls，代管 MCP 端點會遵循現有的 VPC Service Controls 邊界，不需額外設定或政策。
• 客戶自行管理的加密金鑰 (CMEK)：如果 Looker (Google Cloud Core) 執行個體使用 CMEK，代管 MCP 伺服器會符合 CMEK 規範，不需額外設定或套用政策。
• IP 許可清單：如果執行個體在 Looker (Google Cloud Core) 或 Looker (原始版) 中使用 IP 許可清單，代管 MCP 端點會遵循現有的 IP 許可清單規則，不需額外設定。

稽核記錄

AI 代理執行的每項動作都會記錄在 Looker 系統活動和 Cloud 稽核記錄中。

系統活動

Looker 代管的 MCP 伺服器活動會記錄在「歷史記錄」和「事件屬性」探索中。使用系統活動探索功能監控 Looker 用量說明文件頁面提供下列查詢範例：

• Looker 代管的 MCP 伺服器啟動了哪些 API 呼叫？
• 哪些事件與 Looker 代管 MCP 伺服器的要求有關？
• Looker 管理員對 Looker 代管的 MCP 伺服器工具設定做了哪些更新？
• Looker 代管 MCP 伺服器的使用者執行過哪些查詢？

Cloud 稽核記錄

Looker (Google Cloud Core) 執行個體也會透過 Cloud 稽核記錄，追蹤 Looker 代管的 MCP 伺服器活動。Looker (Google Cloud Core) 稽核記錄說明文件頁面提供查詢範例。

限制

• 精細範圍：代管 MCP 伺服器尚不支援 OAuth 範圍。存取控管機制取決於全域工具許可清單和使用者的基本權限。
• 動態註冊：預先發布版不支援 Dynamic Client Registration。
• 用戶端重新整理：工具許可清單的變更不會自動推送至已連結的用戶端。使用者必須在變更工具清單後等待 30 秒，然後重新連線用戶端，才能重新整理工具資訊清單。如要瞭解如何重新連線至 MCP 伺服器，請參閱用戶端說明文件。
• 伺服器容量：在預先發布版階段，代管 MCP 伺服器會設定固定容量，協助我們收集成效資料。在用量高峰期，您可能會偶爾遇到逾時問題。請放心，這是正常情況。

定價與配額

Looker 代管的 MCP 伺服器無須額外付費。不過，AI 代理執行的工具呼叫會耗用執行個體的標準管理和查詢 API 配額。代理活動頻繁可能會影響可用的 API 配額。