How to Use the Directus MCP in Cline

Q: Can Cline modify my Directus schema?

No. Cline can read your schema using listschemacollections and getcollectiondetails, but it cannot modify tables or columns. It can only modify table rows using patchcmsrecord and createcmsrecord.

Let Cline write, test, and deploy code against your live Directus database inside VS Code.

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 Cline

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build features with live database context

Executing `list_schema_collections` allows Cline to map out your PostgreSQL or MySQL database directly inside VS Code. The agent inspects column types with `list_collection_fields` to write perfectly typed API clients. Calling `list_collection_items` pulls real data examples from your headless CMS to verify component rendering. This ensures the frontend code Cline generates matches the exact shape of your live database payloads.

Execute end-to-end database modifications in Cline

Running `patch_cms_record` lets Cline execute database updates directly from your VS Code workspace. It handles the entire lifecycle without you having to touch a database client or open a browser. Executing `wipe_cms_record` allows the agent to purge temporary test entries it created via `create_cms_record`. Cline handles these operations autonomously, showing you the exact diff of what changed in your database.

Manage media assets and team permissions

Running `list_directus_files` lets Cline use this MCP Server to inspect your media library to debug broken file uploads. The agent verifies storage paths and matches assets to database rows, ensuring your code references the correct file structures. Calling `list_directus_users` lets Cline inspect active admin accounts to verify permission boundaries. It checks security configurations and builds user-facing features that respect your system's access rules.

Setup guide

Set up Directus MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type directus-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest Directus refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "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 Cline

Open the Cline sidebar, click the MCP Servers icon, and paste your Vinkius endpoint URL. You can also edit your cline_mcp_settings.json file directly to configure the connection details.

No. Cline can read your schema using `list_schema_collections` and `get_collection_details`, but it cannot modify tables or columns. It can only modify table rows using `patch_cms_record` and `create_cms_record`.

No, this MCP Server connects directly to your hosted Directus instance. Vinkius handles the authentication and proxying, so Cline only needs your single endpoint token to perform database actions.

Cline plans its steps in your VS Code sidebar using the MCP connection. It will first call `get_single_item` to inspect a record, write the necessary code changes, and then verify the results by pulling the updated record from your database.

All database rows, user accounts, and media metadata are processed through an ephemeral, zero-trust sandbox. Vinkius isolates each connection, meaning your database records and schema details are never stored or used to train public 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