Keboola Explorer MCP 서버

Keboola MCP 서버

AI 에이전트, MCP 클라이언트( Cursor , Claude , Windsurf , VS Code 등) 및 기타 AI 어시스턴트를 Keboola에 연결하세요. 데이터, 변환, SQL 쿼리 및 작업 트리거를 노출하세요. 글루 코드는 필요하지 않습니다. 에이전트가 필요로 하는 시점과 장소에 맞춰 적절한 데이터를 제공하세요.

개요

Keboola MCP Server는 Keboola 프로젝트와 최신 AI 도구를 연결하는 오픈 소스 브리지입니다. 스토리지 액세스, SQL 변환, 작업 트리거와 같은 Keboola 기능을 Claude, Cursor, CrewAI, LangChain, Amazon Q 등을 위한 호출 가능한 도구로 변환합니다.

특징

저장소 : 테이블을 직접 쿼리하고 테이블 또는 버킷 설명을 관리합니다.
구성 요소 : 추출기, 작성기, 데이터 앱 및 변환 구성을 생성, 나열 및 검사합니다.
SQL : 자연어로 SQL 변환 생성
작업 : 구성 요소 및 변환을 실행하고 작업 실행 세부 정보를 검색합니다.
메타데이터 : 자연어를 사용하여 프로젝트 문서 및 개체 메타데이터를 검색, 읽기 및 업데이트합니다.

준비

다음 사항을 확인하세요.

[ ] Python 3.10+ 설치됨
[ ] 관리자 권한으로 Keboola 프로젝트에 액세스
[ ] 선호하는 MCP 클라이언트(Claude, Cursor 등)

참고 : uv 설치되어 있는지 확인하세요. MCP 클라이언트가 uv를 사용하여 Keboola MCP 서버를 자동으로 다운로드하고 실행합니다. uv 설치 :

macOS/리눅스 :

지엑스피1

윈도우 :

# Using the installer script
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# Or using pip
pip install uv

# Or using winget
winget install --id=astral-sh.uv -e

더 많은 설치 옵션을 보려면 공식 uv 문서를 참조하세요.

MCP 서버를 설정하기 전에 세 가지 주요 정보가 필요합니다.

KBC_저장_토큰

이는 Keboola의 인증 토큰입니다.

Storage API 토큰을 생성하고 관리하는 방법에 대한 지침은 공식 Keboola 문서를 참조하세요.

참고 : MCP 서버에 제한된 액세스 권한을 부여하려면 사용자 지정 스토리지 토큰을 사용하고, MCP가 프로젝트의 모든 항목에 액세스하도록 하려면 마스터 토큰을 사용하세요.

KBC_WORKSPACE_SCHEMA

이는 Keboola에서 작업 공간을 식별하며 SQL 쿼리에 필요합니다.

이 Keboola 가이드를 따라 KBC_WORKSPACE_SCHEMA를 얻으세요.

참고 : 작업 공간을 생성할 때 모든 프로젝트 데이터에 대한 읽기 전용 액세스 권한 부여 옵션을 선택하세요.

케불라 지역

Keboola API URL은 배포 지역에 따라 달라집니다. Keboola 프로젝트에 로그인했을 때 브라우저에서 URL을 확인하여 배포 지역을 확인할 수 있습니다.

지역	API URL
AWS 북미	`https://connection.keboola.com`
AWS 유럽	`https://connection.eu-central-1.keboola.com`
구글 클라우드 EU	`https://connection.europe-west3.gcp.keboola.com`
구글 클라우드 미국	`https://connection.us-east4.gcp.keboola.com`
Azure EU	`https://connection.north-europe.azure.keboola.com`

BigQuery 관련 설정

Keboola 프로젝트에서 BigQuery 백엔드를 사용하는 경우 KBC_STORAGE_TOKEN 및 KBC_WORKSPACE_SCHEMA 외에도 GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 설정해야 합니다.

Keboola BigQuery 작업 공간으로 이동하여 자격 증명을 표시합니다(연결 버튼 클릭).
로컬 디스크에 자격 증명 파일을 다운로드하세요. 일반 JSON 파일입니다.
다운로드한 JSON 자격 증명 파일의 전체 경로를 GOOGLE_APPLICATION_CREDENTIALS 환경 변수로 설정합니다.
이렇게 하면 MCP 서버 인스턴스가 Google Cloud의 BigQuery 작업 공간에 액세스할 수 있는 권한이 부여됩니다. 참고 : KBC_WORKSPACE_SCHEMA는 BigQuery 작업 공간에서 데이터 세트 이름으로 불리며, 연결을 클릭하고 데이터 세트 이름을 복사하기만 하면 됩니다.

