Directus MCP Server: Items, Collections and Files in Claude

01 · Overview

What the Ryze AI Directus MCP server is

The short version

01Articles publish into a Directus collection you pick, with a language code for translated collections (default en). The agent manages items over the Directus REST API.
02Directus connects to a Ryze AI workspace with a static access token, the Instance URL and the Blog URL. Your AI client then connects to Ryze AI with one URL (see Setup).
03One tool reads (read), one creates and updates (write) and one deletes (delete).
04They reach whatever the token’s role can see: items, collections, fields, files, users, flows and server info.
05Works with any Ryze AI plan or trial. SEO Starter is $129/mo with a 3-day free trial.

directus · server specOAuth

Server name: Ryze AI (Directus tools)
Endpoint: https://connector.get-ryze.ai/mcp
Transport: Remote MCP over HTTP
Client sign-in: OAuth to Ryze AI, up to 20 workspaces per connection
Directus sign-in: Static access token on a Directus user, plus the Instance URL and the Blog URL
Directus API: REST requests to your own instance
Directus tools: 3 (1 read · 1 write · 1 delete)
Connections: One Directus connection per workspace
Price: Any Ryze AI plan or trial · SEO Starter $129/mo
Checked: November 8, 2026

“Directus MCP” can mean a few things in 2026. Directus documents a remote MCP server that you switch on inside your own instance from v11.12, plus a Local MCP option for older versions. Developers also publish community servers on GitHub. This page documents the hosted Ryze AI server, which talks to Directus over its REST API, and compares it with the Directus server in section 06.

Your collection, your schema

Content Plan articles publish into the Directus collection you pick during setup, so the agent works on the same table your site already reads.

One read tool for the whole REST API

directus__read runs a read-only REST request: items in a collection, collections, fields, files, users, flows and server info.

Create, update and bulk update

directus__write sends POST or PATCH requests, which covers new items, edits and bulk updates of many items in one call.

Delete in its own tool

directus__delete removes one or many items. Because it is separate, you can allow edits and keep removals on approval.

Translations by language code

For collections that use Directus translations, you set a language code at connect time. It defaults to en, and single-language collections ignore it.

Static token, nothing else to host

Directus connects with a token generated on a user. The token follows that user's role, so collections the role cannot see stay out of reach.

Custom proxy header on request

If the instance sits behind a proxy that needs a custom request header, Ryze AI support can add it to the connection.

Connect from inside the client

Directus can also be connected from Claude or ChatGPT with a one-time connection link, so setup can start in the chat.

02 · Tool reference

Three Directus tools

Each tool sends a request to the Directus REST API of the connected instance, so the agent stays within what the token’s role allows: reads cover items, collections, fields, files, users, flows and server info, and writes and deletes cover items. Tool names come from the Ryze AI app source. Directus is not connected in any Ryze AI workspace yet, so this list has not been checked against a live connector session. Treat the tool list in your client as the final word.

Tool	Access	What it does
`directus__read`	read	Runs a read-only Directus REST request, such as items in a collection, collections, fields, files, users, flows and server info.
`directus__write`	write	Creates or updates items through the Directus REST API (POST or PATCH), including bulk updates of many items.
`directus__delete`	delete	Deletes one or many items through the Directus REST API.

The tools return content, not metrics, so there is no dashboard for them. Other Ryze AI tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Search Console MCP.

03 · Use cases

Prompts for a Directus blog

Ryze AI SEO publishes Content Plan articles into your collection. The prompts below read that content back, fix fields in bulk and clean up, and they work in Claude, ChatGPT or Cursor. Every answer comes from your own instance, so no sample numbers are shown here.

Read and audit

“List the fields of the articles collection and tell me which ones are empty on published items.”
“Show items in the posts collection that have no meta description. Do not change anything yet.”
“Read the server info for our instance and list the flows that are set up.”

Edit on approval

“Update the meta description on these 5 items with the text I paste, and show each change first.”
“Bulk update the status of the items I list to draft.”
“Create a new item in the articles collection from the outline above, in the en translation.”

Content Plan articles

“Check which Content Plan articles reached the Directus collection this week.”
“Compare the titles in the collection with the Search Console queries I paste and list the gaps.”
“List published items that are missing a translation for the language code I name.”

Cleanup (delete on approval)

“Find duplicate items by slug and list them. I will confirm each one before anything is deleted.”
“Delete the test items I name, after showing me their IDs.”
“Show files that no item references, so I can decide what to remove.”

Article publishing follows Publishing mode in SEO, Preferences, Publishing: Automatic (the default) or Manual.

04 · Setup

Connect Directus once, then add the URL to each client

Step 1: generate a token in Directus

01In Directus open the User directory and pick or create a user whose role can read and write the blog collection.
02On that user find Token, click Generate, copy the token and save the user. A token without a saved user is rejected, and Directus shows it only once.

Step 2: connect Directus in Ryze AI

01In Ryze AI open Integrations and click Connect on the Directus card.
02Enter the Instance URL (the Data Studio origin with https:// and nothing after the domain), the static access token and the Blog URL, then click Continue.
03Pick the collection articles publish to. For a collection that uses Directus translations, set the Language code; it defaults to en.

Details and fixes are in the Ryze AI Directus guide. You can also start from inside Claude or ChatGPT with a one-time connection link.

Step 3: Claude on the web or desktop

01Go to Customize, Connectors.
02Click + Add, then Add custom connector. Enter Ryze AI as the name and https://connector.get-ryze.ai/mcp as the URL, then click Continue. Do not choose No sign in: the server uses OAuth.
03Click Add, then Connect. Sign in to Ryze AI, choose the workspace that holds Directus and click Allow connection.
04Start a new chat. Claude keeps the tool list from the moment the connector is added, so if you connected Directus afterwards, remove the connector, add it again and open a new chat.

Anthropic lists custom connectors for Free, Pro, Max, Ultra, Team and Enterprise, and Free holds one. On Team an Owner adds the connector under Organization settings, Connectors, and each member then clicks Connect. On Enterprise an Owner or a role with Manage access to Libraries can add it.

ChatGPT

OpenAI documents custom MCP servers on ChatGPT web for Business and Enterprise/Edu, where an admin or owner creates and publishes it, and for Pro with read and fetch permissions only, so Pro cannot run the write and delete tools. Go to Plugins, choose the plus button, then Add custom MCP server, name it Ryze AI, enter the URL, set authentication to OAuth, accept the risk warning, create it and sign in to Ryze AI. After connecting Directus later, refresh or remove and re-add it.

Claude Code

Terminalbash

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user

Run /mcp, select ryze and sign in, or run claude mcp login ryze. Anthropic lists Claude Code on Pro, Max, Ultra, Team, Enterprise and Console accounts, not the free plan.

Cursor

.cursor/mcp.jsonjson

{ "mcpServers": {
  "ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }

Put it in ~/.cursor/mcp.json for all projects or .cursor/mcp.json for one. Cursor runs OAuth and asks for approval before using MCP tools by default. The developer page has an Add to Cursor link.

05 · Permissions

Who can connect, and what the token reaches

Who can connect	Anyone in the workspace who has the Instance URL, the Blog URL and a static token from a Directus user. In Directus the token is created on that user's profile.
Which role	Pick or create a user whose role can read and write the blog collection. The token inherits the same permissions as its user, so collections that role cannot see are not available to the agent.
How the token behaves	Directus says a static token does not expire, is shown once and is stored in plain text in the directus_users collection. Use a dedicated user and rotate the token if it leaks.
Removing access	In Ryze AI open View on the Directus card and use the trash icon. In Directus, clear or regenerate the token on the user. In Claude, open Customize, Connectors, Ryze AI and click Disconnect.

Capability	Directus role needs	Where it shows up
Read items	Role can read the blog collection	directus__read on items in that collection
Create and update items	Role can create and update the blog collection	directus__write, and Content Plan publishing
Delete items	Role can delete in the collection	directus__delete; leave it off the role if you never want removals
Read collections and fields	Role can read the collections and fields it needs	The collection picker in Ryze AI and schema questions
Files and flows	Role has read access to files or flows	File and flow questions through directus__read

Static token behavior from the Directus tokens guide; the table is a plain reading of how role permissions apply, checked Nov 8, 2026. Directus does not issue scopes on a static token: the user’s role is the limit.

06 · Compare

Ryze AI vs the Directus MCP server

What is called Directus MCP

Option	Built for	How you connect	Data it reaches	Changes
Ryze AI hosted server	Marketers who publish articles to Directus and want edits from Claude, ChatGPT or Cursor	Static token in Ryze AI, then OAuth sign-in from the client	Items, collections, fields, files, users, flows, server info	Create, update, bulk update, delete
Directus remote MCP server (v11.12+)	Teams that want the assistant to work inside Directus	Enable MCP in Settings, AI, then generate a token for a dedicated MCP user	Collections, items, schema, fields, relations, files, assets, flows, operations, folders	Full item CRUD, schema and file management within that user's permissions
Directus Local MCP	Older Directus versions, which the docs point to when the remote server is unavailable	A local server	Depends on the local server	Depends on the local server
Community servers on GitHub	Developers who self-host	Varies by repo	Not reviewed for this page	Not reviewed for this page

Source: the Directus MCP guide and its tools page, opened Nov 8, 2026. Community servers were not reviewed for this page.

Ryze AI and Directus remote MCP side by side

	Ryze AI	Directus remote MCP
Who sets it up	Whoever holds a Directus token connects it in Ryze AI, then adds one URL to each client	An admin enables MCP in Directus Settings and creates a dedicated MCP user
Where it runs	Hosted by Ryze AI, connects to your instance through the Instance URL	Served by your Directus instance
Permission model	The token's user role	The connected user's Directus permissions plus the project MCP settings
Tools	3: read, write, delete	12, including schema, fields, relations, assets, flows and operations
Schema changes	Not in the Ryze AI tool list	Collections, fields and relations can be managed
Publishing	Content Plan articles publish into the chosen collection, with a language code for translations	No article pipeline
Other data in the same chat	Google Ads, Meta Ads, Search Console and the other Ryze AI platforms on one URL	Directus only
Version needed	Not stated; uses the REST API with a static token	Directus v11.12 or newer
Price	Any Ryze AI plan or trial. SEO Starter $129/mo, 3-day free trial	No plan limits stated in the Directus docs

As published on Nov 8, 2026. Directus changes its MCP server between releases, so check its tool list before you decide.

Which to pick: if you model data inside Directus (collections, fields, relations, flows), its own server has the tools for it and runs inside your instance. If the job is publishing articles into a collection, editing items in bulk and asking about them next to your search and ad data, Ryze AI fits, and it needs no Directus upgrade because it uses the REST API with a token.

07 · API limits

Directus limits an agent runs into

Rate limiter	Directus ships with the rate limiter off (RATE_LIMITER_ENABLED false). When on, the default is 50 points per 1 second. A self-hosted admin sets these values, and a managed instance may differ.
Default page size	QUERY_LIMIT_DEFAULT is 100 items when a request sets no limit, so a long list needs paging or an explicit limit.
Maximum page size	QUERY_LIMIT_MAX is -1 by default, which means no cap unless the admin sets one.
Batch mutations	MAX_BATCH_MUTATION defaults to Infinity. An admin can cap how many items one bulk request may change.
Payload size	MAX_PAYLOAD_SIZE defaults to 1mb, which bounds a single write body.
Relational depth	MAX_RELATIONAL_DEPTH defaults to 10 levels for nested fields in one request.
Permissions	A request only returns what the token's role can read, so an empty list can mean a permission gap rather than no items.
Client plans	Claude: any plan, with one custom connector on Free. ChatGPT: custom MCP servers per OpenAI, see section 04. Cursor: no plan named.

Defaults from the Directus limits and rate limiter reference, checked Nov 8, 2026. Each is an environment setting, so your instance may use other values.

08 · Approvals and safety

How you keep control of edits

Approvals in Claude

Under Customize, Connectors, Ryze AI, Tool permissions, set each tool. The Ryze AI help center recommends Needs approval for write and delete tools. Claude then shows each change and waits.

Approvals in the Ryze AI app

The Tool approvals picker in the Ryze AI chat defaults to Skip all approvals. Switch to Approve write & delete or Manual approve in the message box; the choice is remembered in that browser.

Delete kept separate

Only directus__delete removes items, so you can allow edits and keep removals on approval.

Use a dedicated user

The static token follows its user's role and does not expire. Create a user just for Ryze AI and give its role only the collections it needs.

Publishing mode

Content Plan articles follow Publishing mode in SEO, Preferences, Publishing: Automatic (default) or Manual.

Policies

Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.

09 · Errors and fixes

Directus MCP errors and what to do

Message or symptom	Cause	Fix
Token rejected	The token was generated but the Directus user was not saved afterwards.	Open the user, generate the token again, save the user, then paste the new token.
No collections visible	The token's role has no read access to the collections.	Grant read access in Directus, then reconnect in Ryze AI.
The blog collection is missing from the picker	The role cannot see that collection.	Update the role permissions and reconnect.
Instance unreachable	The Instance URL is not the Data Studio origin, or it lacks https://.	Use the https:// origin with nothing after the domain, for example https://your-project.directus.app.
Directus tools are not in Claude or ChatGPT	Directus was connected after the connector was added, and the client kept the old tool list.	Remove the Ryze AI connector, add it again and start a new chat.
A connection link is refused	The workspace already has a Directus connection.	Open View on the Directus card, disconnect with the trash icon, then connect again.
Requests work in the browser but fail from Ryze AI	The instance sits behind a proxy that needs a custom request header.	Email Ryze AI support; the header is added to the connection on request, not in the connect dialog.
Tools do not answer	The workspace has no active Ryze AI plan or trial.	Start a plan or trial under billing, then retry.
Lists stop at 100 items	Directus applies QUERY_LIMIT_DEFAULT when a request names no limit.	Ask the agent to page through or request a larger limit.
A write fails with a permission error	The token's role cannot create or update that collection.	Add the permission to the role in Directus.

The first six rows come from the Ryze AI help center and connector behavior; the last four follow from Directus defaults and permissions. More answers are in the Ryze AI Directus guide.

10 · FAQ

Directus MCP server questions

What is a Directus MCP server?

An MCP server lets AI clients such as Claude, ChatGPT and Cursor call Directus through tools. Directus runs its own remote MCP server from v11.12 for teams that want an assistant inside their instance. Ryze AI runs a hosted one with 3 Directus tools (read, write and delete) on the same URL as its other platform tools.

Does Directus have an official MCP server?

Yes. The Directus docs describe a remote MCP server that requires Directus v11.12 or newer. You enable MCP in Settings, AI, and generate an access token for a dedicated MCP user. It lists 12 tools covering items, schema, fields, relations, files, assets, flows, operations and folders. Directus also documents a Local MCP option for older versions.

What is the Directus MCP server URL?

The Ryze AI server is https://connector.get-ryze.ai/mcp, the same for every account. Your Directus instance details never go into the client: you enter the Instance URL, the static token and the Blog URL in Ryze AI, not in Claude or ChatGPT.

How do I set up a Directus MCP server in Claude?

Generate a static token on a Directus user and save the user. In Ryze AI open Integrations, click Connect on the Directus card and enter the Instance URL, token and Blog URL. Then in Claude open Customize, Connectors, Add custom connector, paste https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat. Claude caches the tool list, so remove and re-add the connector if Directus was connected after it. Every client is covered in the setup section.

Is the Directus MCP connection free?

Adding the Ryze AI connector costs nothing, but the Directus tools need any active Ryze AI plan or trial. SEO Starter is $129/mo with a 3-day free trial, Paid Ads is $89/mo with a 7-day free trial and Agency is $279/mo, with 30% off the first year on annual billing. The Directus docs state no plan limit for their own MCP server. See the pricing page.

Can the AI create, update or delete Directus items?

Through Ryze AI, directus__write creates and updates items with POST or PATCH requests, including bulk updates of many items, and directus__delete removes one or many items. In Claude, set write and delete tools to Needs approval so each change waits for you. Access is limited to what the token's role can do.

Which Directus permissions does the token need?

The token belongs to a Directus user and carries that user's role permissions. The role must be able to read and write the collection that articles publish to. Collections the role cannot see are not available, and a token generated without saving the user afterwards is rejected.

Can I connect more than one Directus instance?

A workspace holds one Directus connection. To switch, click View on the Directus card, disconnect with the trash icon and connect again. A one-time connection link is refused while a Directus connection already exists in the workspace. Agencies can keep a separate workspace per client.

How do translations work?

For a collection that uses Directus translations, you set a language code when you pick the collection, and it defaults to en. Articles publish into that translation. A single-language collection ignores the code.

What are the Directus API limits for an MCP connection?

Directus documents these defaults: the rate limiter is off, and when on it allows 50 points per second; a request without a limit returns 100 items; there is no maximum page size and no bulk mutation cap unless an admin sets one; request bodies are limited to 1mb. A self-hosted admin can change them, and a managed instance may differ.

What if my Directus instance sits behind a proxy?

If the proxy needs a custom request header, Ryze AI support can add it to the connection. It is not a field in the connect dialog, so email Ryze AI support with the header name and value you need.

Which Directus MCP should I pick, Ryze AI or the one built into Directus?

Ryze AI is the best Directus MCP option for publishing articles into a collection and editing items from the same chat as your ad and search tools, though its 3 tools are documented for items, not schema changes. Directus's own server has 12 tools, including collections, fields, relations and flows, so it fits data modeling inside the instance.

11 · Compatibility

Where the Directus tools run

Claude (web & desktop)01

Claude Code02

ChatGPT03

Cursor04

Any remote MCP client with OAuth05

12 · Related

Other integrations and guides

Sources and changelog

Page checked Nov 8, 2026. First version. Ryze AI details come from the Ryze AI Directus guide and the Ryze AI connector setup. The tool names come from the Ryze AI app source and were not seen in a live session. Claude, ChatGPT and Cursor details come from Anthropic, OpenAI and Cursor.

Directus facts: the MCP guide, its tools page, the tokens guide and the limits reference.

Directus MCP server: manage Directus content from Claude and ChatGPT

Ask your Directus content questions, then approve any change

Nine jobs for a Directus blog

Find items with missing fields

Check what Content Plan published

Spot missing translations

Match titles to search queries

Update many items at once

Read fields and collections

Review the file library

See which flows exist

Remove test and duplicate items