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. Manage vector embeddings and SQL via ClickHouse. list databases, execute SQL, and perform high-speed vector searches directly from any 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 · 7 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 / 02

01-04

4 capabilities in this set.

Part of 7 available through ClickHouse.

  1. 01

    List databases

    Identify bounded logical arrays managing top-level ClickHouse schemas

  2. 02

    Describe table

    Perform structural extraction of properties driving active column schemas

  3. 03

    Get version

    G. HNSW support). Identify precise active cluster limits spanning the execution runtime

  4. 04

    Execute SQL

    Provision a highly-available SQL execution pushing arbitrary arbitrary DML/DDL or SELECTs

Capability set02 / 02

05-07

3 capabilities in this set.

Part of 7 available through ClickHouse.

  1. 05

    Get table stats

    Extracts explicitly attached internal structural states pulling cluster health

  2. 06

    List tables

    Retrieve the exact structural matching verifying table limits inside a database

  3. 07

    Vector search

    Identify explicit mathematical distance traces routing Vector Embeddings

Observed, not estimated

865ms average. Fast in production.

ClickHouse is checked daily against the live service.

Daily averagePeak 1157ms
Aug 20Today
Fastest day
699ms
Slowest day
1157ms
14-day trend
Stable+3%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 7 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_567ij3B5hJvT6KRM8Z5LcFbGNttrwDvwD2OPp6c2/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-vector-search-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_567ij3B5hJvT6KRM8Z5LcFbGNttrwDvwD2OPp6c2/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 my agent perform high-speed vector similarity searches?

    Yes. Provide the database, table, and the vector embedding array in JSON format. The agent uses ClickHouse's native distance functions (cosine or L2) to return the closest matches, leveraging ClickHouse's industry-leading OLAP performance.

  • 02

    Can I execute arbitrary SQL commands directly through the agent?

    Absolutely. The 'execute_sql' capability allows you to push any valid ClickHouse SQL (DML, DDL, or SELECT) to your cluster. This is perfect for managing tables, updating records, or generating custom analytical reports on the fly.

  • 03

    How do I check if my ClickHouse instance supports HNSW indices?

    Ask your agent to get the version details. The agent checks your ClickHouse build and identifies exactly which capability branches are active, confirming if advanced vector features like HNSW support are available in your runtime environment.

Explore

More in AI Frontier

Suggestions