Keboola MCP 서버 실행

사용자의 요구 사항에 따라 Keboola MCP 서버를 사용하는 방법은 네 가지가 있습니다.

옵션 A: 통합 모드(권장)

이 모드에서는 Claude 또는 Cursor가 자동으로 MCP 서버를 시작합니다. 터미널에서 명령을 실행할 필요가 없습니다 .

적절한 설정으로 MCP 클라이언트(Claude/Cursor)를 구성하세요.
클라이언트는 필요할 때 자동으로 MCP 서버를 시작합니다.

클로드 데스크톱 구성

Claude(화면 왼쪽 상단) -> 설정 → 개발자 → 구성 편집(claude_desktop_config.json이 보이지 않으면 생성하세요)으로 이동하세요.
다음 구성을 추가합니다.
변경 사항을 적용하려면 Claude 데스크톱을 다시 시작하세요.

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

구성 파일 위치:

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %APPDATA%\Claude\claude_desktop_config.json

커서 구성

설정 → MCP로 이동
"+ 새로운 글로벌 MCP 서버 추가"를 클릭하세요.
다음 설정으로 구성하세요.

{
  "mcpServers": {
    "keboola": {
      "command": "uvx",
      "args": [
        "keboola_mcp_server",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema"
      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

Windows WSL을 위한 커서 구성

Cursor AI를 사용하여 Linux용 Windows 하위 시스템에서 MCP 서버를 실행하는 경우 다음 구성을 사용하세요.

{
  "mcpServers": {
    "keboola": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "'source /wsl_path/to/keboola-mcp-server/.env",
        "&&",
        "/wsl_path/to/keboola-mcp-server/.venv/bin/python -m keboola_mcp_server.cli --transport stdio'"
      ]
    }
  }
}

/wsl_path/to/keboola-mcp-server/.env 파일에 환경 변수가 포함되어 있는 경우:

export KBC_STORAGE_TOKEN="your_keboola_storage_token"
export KBC_WORKSPACE_SCHEMA="your_workspace_schema"

옵션 B: 로컬 개발 모드

MCP 서버 코드 자체를 작업하는 개발자를 위해:

저장소를 복제하고 로컬 환경을 설정합니다.
로컬 Python 경로를 사용하도록 Claude/Cursor를 구성하세요.

{
  "mcpServers": {
    "keboola": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": [
        "-m", "keboola_mcp_server.cli",
        "--transport", "stdio",
        "--api-url", "https://connection.YOUR_REGION.keboola.com"
      ],
      "env": {
        "KBC_STORAGE_TOKEN": "your_keboola_storage_token",
        "KBC_WORKSPACE_SCHEMA": "your_workspace_schema",

      }
    }
  }
}

참고 : BigQuery 사용자의 경우 다음 줄을 "env"에 추가하세요: {}: "GOOGLE_APPLICATION_CREDENTIALS": "/full/path/to/credentials.json"

옵션 C: 수동 CLI 모드(테스트 전용)

테스트나 디버깅을 위해 터미널에서 서버를 수동으로 실행할 수 있습니다.

# Set environment variables
export KBC_STORAGE_TOKEN=your_keboola_storage_token
export KBC_WORKSPACE_SCHEMA=your_workspace_schema
# For BigQuery users
# export GOOGLE_APPLICATION_CREDENTIALS=/full/path/to/credentials.json

# Run with uvx (no installation needed)
uvx keboola_mcp_server --api-url https://connection.YOUR_REGION.keboola.com

# OR, if developing locally
python -m keboola_mcp_server.cli --api-url https://connection.YOUR_REGION.keboola.com

참고 : 이 모드는 주로 디버깅이나 테스트용으로 사용됩니다. Claude나 Cursor를 사용하는 일반적인 경우에는 서버를 수동으로 실행할 필요가 없습니다.

옵션 D: Docker 사용

docker pull keboola/mcp-server:latest

# For Snowflake users
docker run -it \
  -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
  -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
  keboola/mcp-server:latest \
  --api-url https://connection.YOUR_REGION.keboola.com

# For BigQuery users (add credentials volume mount)
# docker run -it \
#   -e KBC_STORAGE_TOKEN="YOUR_KEBOOLA_STORAGE_TOKEN" \
#   -e KBC_WORKSPACE_SCHEMA="YOUR_WORKSPACE_SCHEMA" \
#   -e GOOGLE_APPLICATION_CREDENTIALS="/creds/credentials.json" \
#   -v /local/path/to/credentials.json:/creds/credentials.json \
#   keboola/mcp-server:latest \
#   --api-url https://connection.YOUR_REGION.keboola.com

