How to Use the ClickHouse (Vector Search) MCP in VS Code Copilot

Sync your team on one database source by plugging ClickHouse (Vector Search) into VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ClickHouse (Vector Search) MCP to VS Code Copilot

Create your Vinkius account to connect ClickHouse (Vector Search) to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup ClickHouse (Vector Search) with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run SQL and vector searches in VS Code Copilot

Use the `execute_sql` tool to fetch live data for your team's code reviews. It allows everyone to work from the same source of truth. Team members can use `vector_search` to pull embeddings during feature development. It ensures the logic matches your actual vector distribution.

Manage your schema from VS Code

Use `list_databases` and `list_tables` to keep your team's local environments consistent. It prevents drift across your development organization. Call `get_version` to check that everyone is running the same database build. This avoids compatibility issues during deployment.

Monitor cluster health via Copilot

The `get_table_stats` tool pulls real-time health metrics. Your team can see the cluster state without needing admin access to the dashboard. It provides a clear view of your runtime limits. You get the data you need to prevent bottlenecks before they happen.

Setup guide

Set up ClickHouse (Vector Search) MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the ClickHouse (Vector Search) MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the ClickHouse (Vector Search) tools listed. Try asking: "List my recent ClickHouse (Vector Search) transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "clickhouse-vector-search-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by ClickHouse. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect ClickHouse (Vector Search) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about ClickHouse (Vector Search) MCP in VS Code Copilot

You commit your config file to the repo, and everyone gets the same tools. It allows your entire team to query the database through their Copilot chat.

Yes, the vector tool is available to all team members via the chat. Just specify your search parameters and the tool will return the results.

It does. By sharing the configuration in your repository, you ensure every developer has the same permissions and access to run queries against your instance.

Invoke the version tool in the chat. It will return the current build details for your cluster, confirming that your environment is up to date.

We enforce strict access controls via your endpoint token. All traffic is encrypted, and the server operates in an ephemeral sandbox to ensure your sensitive schema data is never exposed or logged externally.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript