How to Use the CockroachDB Cloud MCP in VS Code Copilot

Q: How do we share the CockroachDB Cloud MCP configuration across our team in VS Code Copilot?

You commit a .vscode/mcp.json file containing the CockroachDB Cloud MCP configuration to your Git repository. Every developer with VS Code Copilot 1.96+ can then use these MCP tools automatically.

Q: Can I check which cloud providers our clusters support?

Yes, you can ask Copilot to call listsupportedcloudproviders to see where you can deploy. This is useful when planning multi-cloud or multi-region application rollouts.

Keep your engineering team aligned with live CockroachDB Cloud cluster telemetry inside 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 CockroachDB Cloud MCP to VS Code Copilot

Create your Vinkius account to connect CockroachDB Cloud 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 CockroachDB Cloud with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Team-Wide Database Audits in VS Code Copilot

This CockroachDB Cloud MCP Server lets VS Code Copilot execute `list_cockroach_clusters` and `get_cluster_cloud_details` using a shared project configuration. Every engineer on your team gets instant database observability without leaving the codebase. By committing the configuration to your repository, your team avoids manual credential sharing. Copilot reads the live API responses to help developers write environment-specific connection logic.

Live Node Health and Maintenance Tracking

The `list_cluster_nodes` and `list_cluster_operations` tools provide real-time cluster health directly to your VS Code Copilot workspace. You can track active database upgrades or scaling events without opening a browser. If a CI/CD test suite fails on a specific database region, you ask Copilot to audit the active nodes. Your agent parses the node list to identify if a regional outage is causing the test failures.

Security Compliance Checks inside VS Code

This integration exposes `list_network_allowlist` and `list_encryption_keys` to audit your network perimeters and encryption keys directly in VS Code. Copilot checks your active configurations against your team's security standards. You can verify if your development cluster is using the correct Customer Managed Keys. The agent queries your profile via `get_my_cockroach_profile` to ensure the audit runs with the proper administrative context.

Setup guide

Set up CockroachDB Cloud 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 CockroachDB Cloud 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 CockroachDB Cloud tools listed. Try asking: "List my recent CockroachDB Cloud transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "cockroachdb-cloud-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 CockroachDB Cloud. 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 CockroachDB Cloud 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 CockroachDB Cloud MCP in VS Code Copilot

You commit a `.vscode/mcp.json` file containing the CockroachDB Cloud MCP configuration to your Git repository. Every developer with VS Code Copilot 1.96+ can then use these MCP tools automatically.

No, Copilot cannot trigger or modify cluster operations. The `list_cluster_operations` tool is strictly read-only, allowing your team to monitor ongoing scales or upgrades from the editor.

No, the server runs in Vinkius's cloud hosting, meaning your team only needs the connection token. VS Code Copilot communicates directly with the hosted endpoint to fetch your database state.

Yes, you can ask Copilot to call `list_supported_cloud_providers` to see where you can deploy. This is useful when planning multi-cloud or multi-region application rollouts.

Your encryption key metadata and cluster configurations are accessed via secure, single-use V8 sandboxes. Vinkius enforces a zero-trust model, ensuring that sensitive KMS metadata is never cached, stored, or exposed to external LLM training loops.

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