> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse MCP 통합

> MCP 클라이언트 또는 프레임워크를 선택해 AI 어시스턴트를 ClickHouse에 연결합니다.

export const McpGuideGrid = ({variant = "guides"}) => {
  const clients = [{
    name: "Claude Code",
    logo: "/images/logo-claudecode-color.svg"
  }, {
    name: "Claude Desktop",
    logo: "/images/logo-claude.svg"
  }, {
    name: "ChatGPT",
    logo: "/images/logo-codex.svg"
  }, {
    name: "Cursor",
    logo: "/images/logo-cursor.webp"
  }, {
    name: "Windsurf",
    logo: "/images/logo-windsurf.svg"
  }];
  const guides = [{
    name: "Streamlit",
    logo: "/images/mcp-integrations/streamlit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/streamlit")
  }, {
    name: "LangChain and LangGraph",
    logo: "/images/integrations/logos/langchain.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/langchain"),
    lightInvert: true
  }, {
    name: "LlamaIndex",
    logo: "/images/mcp-integrations/llamaindex.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/llamaindex")
  }, {
    name: "PydanticAI",
    logo: "/images/mcp-integrations/pydantic-ai.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/pydantic-ai")
  }, {
    name: "SlackBot",
    logo: "/images/mcp-integrations/slack.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/slackbot")
  }, {
    name: "Agno",
    logo: "/images/mcp-integrations/agno.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/agno")
  }, {
    name: "Chainlit",
    logo: "/images/mcp-integrations/chainlit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/chainlit")
  }, {
    name: "Claude Agent SDK",
    logo: "/images/logo-claude.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/claude-agent-sdk")
  }, {
    name: "CopilotKit",
    logo: "/images/mcp-integrations/copilotkit.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/copilotkit")
  }, {
    name: "CrewAI",
    logo: "/images/mcp-integrations/crewai.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/crewai")
  }, {
    name: "DSPy",
    logo: "/images/mcp-integrations/dspy.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/dspy")
  }, {
    name: "mcp-agent",
    logo: "/images/mcp-integrations/mcp-agent.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/mcp-agent")
  }, {
    name: "Microsoft Agent Framework",
    logo: "/images/mcp-integrations/microsoft-agent-framework.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/microsoft-agent-framework")
  }, {
    name: "Upsonic",
    logo: "/images/mcp-integrations/upsonic.jpg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/upsonic")
  }, {
    name: "OpenAI Agents SDK",
    logo: "/images/logo-codex.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ai-agent-libraries/openai-agents")
  }, {
    name: "Ollama",
    logo: "/images/mcp-integrations/ollama.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/ollama")
  }, {
    name: "AnythingLLM",
    logo: "/images/mcp-integrations/anythingllm.png",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/anythingllm")
  }, {
    name: "Jan.ai",
    logo: "/images/mcp-integrations/jan.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/janai")
  }, {
    name: "LibreChat",
    logo: "/images/mcp-integrations/librechat.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/librechat")
  }, {
    name: "Open WebUI",
    logo: "/images/mcp-integrations/open-webui.svg",
    href: localizeHref("/guides/use-cases/ai-ml/MCP/open-webui")
  }];
  if (variant === "clients") {
    return <div className="card not-prose contents">
        <a href={localizeHref("/guides/use-cases/ai-ml/MCP/claude-desktop")} className="block no-underline focus:no-underline focus-visible:no-underline" style={{
      textDecoration: "none",
      outline: "none"
    }}>
          <div className="flex min-h-[112px] flex-col items-center gap-5 rounded-xl border border-gray-200 bg-white p-5 shadow-sm dark:border-white/10 dark:bg-[#282828] md:flex-row md:justify-between">
            <div className="text-center md:text-left">
              <div className="text-base font-semibold text-black dark:text-white">ClickHouse MCP 서버 설정하기</div>
              <div className="mt-1 text-sm text-gray-600 dark:text-gray-400">Claude Code, Claude Desktop, Codex, ChatGPT, Cursor, Windsurf</div>
            </div>

            <div className="flex flex-wrap items-center justify-center gap-2">
              {clients.map(client => <img key={client.name} src={client.logo} alt={`${client.name} 로고`} title={client.name} className="h-8 w-8 object-contain" style={{
      pointerEvents: "none"
    }} />)}
            </div>
          </div>
        </a>
      </div>;
  }
  return <div className="my-8 grid grid-cols-2 gap-4 md:grid-cols-3 lg:grid-cols-4 xl:grid-cols-5 2xl:grid-cols-6">
      {guides.map(guide => <div key={guide.href} className="card not-prose contents">
          <a href={guide.href} className="block no-underline focus:no-underline focus-visible:no-underline" style={{
    textDecoration: "none",
    outline: "none"
  }}>
            <div className="flex aspect-square min-h-[120px] flex-col items-center justify-center rounded-xl border border-gray-200 bg-white p-4 text-center shadow-sm dark:border-white/10 dark:bg-[#282828]">
              {guide.lightInvert ? <img src={guide.logo} alt={`${guide.name} 로고`} className="ch-logo-invert h-16 w-16 object-contain" style={{
    pointerEvents: "none"
  }} /> : <img src={guide.logo} alt={`${guide.name} 로고`} className="h-16 w-16 object-contain" style={{
    pointerEvents: "none"
  }} />}
              <div className="mt-3 text-sm font-semibold text-black dark:text-white">{guide.name}</div>
            </div>
          </a>
        </div>)}
    </div>;
};

ClickHouse MCP 서버는 호환되는 AI 어시스턴트를 ClickHouse 데이터베이스 및 도구에 연결합니다.
프로토콜, 아키텍처 및 ClickHouse MCP 서버를 소개하는 내용은 [Model Context Protocol(MCP) 개요](/ko/concepts/features/interfaces/mcp)를 참조하십시오.

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

MCP 클라이언트를 선택한 후 [ClickHouse MCP 서버 설정 가이드](/ko/guides/use-cases/ai-ml/MCP/claude-desktop)에 따라 ClickHouse에 연결하십시오.

<McpGuideGrid variant="clients" />

<div id="clickhouse-mcp-server-guides">
  ## ClickHouse MCP 서버 사용 가이드
</div>

통합 또는 프레임워크를 선택하여 해당 ClickHouse MCP 가이드를 확인하십시오.

<McpGuideGrid />

<Info>
  타사 로고 및 상표는 각 소유자에게 귀속되며, 통합을 식별하기 위한 용도로만 표시됩니다.
</Info>