Skip to main content
이 가이드에서는 Claude Agent SDK를 사용해 ClickHouse MCP 서버를 통해 ClickHouse SQL playground와 상호작용할 수 있는 AI 에이전트를 구축하는 방법을 알아봅니다.
예시 노트북이 예시는 examples 리포지토리의 노트북에서 확인할 수 있습니다.

사전 요구 사항

  • 시스템에 Python이 설치되어 있어야 합니다.
  • 시스템에 pip가 설치되어 있어야 합니다.
  • Anthropic API Key가 필요합니다.
다음 단계는 Python REPL 또는 스크립트에서 실행할 수 있습니다.
1

라이브러리 설치

다음 명령을 실행하여 Claude Agent SDK 라이브러리를 설치하십시오.
2

자격 증명 설정

다음으로, Anthropic API Key를 입력해야 합니다.
응답
다음으로, ClickHouse SQL playground에 연결하는 데 필요한 자격 증명을 정의합니다.
3

MCP 서버와 Claude Agent SDK 에이전트 초기화

이제 ClickHouse MCP 서버가 ClickHouse SQL playground를 가리키도록 구성한 후, 에이전트를 초기화하고 질문을 하나 해보겠습니다.
간결하게 보여주기 위해 for 블록 내부의 코드는 출력을 필터링합니다.
응답
마지막 수정일 2026년 7월 23일