How to Use the DBeaver (CloudBeaver) MCP in Windsurf

Q: How do I export data from DBeaver (CloudBeaver) using Windsurf?

Describe what you want to export. Windsurf can use datatransferexportdatafromcontainer for a whole table or datatransferexportdatafromresults for a specific query's output.

Let Windsurf manage your CloudBeaver users and connections. Set a goal, like provisioning a new dev, and Cascade handles the rest.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect DBeaver (CloudBeaver) MCP to Windsurf

Create your Vinkius account to connect DBeaver (CloudBeaver) to Windsurf 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 DBeaver (CloudBeaver) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate User Provisioning

Tell Windsurf to set up a new developer on your CloudBeaver instance. Cascade will plan and execute the steps: create the account with `create_user`, add them to the right team, and then grant access to specific database connections with `add_connections_access`. You don't prompt each step; you just state the goal. Need to offboard someone? Just ask Windsurf to run `delete_user` and revoke their access. It's all done in seconds, right from your editor.

Inspect Server State with Windsurf

Ask Windsurf to check your CloudBeaver server's status. It can pull a list of all supported database drivers using `get_driver_list` or see which authentication providers are active with `get_auth_providers`. It’s faster than digging through config files or the web UI. Cascade can also chain these checks. For example, 'Check the license status and then get the config for the main production database.' It'll run `get_active_product_license` followed by `get_connection_info`, presenting a clean summary.

Your CloudBeaver MCP Server

Need a data dump for a quick analysis? Tell Windsurf to export a specific table. It will use `data_transfer_export_data_from_container` to start the export job in the background, so you can keep working. No more waiting on a slow UI to generate a CSV. You can also manage active database sessions directly from your IDE. If a query is stuck or a session needs to be killed, just tell Windsurf to terminate it using `db_sm_terminate`. Cascade finds the right session and ends it.

Setup guide

Set up DBeaver (CloudBeaver) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the DBeaver (CloudBeaver) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my DBeaver (CloudBeaver) payment history." If connected, Cascade will call the DBeaver (CloudBeaver) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "dbeaver-cloudbeaver-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 CloudBeaver. 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 DBeaver (CloudBeaver) 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 DBeaver (CloudBeaver) MCP in Windsurf

Yes. Just tell Windsurf's Cascade agent your goal, and it uses the `create_user` tool to provision the account. It can also add the new user to teams and grant connection access in the same operation.

Describe what you want to export. Windsurf can use `data_transfer_export_data_from_container` for a whole table or `data_transfer_export_data_from_results` for a specific query's output.

Ask Windsurf to get the info for a specific connection. It calls `get_connection_info` and gives you the status and configuration right in your editor, which is much faster than navigating the UI.

Absolutely. You can tell Windsurf to create, delete, or modify teams and their connection access. It uses tools like `create_team`, `delete_team`, and `add_connections_access` to handle it.

This server only interacts with your CloudBeaver instance's metadata. This includes user accounts, team structures, connection configurations, and server settings. Your database contents are only touched when you explicitly run a data export command.

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