이 페이지는 Cloud Translation API를 통해 번역되었습니다.

MCP Toolbox를 사용하여 IDE를 Looker에 연결

이 페이지에서는 데이터베이스용 MCP 도구 상자를 사용하여 Looker 인스턴스를 모델 컨텍스트 프로토콜 (MCP)을 지원하는 통합 개발 환경 (IDE) 및 개발자 도구에 연결하는 방법을 보여줍니다. 이러한 도구를 사용하여 쿼리를 실행하고 Looker와 상호작용합니다. 이 가이드는 기존 IDE 및 개발자 도구를 사용하여 Looker를 사용하는 개발자를 대상으로 합니다.

MCP는 대규모 언어 모델 (LLM)을 Looker와 같은 데이터 소스에 연결하기 위한 개방형 프로토콜입니다. 이 페이지에서는 데이터베이스용 MCP 도구 상자를 사용하여 다음 IDE를 통해 개발자 지원 도구를 Looker 인스턴스에 노출하는 방법을 설명합니다.

Gemini CLI
Cursor
Windsurf(Codium)
Visual Studio Code(Copilot)
Cline(VS Code 확장 프로그램)
Claude desktop
Claude code

Looker 설정

Looker 클라이언트 ID와 클라이언트 보안 비밀번호를 가져옵니다. Looker API 인증 문서 페이지의 안내를 따르세요.
Looker 인스턴스의 기본 URL이 있어야 합니다. https://looker.example.com와 같은 형식일 가능성이 높습니다. API가 다른 포트에서 수신 대기하는 경우도 있으므로 이 경우에는 https://looker.example.com:19999를 사용해야 합니다.

MCP Toolbox 설치

MCP Toolbox의 최신 버전을 바이너리로 다운로드합니다. OS 및 CPU 아키텍처에 해당하는 바이너리를 선택합니다. MCP Toolbox 버전 V0.10.0 이상을 사용해야 합니다.

linux/amd64

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

darwin/arm64

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

darwin/amd64

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

windows/amd64

curl -O https://storage.googleapis.com/genai-toolbox/v0.12.0/windows/amd64/toolbox.exe

바이너리를 실행 파일로 만듭니다.
```
chmod +x toolbox
```
설치를 확인합니다.
```
./toolbox --version
```

MCP 클라이언트 구성

Gemini CLI

Gemini CLI를 설치합니다.
작업 디렉터리에 .gemini 폴더를 만듭니다. 해당 폴더 내에 settings.json 파일을 만듭니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Claude code

Claude Code를 설치합니다.
프로젝트 루트에 .mcp.json 파일이 없으면 만듭니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Claude Desktop

Claude Desktop을 열고 설정으로 이동합니다.
개발자 탭에서 구성 수정을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Claude Desktop을 다시 시작합니다.
새 채팅 화면에 새 MCP 서버와 함께 망치(MCP) 아이콘이 표시됩니다.

Cline

VS Code에서 Cline 확장 프로그램을 열고 MCP Servers 아이콘을 클릭합니다.
MCP 서버 구성을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

서버가 성공적으로 연결되면 녹색 활성 상태가 표시됩니다.

커서

프로젝트 루트에 .cursor 디렉터리가 없으면 만듭니다.
.cursor/mcp.json 파일이 없으면 만들고 엽니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

커서를 열고 설정 > 커서 설정 > MCP로 이동합니다. 서버가 연결되면 녹색 활성 상태가 표시됩니다.

Visual Studio Code(Copilot)

VS Code를 열고 프로젝트 루트에 .vscode 디렉터리가 없으면 만듭니다.
.vscode/mcp.json 파일이 없으면 만들고 엽니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

Windsurf

Windsurf를 열고 Cascade 어시스턴트로 이동합니다.
MCP 아이콘을 클릭한 다음 구성을 클릭하여 구성 파일을 엽니다.
다음 구성을 추가하고 다음 환경 변수를 값으로 바꾼 후 저장합니다.
- LOOKER_URL: Looker 인스턴스의 URL입니다.
- CLIENT_ID 및 CLIENT_SECRET: Looker API에 액세스하는 데 사용되는 API 키입니다.
- VERIFY_SSL: 데이터베이스를 Looker 인스턴스에 연결할 때 SSL 암호화를 사용하는지 여부에 따라 true 또는 false

{
  "mcpServers": {
    "looker-toolbox": {
      "command": "./PATH/TO/toolbox",
      "args": ["--stdio", "--prebuilt", "looker"],
      "env": {
          "LOOKER_BASE_URL": "LOOKER_URL",
          "LOOKER_CLIENT_ID": "CLIENT_ID",
          "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
          "LOOKER_VERIFY_SSL": "VERIFY_SSL",
     }
    }
  }
}

AI 도구 사용

이제 AI 도구가 MCP를 사용하여 Looker에 연결됩니다. AI 어시스턴트에게 모델, Explore, 측정기준, 측정값을 나열해 달라고 요청해 보세요. 쿼리의 SQL을 가져오거나 저장된 Look을 실행하여 쿼리를 실행할 수도 있습니다.

LLM에서 사용할 수 있는 도구는 다음과 같습니다.

get_models: Looker 인스턴스의 모든 LookML 모델을 나열합니다.
get_explores: 지정된 모델의 Explore를 나열합니다.
get_dimensions: 지정된 Explore의 측정기준을 나열합니다.
get_measures: 지정된 Explore의 측정항목을 나열합니다.
get_filters: 지정된 Explore의 필터를 나열합니다.
get_parameters: 지정된 Explore의 매개변수를 나열합니다.
query: 쿼리를 실행하고 데이터를 반환합니다.
query_sql: 쿼리에 대해 Looker에서 생성된 SQL을 반환합니다.
query_url: 추가 탐색을 위해 Looker의 쿼리 링크를 반환합니다.
get_looks: 제목 또는 설명과 일치하는 저장된 스타일을 반환합니다.
run_look: 저장된 Look을 실행하고 데이터를 반환합니다.
make_look: Looker에서 저장된 Look을 만들고 URL을 반환합니다.
get_dashboards: 제목 또는 설명과 일치하는 저장된 대시보드를 반환합니다.
make_dashboard: Looker에서 저장된 대시보드를 만들고 URL을 반환합니다.
add_dashboard_element: 대시보드에 타일을 추가합니다.