How to Use the Directus MCP in VS Code Copilot

Q: How do we share the Directus MCP server configuration with our team in VS Code Copilot?

Create a .vscode/mcp.json file in your project root and commit it to your Git repository. Add the server configuration with your Vinkius endpoint token. Every developer on your team using VS Code Copilot will automatically have access to the database tools upon opening the workspace.

Q: Can VS Code Copilot inspect collection details for my Directus setup?

Yes, Copilot uses getcollectiondetails to perform structural extraction of properties driving your active tables. This allows the agent to explain table relationships and assist developers in writing complex database migrations.

Q: Can I fetch specific records using their UUID via MCP?

Yes, getsingleitem retrieves explicit cloud logging tracing explicit database row UUIDs. This lets you pull the exact JSON payload of any record directly into your editor for debugging.

Equip VS Code Copilot with tools to read schemas, update rows, and manage media in your Directus database.

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 VS Code Copilot

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Share Directus schema tools across VS Code Copilot teams

`list_schema_collections` enumerates the structured rules defining your PostgreSQL tables directly inside your shared VS Code workspace. By committing the MCP Server configuration to your repository, your entire engineering team gets access to these database tools. Copilot uses this schema data to answer technical questions during code reviews. To drill down into specific tables, `list_collection_fields` inspects internal arrays to verify column configurations. This prevents different developers from writing conflicting queries, keeping the team aligned on the same database structure.

Use this MCP Server to audit database users and files

`list_directus_users` identifies active arrays spanning your admin identities directly within VS Code Copilot. This tool allows your team to audit who has access to the database without leaving the editor. Copilot can generate access reports based on the returned user profiles. For media assets, `list_directus_files` retrieves the exact structural matching to verify media storage. Your developers can verify that files are uploaded and structured correctly, reducing broken asset links in production code.

Mutate Directus database records inside VS Code Copilot

`patch_cms_record` mutates global boundaries by substituting database values via ID directly from your Copilot chat. This is useful for quick database updates during debugging sessions. You don't have to switch to an external client to modify a record. To insert new records, `create_cms_record` provisions a highly-available JSON payload to write rows directly to your tables. If you need to clean up test environments, the agent can run `wipe_cms_record` to drop live rows from the database safely.

Setup guide

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

.vscode/mcp.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 VS Code Copilot

Create a `.vscode/mcp.json` file in your project root and commit it to your Git repository. Add the server configuration with your Vinkius endpoint token. Every developer on your team using VS Code Copilot will automatically have access to the database tools upon opening the workspace.

Yes, Copilot uses `get_collection_details` to perform structural extraction of properties driving your active tables. This allows the agent to explain table relationships and assist developers in writing complex database migrations.

The agent always asks for confirmation before executing destructive tools like `wipe_cms_record`. You can also configure your Vinkius endpoint token with read-only permissions, completely blocking write operations within VS Code Copilot's MCP client.

Yes, `get_single_item` retrieves explicit cloud logging tracing explicit database row UUIDs. This lets you pull the exact JSON payload of any record directly into your editor for debugging.

Yes, your Directus SQL rows, file metadata, and admin user records are processed strictly within Vinkius's SOC 2 compliant infrastructure. The data transport is encrypted end-to-end, and the ephemeral sandbox ensures that database contents are never cached or used to train public language models.

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