Skip to main content
모든 사용자가 Cloud Console를 통해 ClickHouse를 사용하는 것은 아닙니다. 예를 들어, 많은 개발자는 선호하는 코드 편집기나 CLI 에이전트에서 직접 작업하거나 사용자 지정 구성을 통해 데이터베이스에 연결합니다. 또 다른 사용자는 대부분의 탐색 작업에 Anthropic Claude와 같은 범용 AI 어시스턴트를 활용합니다. 이러한 사용자와 이들을 대신해 동작하는 에이전트형 워크로드에는 복잡한 설정이나 사용자 지정 인프라 없이 ClickHouse Cloud에 안전하게 접근하고 쿼리할 수 있는 방법이 필요합니다. ClickHouse Cloud의 원격 MCP 서버 기능은 외부 에이전트가 분석에 필요한 컨텍스트를 가져올 수 있도록 표준 인터페이스를 제공하여 이 문제를 해결합니다. MCP, 즉 Model Context Protocol은 LLM 기반 AI 애플리케이션이 구조화된 데이터에 접근하기 위한 표준입니다. 이 통합을 통해 외부 에이전트는 데이터베이스와 테이블 목록을 확인하고, 스키마를 살펴보며, 범위가 제한된 읽기 전용 SELECT 쿼리를 실행할 수 있습니다. 인증은 OAuth 2.0 또는 ClickHouse Cloud API Key를 통해 처리됩니다. 서버는 ClickHouse Cloud에서 완전관리형으로 제공되므로 설정이나 유지 관리가 필요하지 않습니다. 따라서 에이전트형 도구가 ClickHouse에 더 쉽게 연결되어 분석, 요약, 코드 생성, 탐색 등 다양한 목적에 필요한 데이터를 가져올 수 있습니다.

원격 MCP 서버와 오픈소스 MCP 서버 비교

ClickHouse는 두 가지 MCP 서버를 제공합니다. 원격 MCP 서버는 관리할 인프라 없이 서비스 관리, 백업 모니터링, ClickPipe 확인, 청구 데이터 등을 포함해 ClickHouse Cloud와 가장 폭넓게 통합됩니다. 자체 호스팅 ClickHouse 인스턴스의 경우 오픈소스 MCP 서버 가이드를 참조하십시오.

원격 MCP 서버 활성화

원격 MCP 서버가 연결을 수락하려면 각 서비스에서 먼저 활성화되어 있어야 합니다. ClickHouse Cloud 콘솔에서 서비스를 연 다음 Connect 버튼을 클릭하고 MCP를 선택한 후 활성화하세요. 원격 MCP 서버를 활성화하거나 비활성화하려면 control-plane:service:manage-mcp 권한이 필요합니다(콘솔 역할 및 권한 참조). 스크린샷이 포함된 자세한 단계는 설정 가이드를 참조하세요.

엔드포인트

활성화되면 다음 주소에서 원격 MCP 서버를 사용할 수 있습니다:

인증

원격 MCP 서버는 두 가지 인증 메서드를 지원합니다.
  • OAuth 2.0: 대화형 클라이언트에 권장됩니다. MCP 클라이언트가 처음 연결되면 브라우저 창이 열리며, 사용자는 ClickHouse Cloud 자격 증명으로 로그인합니다. 액세스 범위는 인증된 사용자에게 액세스 권한이 있는 조직 및 서비스로 제한됩니다.
  • ClickHouse Cloud API Key: 브라우저 기반 OAuth 흐름을 사용하기 어려운 원격, 헤드리스(headless), 자동화 환경을 위한 방식입니다. HTTP 기본 인증으로 API Key ID와 시크릿을 전송하십시오.
API Key의 액세스 범위는 해당 키에 구성된 역할, 권한, 만료 기한에 따라 결정됩니다. 최소 권한만 부여된 전용 키를 사용하고, 시크릿 관리 시스템을 통해 주입하십시오. Base64 인코딩은 자격 증명을 암호화하지 않으므로 인코딩된 값을 소스 제어 시스템에 커밋하거나 로그에 노출하지 마십시오. 헤드리스 환경에서 MCP 클라이언트를 구성하는 예시는 헤드리스 환경에서 인증하기를 참조하십시오.

안전

원격 MCP 서버를 통해 제공되는 모든 도구는 읽기 전용입니다. 각 도구의 MCP 메타데이터에는 readOnlyHint: true가 명시되어 있습니다. 어떤 도구도 데이터를 수정하거나, 서비스 구성을 변경하거나, 파괴적인 작업을 수행할 수 없습니다.

사용 가능한 도구

원격 MCP 서버는 다음 범주로 나뉜 13개의 도구를 제공합니다.

쿼리 및 스키마 탐색

이러한 도구를 사용하면 에이전트가 어떤 데이터를 사용할 수 있는지 확인하고 분석 쿼리를 실행할 수 있습니다.

조직

서비스

백업

ClickPipes

청구

시작하기

원격 MCP 서버를 활성화하고 MCP client에 연결하는 단계별 안내는 설정 가이드를 참조하십시오.