How to Use the Directus MCP in Windsurf

Q: How do I configure Directus with Windsurf?

Open your mcpconfig.json file in Windsurf and add the MCP Server configuration under the mcpServers block. You can also use the Cascade Settings UI to add your endpoint token, and Cascade will instantly discover all ten database tools.

Let Cascade auto-pilot your PostgreSQL and MySQL tables directly inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Directus MCP to Windsurf

Create your Vinkius account to connect Directus 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 Directus with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Rebuild Directus schemas with Windsurf Cascade

Running `list_schema_collections` lets Cascade map your database structure instantly without leaving your IDE. The agent reads your schema via `list_collection_fields` and writes matching TypeScript types without you pointing it to a browser. Calling `get_collection_details` lets Cascade verify table constraints before writing any code. This MCP Server gives Windsurf the exact structural layout of your tables, making database integration feel like reading local files.

Automated database record management

Using `list_collection_items` allows Cascade to locate target rows and apply updates without manual SQL queries. The agent then modifies the entries using `patch_cms_record` to keep your development database up to date. Executing `create_cms_record` lets Cascade seed your database tables with mock data for rapid prototyping. If a test run goes wrong, the agent can clean up after itself using `wipe_cms_record` to keep your environment pristine.

Audit files and team access

Running `list_directus_files` lets Windsurf verify media storage paths directly from your workspace. It matches files to your database records so you can debug broken links in seconds. Calling `list_directus_users` lets Cascade pull active admin accounts to audit permissions directly from the chat window. You can verify who has access to your system without opening a browser.

Setup guide

Set up Directus 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 Directus 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 Directus payment history." If connected, Cascade will call the Directus tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "directus-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 Directus. 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 Directus 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 Directus MCP in Windsurf

Open your mcp_config.json file in Windsurf and add the MCP Server configuration under the mcpServers block. You can also use the Cascade Settings UI to add your endpoint token, and Cascade will instantly discover all ten database tools.

Yes. Cascade excels at chaining tools. If you ask it to fix a broken database record, it will first find the item using `get_single_item`, inspect the schema with `list_collection_fields`, and then update the record using `patch_cms_record` in one autonomous sequence.

No, it cannot delete tables, but it can delete rows. If you ask it to clear data, it will use the `wipe_cms_record` tool to remove specific database entries. You control what permissions your Vinkius endpoint token has to prevent unauthorized deletions.

This MCP connection runs over secure HTTPS through Vinkius. Windsurf connects directly to the managed endpoint using your single token, avoiding any local Node.js or Docker setup requirements on your machine.

Your database credentials never pass through the AI model. The server runs inside an ephemeral, zero-trust V8 Isolate Sandbox on Vinkius, ensuring your SQL database schemas, file metadata, and user lists remain entirely private and isolated.

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