How to Use the Directus MCP in VS Code Copilot

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

Create a .vscode/mcp.json file at the root of your repository with your Directus credentials. Once committed, any developer opening the project with VS Code Copilot can access the database tools.

Q: Can VS Code Copilot create new items in Directus?

Yes, VS Code Copilot can call createitem to insert new records into your Directus collections. This helps developers seed test data directly from the chat panel.

Q: How do we troubleshoot connection errors between Directus and VS Code Copilot?

Run the checkdirectusstatus tool inside the VS Code Copilot chat to verify your API endpoint. This tool returns the current HTTP response status to confirm your credentials are valid.

Q: Does VS Code Copilot support updating existing Directus records?

Yes, you can instruct VS Code Copilot to run updateitem to patch specific fields in your Directus collections. The agent format-validates the payload before executing the update.

Equip your development team with shared Directus context 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 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 database schemas across VS Code Copilot

`list_collections` standardizes how your engineering team interacts with your Directus database schema inside VS Code Copilot using the MCP standard. By committing the configuration to your repository, every developer gets instant access to table structures. Your team uses `list_fields` inside VS Code Copilot to reference Directus column names without opening a web browser. Copilot suggests accurate queries because it has direct access to the live schema.

Audit database activity inside VS Code Copilot

`list_activity` gives your team immediate visibility into recent Directus modifications directly from the VS Code Copilot chat. Developers can quickly diagnose if a failing test was caused by a recent manual data edit. Combine this with `get_item` inside VS Code Copilot to inspect the exact payload of modified Directus records. This workflow keeps your debugging sessions focused inside the editor.

Track files and users using this MCP Server

`list_files` retrieves your Directus media library metadata directly into VS Code Copilot. Your team writes asset-handling code using real file IDs and paths without leaving the workspace. You can also use `list_users` in VS Code Copilot to verify which developer accounts have access to specific Directus collections. This checks permissions programmatically to speed up local debugging.

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-alternative-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 at the root of your repository with your Directus credentials. Once committed, any developer opening the project with VS Code Copilot can access the database tools.

Yes, VS Code Copilot can call `create_item` to insert new records into your Directus collections. This helps developers seed test data directly from the chat panel.

Run the `check_directus_status` tool inside the VS Code Copilot chat to verify your API endpoint. This tool returns the current HTTP response status to confirm your credentials are valid.

Yes, you can instruct VS Code Copilot to run `update_item` to patch specific fields in your Directus collections. The agent format-validates the payload before executing the update.

Your Directus database items and file metadata are handled securely using your local VS Code Copilot environment configuration. The server never relays your database content or CMS media assets to external logging relays.

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