서버를 직접 시작해야 합니까?

대본	수동으로 실행해야 합니까?	이 설정을 사용하세요
Claude/Cursor 사용	아니요	앱 설정에서 MCP 구성
MCP를 지역적으로 개발	아니 (클로드가 시작함)	Python 경로로 구성 지정
CLI 수동 테스트	예	터미널을 사용하여 실행하세요
Docker 사용	예	도커 컨테이너 실행

MCP 서버 사용

MCP 클라이언트(Claude/Cursor)가 구성되고 실행되면 Keboola 데이터 쿼리를 시작할 수 있습니다.

설정 확인

모든 것이 제대로 작동하는지 확인하기 위해 간단한 쿼리부터 시작할 수 있습니다.

What buckets and tables are in my Keboola project?

당신이 할 수 있는 일의 예

데이터 탐색:

"고객 정보는 어떤 테이블에 저장되어 있나요?"
"매출 기준 상위 10개 고객을 찾는 쿼리를 실행하세요"

데이터 분석:

"지난 분기 지역별 판매 데이터를 분석해 주세요"
"고객 연령과 구매 빈도 간의 상관관계를 찾아보세요"

데이터 파이프라인:

"고객 테이블과 주문 테이블을 조인하는 SQL 변환을 만듭니다."
"Salesforce 구성 요소에 대한 데이터 추출 작업을 시작합니다."

호환성

MCP 클라이언트 지원

MCP 클라이언트	지원 상태	연결 방법
클로드(데스크톱 및 웹)	✅ 지원, 테스트됨	stdio
커서	✅ 지원, 테스트됨	stdio
윈드서핑, 제드, 리플리트	✅ 지원됨	stdio
코디움, 소스그래프	✅ 지원됨	HTTP+SSE
맞춤형 MCP 클라이언트	✅ 지원됨	HTTP+SSE 또는 stdio

지원되는 도구

참고: Keboola MCP는 1.0 이전 버전이므로 일부 주요 변경 사항이 발생할 수 있습니다. AI 에이전트는 새로운 도구에 자동으로 적응합니다.

범주	도구	설명
저장	`retrieve_buckets`	Keboola 프로젝트의 모든 스토리지 버킷을 나열합니다.
	`get_bucket_detail`	특정 버킷에 대한 자세한 정보를 검색합니다.
	`retrieve_bucket_tables`	특정 버킷 내의 모든 테이블을 반환합니다.
	`get_table_detail`	특정 테이블에 대한 자세한 정보를 제공합니다
	`update_bucket_description`	버킷 설명을 업데이트합니다.
	`update_column_description`	테이블의 주어진 열에 대한 설명을 업데이트합니다.
	`update_table_description`	테이블 설명을 업데이트합니다
SQL	`query_table`	사용자 정의 SQL 쿼리를 데이터에 대해 실행합니다.
	`get_sql_dialect`	작업 공간에서 Snowflake 또는 BigQuery SQL 방언을 사용하는지 식별합니다.
요소	`create_component_root_configuration`	사용자 정의 매개변수를 사용하여 구성 요소 구성을 만듭니다.
	`create_component_row_configuration`	사용자 정의 매개변수를 사용하여 구성 요소 구성 행을 만듭니다.
	`create_sql_transformation`	사용자 정의 쿼리를 사용하여 SQL 변환을 생성합니다.
	`find_component_id`	주어진 쿼리와 일치하는 구성 요소 ID 목록을 반환합니다.
	`get_component`	ID가 주어진 특정 구성요소에 대한 정보를 가져옵니다.
	`get_component_configuration`	특정 구성 요소/변환 구성에 대한 정보를 가져옵니다.
	`get_component_configuration_examples`	특정 구성 요소에 대한 샘플 구성 예를 검색합니다.
	`retrieve_component_configurations`	프로젝트에 존재하는 구성 요소의 구성을 검색합니다.
	`retrieve_transformations`	프로젝트에서 변환 구성을 검색합니다.
	`update_component_root_configuration`	특정 구성 요소 구성을 업데이트합니다.
	`update_component_row_configuration`	특정 구성 요소 구성 행을 업데이트합니다.
	`update_sql_transformation_configuration`	기존 SQL 변환 구성을 업데이트합니다.
