ClickHouse Cloud 원격 MCP 서버 활성화 및 연결

이 가이드에서는 ClickHouse Cloud 원격 MCP 서버를 활성화하고, 일반적인 개발자 도구에서 사용할 수 있도록 설정하는 방법을 설명합니다.

사전 요구 사항

• 실행 중인 ClickHouse Cloud 서비스
• 사용 중인 IDE 또는 에이전트 기반 개발 도구

Cloud용 원격 MCP 서버 활성화

원격 MCP 서버를 활성화할 ClickHouse Cloud 서비스에 연결하세요. 왼쪽 메뉴에서 Connect를 클릭하세요. 연결 세부 정보가 표시된 상자가 열립니다.

Connect with MCP를 선택하세요:

서비스에서 MCP를 활성화하려면 버튼을 켜세요:

표시된 URL을 복사하세요. 아래 URL과 동일합니다:

https://mcp.clickhouse.cloud/mcp

개발용 원격 MCP 설정

아래에서 IDE 또는 도구를 선택한 후 해당 설정 지침을 따르십시오.

Claude Code

작업 디렉터리에서 다음 명령을 실행하여 Claude Code에 ClickHouse Cloud MCP 서버 구성을 추가하십시오:

claude mcp add --transport http clickhouse-cloud https://mcp.clickhouse.cloud/mcp

그런 다음 Claude Code를 실행합니다:

claude

다음 명령을 실행하여 MCP 서버 목록을 확인합니다:

/mcp

clickhouse-cloud를 선택하고 ClickHouse Cloud 자격 증명을 사용해 OAuth로 인증하세요.

Claude 웹 UI

1. Customize > Connectors로 이동합니다
2. "+" 아이콘을 클릭한 다음 사용자 지정 connector 추가를 클릭합니다
3. 사용자 지정 connector에 clickhouse-cloud와 같은 이름을 지정한 후 추가합니다
4. 새로 추가한 clickhouse-cloud connector를 클릭한 다음 Connect를 클릭합니다
5. OAuth를 통해 ClickHouse Cloud 자격 증명으로 인증합니다

Cursor

1. Cursor Marketplace에서 MCP 서버를 찾아 설치합니다.
2. ClickHouse를 검색한 다음, 원하는 서버에서 "Add to Cursor"를 클릭하여 설치합니다.
3. OAuth로 인증합니다.

Visual Studio Code

다음 구성을 .vscode/mcp.json 파일에 추가하세요:

{
  "servers": {
    "clickhouse-cloud": {
      "type": "http",
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

자세한 내용은 Visual Studio Code 문서를 참조하십시오.

Windsurf

다음 구성을 사용하여 mcp_config.json 파일을 편집하세요:

{
  "mcpServers": {
    "clickhouse-cloud": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickhouse.cloud/mcp"]
    }
  }
}

자세한 내용은 Windsurf 문서를 참조하십시오.

Zed

ClickHouse를 사용자 지정 서버로 추가합니다. Zed 설정의 context_servers 아래에 다음 내용을 추가하십시오:

{
  "context_servers": {
    "clickhouse-cloud": {
      "url": "https://mcp.clickhouse.cloud/mcp"
    }
  }
}

그러면 Zed는 서버에 처음 연결할 때 OAuth를 통해 인증하라는 메시지를 표시합니다. 자세한 내용은 Zed 문서를 참조하십시오.

Codex

CLI를 사용해 ClickHouse Cloud MCP 서버를 추가하려면 다음 명령을 실행하세요:

codex mcp add clickhouse-cloud --url https://mcp.clickhouse.cloud/mcp

예시 사용

연결되면 자연어 프롬프트로 ClickHouse Cloud와 상호작용할 수 있습니다. 다음은 일반적인 워크플로와 그 과정에서 MCP 클라이언트가 백그라운드에서 호출하는 도구입니다. 사용 가능한 도구의 전체 목록은 도구 참조를 참조하십시오.

데이터 살펴보기

먼저 무엇을 사용할 수 있는지 확인합니다:

프롬프트	호출되는 도구
"액세스할 수 있는 조직은 무엇인가요?"	get_organizations
"내 서비스에서 사용할 수 있는 데이터베이스는 무엇인가요?"	list_databases
"default 데이터베이스의 테이블을 보여주세요"	list_tables
"이름이 events_로 시작하는 모든 테이블을 나열하세요"	list_tables (like 필터 사용)

분석 쿼리 실행

자연어로 질문하면 에이전트가 이를 SQL로 변환합니다:

프롬프트	호출된 도구
"hits 테이블의 상위 10개 행을 보여주세요"	run_select_query
"지난 7일간 국가별 평균 세션 지속 시간은 얼마입니까?"	run_select_query
"analytics 데이터베이스의 각 테이블에는 행이 몇 개 있습니까?"	run_select_query

run_select_query 도구는 SELECT SQL 문만 허용합니다. 모든 쿼리는 읽기 전용입니다.

서비스 및 인프라 관리

ClickHouse Cloud 리소스를 한눈에 파악합니다:

프롬프트	호출되는 도구
"내 서비스 목록을 보여 주세요"	get_services_list
"운영 중인 서비스의 상태는 무엇인가요?"	get_service_details
"이 서비스의 백업 일정을 보여 주세요"	get_service_backup_configuration
"최근 백업 목록을 보여 주세요"	list_service_backups
"이 서비스에 구성된 ClickPipes는 무엇인가요?"	list_clickpipes

모니터링 비용

프롬프트	호출되는 도구
"지난주 우리 조직의 비용은 얼마였나요?"	get_organization_cost
"3월 1일부터 3월 15일까지의 일별 비용을 보여주세요"	get_organization_cost (from_date 및 to_date 포함)

관련 콘텐츠

• ClickHouse agent skills