Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use ClickHouse with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Query and manage ClickHouse databases. execute analytical SQL, monitor replication status, and manage schemas directly from your AI agent.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 4 capabilities

The complete ClickHouse capability set.

These are the exact actions your AI can choose when you ask it to work with ClickHouse.

Capability set01 / 01

01-04

4 capabilities in this set.

Part of 4 available through ClickHouse.

  1. 01

    Ping

    Check ClickHouse server health

  2. 02

    Select query

    Automatically enforces readonly=1. Execute a read-only SELECT query on ClickHouse

  3. 03

    Execute query

    Execute a mutating query on ClickHouse

  4. 04

    Replicas status

    Check ClickHouse replica delay

Observed, not estimated

918ms average. Fast in production.

ClickHouse is checked daily against the live service.

Daily averagePeak 1261ms
Aug 20Today
Fastest day
683ms
Slowest day
1261ms
14-day trend
Slowing+55%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 4 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of ClickHouse, so you can see the experience inside your AI.

It does not authenticate your account with ClickHouse. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

ClickHouse Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_vh45Xvmk8E2B7cahxxnRmSHdcoQUTkiyCXVcszPX/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — ClickHouse capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "clickhouse-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vh45Xvmk8E2B7cahxxnRmSHdcoQUTkiyCXVcszPX/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions ClickHouse owners ask.

  • 01

    Can I safely run analytical queries without accidentally modifying data?

    Yes. The select_query capability is strictly read-only and automatically enforces the readonly=1 setting, ensuring that only SELECT, SHOW, and DESCRIBE operations are permitted.

  • 02

    How do I check if my ClickHouse cluster is healthy and synchronized?

    You can use the ping capability to check server reachability and the replicas_status capability to inspect replication delays and the status of your replicas.

  • 03

    Is it possible to create new tables or insert data using this server?

    Yes. For mutating operations like INSERT, CREATE, or ALTER, use the execute_query action. This capability allows you to modify the database schema and manage data records.

Explore

More in Brain Trust

Suggestions