> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> Model Context Protocol 및 ClickHouse MCP 서버 개요

# Model Context Protocol (MCP)

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

[Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP)은 AI 어시스턴트가 외부 시스템에 연결할 수 있도록 하는 개방형 표준입니다.
모델과 서비스의 모든 조합에 맞춰 사용자 정의 통합을 구현할 필요 없이 데이터 소스, API, 데이터베이스 및 도구에 액세스할 수 있는 일관된 인터페이스를 제공합니다.

AI 애플리케이션은 MCP를 한 번만 구현하면 호환되는 모든 서버에 연결할 수 있습니다.
마찬가지로 MCP 서버는 호환되는 모든 클라이언트에 기능을 제공할 수 있습니다.

<div id="architecture">
  ## 아키텍처
</div>

MCP는 클라이언트-서버 아키텍처를 따릅니다.

* Claude Desktop, Cursor, VS Code와 같은 MCP 클라이언트는 MCP 서버에 연결합니다.
* MCP 서버는 표준화된 인터페이스를 통해 도구와 기능을 제공합니다.
* AI 모델은 필요에 따라 제공된 도구를 사용해 외부 데이터와 기능에 액세스합니다.

<Image img="https://mintcdn.com/private-7c7dfe99/RMrV3JZHbEy3aFh9/images/use-cases/AI_ML/MCP/mcp_overview.webp?fit=max&auto=format&n=RMrV3JZHbEy3aFh9&q=85&s=6ee6aea8e44095d8851e1a3ff5beae0d" alt="MCP 클라이언트-서버 아키텍처" size="lg" width="1551" height="641" data-path="images/use-cases/AI_ML/MCP/mcp_overview.webp" />

GitHub에서 커뮤니티가 관리하는 [MCP 클라이언트](https://github.com/punkpeye/awesome-mcp-clients) 및 [MCP 서버](https://github.com/punkpeye/awesome-mcp-servers) 모음을 확인할 수 있습니다.

<div id="clickhouse-mcp-server">
  ## ClickHouse MCP 서버
</div>

[ClickHouse MCP 서버](https://github.com/ClickHouse/mcp-clickhouse)를 사용하면 AI 어시스턴트가 데이터베이스와 테이블을 탐색하고, 스키마를 확인하며, ClickHouse 클러스터에서 SQL 쿼리를 실행할 수 있습니다.
서버가 제공하는 도구는 버전에 따라 다를 수 있으므로, 예시에 사용된 도구 이름은 해당 통합 가이드를 참조하십시오.

서버는 기본적으로 읽기 전용 쿼리만 허용합니다.
AI 어시스턴트에 필요한 권한만 부여된 전용 ClickHouse 사용자를 사용하십시오.

로컬 MCP 클라이언트를 연결하려면 [ClickHouse MCP 서버 설정](/docs/ko/guides/use-cases/ai-ml/MCP/claude-desktop)을 참조하십시오.
관리형 원격 서버에 대해서는 [ClickHouse Cloud의 원격 MCP 서버](/docs/ko/products/cloud/features/ai-ml/remote-mcp)를 참조하십시오.

<Tip>
  **Agent Skills**

  [ClickHouse Agent Skills 리포지토리](https://github.com/ClickHouse/agent-skills)는 스키마 설계, 쿼리 최적화, 데이터 수집 패턴을 비롯한 ClickHouse 관련 전문 지식을 AI 코딩 에이전트에 제공하는 패키지형 지침을 제공합니다.
</Tip>