직업	`retrieve_jobs`	상태, 구성 요소 또는 구성별로 작업을 나열하고 필터링합니다.
	`get_job_detail`	특정 작업에 대한 포괄적인 세부 정보를 반환합니다.
	`start_job`	구성 요소 또는 변환 작업을 실행하도록 트리거합니다.
선적 서류 비치	`docs_query`	자연어 쿼리를 기반으로 Keboola 문서를 검색합니다.

문제 해결

일반적인 문제

문제	해결책
인증 오류	`KBC_STORAGE_TOKEN` 이 유효한지 확인하세요
작업 공간 문제	`KBC_WORKSPACE_SCHEMA` 가 올바른지 확인하세요
연결 시간 초과	네트워크 연결 확인

개발

설치

기본 설정:

uv sync --extra dev

기본 설정으로 uv run tox 사용하여 테스트를 실행하고 코드 스타일을 확인할 수 있습니다.

권장 설정:

uv sync --extra dev --extra tests --extra integtests --extra codestyle

권장 설정을 사용하면 테스트 및 코드 스타일 검사를 위한 패키지가 설치되고, 이를 통해 VsCode나 Cursor와 같은 IDE에서 개발 중에 코드를 검사하거나 테스트를 실행할 수 있습니다.

통합 테스트

로컬에서 통합 테스트를 실행하려면 uv run tox -e integtests 사용하세요. 참고: 다음 환경 변수를 설정해야 합니다.

INTEGTEST_STORAGE_API_URL
INTEGTEST_STORAGE_TOKEN
INTEGTEST_WORKSPACE_SCHEMA

이러한 값을 얻으려면 통합 테스트를 위한 전담 Keboola 프로젝트가 필요합니다.

`uv.lock` 업데이트

종속성을 추가하거나 제거한 경우 uv.lock 파일을 업데이트하세요. 릴리스를 생성할 때 최신 종속성 버전으로 잠금을 업데이트하는 것도 고려해 보세요( uv lock --upgrade ).

지원 및 피드백

⭐ 도움을 받거나, 버그를 보고하거나, 기능을 요청하는 가장 기본적인 방법은 GitHub에서 이슈를 여는 것 입니다. ⭐

개발팀은 문제를 적극적으로 모니터링하고 최대한 빨리 대응하겠습니다. Keboola에 대한 일반적인 정보는 아래 자료를 참조하세요.

자원

사용자 문서
개발자 문서
케불라 플랫폼
이슈 트래커 ← MCP 서버에 대한 기본 연락 방법

연결하다

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

이 서버는 Keboola의 Storage API와의 상호작용을 용이하게 하여 사용자가 Claude Desktop을 통해 프로젝트 버킷, 테이블, 구성 요소를 효율적으로 탐색하고 관리할 수 있도록 합니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Neo4j Server
da-okazaki
A
security
A
license
A
quality
This server enables interaction between Neo4j databases and Claude Desktop, allowing users to execute Cypher queries, create nodes, and establish relationships in the database.
Last updated -
3
72
24
TypeScript
MIT License
Claude Dev Server
arben-adm
-
security
A
license
-
quality
The Claude Dev Server enables direct interaction with the file system within a specified workspace, allowing users to perform file and directory operations and implement code artifacts in software development using natural language commands.
Last updated -
2
Python
MIT License
Julia Documentation MCP Server
jonathanfischer97
-
security
A
license
-
quality
The server facilitates access to Julia documentation and source code through Claude Desktop, allowing users to retrieve information on Julia packages, modules, types, functions, and methods.
Last updated -
4
0
2
JavaScript
MIT License
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python

View all related MCP servers

Keboola MCP 서버

개요

특징

준비

KBC_저장_토큰

KBC_WORKSPACE_SCHEMA

케불라 지역

BigQuery 관련 설정

Keboola MCP 서버 실행

옵션 A: 통합 모드(권장)

클로드 데스크톱 구성

커서 구성

Windows WSL을 위한 커서 구성

옵션 B: 로컬 개발 모드

옵션 C: 수동 CLI 모드(테스트 전용)

옵션 D: Docker 사용

서버를 직접 시작해야 합니까?

MCP 서버 사용

설정 확인

당신이 할 수 있는 일의 예

호환성

MCP 클라이언트 지원

지원되는 도구

문제 해결

일반적인 문제

개발

설치

통합 테스트

uv.lock 업데이트

지원 및 피드백

자원

연결하다

Tools

Related Resources

Related MCP Servers

MCP Neo4j Server

Claude Dev Server

Julia Documentation MCP Server

Claude Desktop API MCP

Appeared in Searches

New MCP Servers

MCP directory API

`uv.lock` 업데이트