Mcp Help | Directus Docs

You landed here because you opened the Directus docs MCP server in a browser. The server itself speaks the Model Context Protocol. Connect a compatible AI client to it and your assistant can search and read these docs as a live tool.

This is the docs MCP server, which exposes this documentation site to AI clients. If you want to connect AI tools to your own Directus instance to manage content and schema, see the Directus product MCP guide instead.

Server URL

https://directus.io/docs/mcp

Transport: streamable HTTP. No authentication required.

Install in one click

Add to Cursor

Opens Cursor and registers the docs MCP server.

Add to VS Code

Opens VS Code and registers the docs MCP server.

Manual setup

For clients without a one-click installer, add the server to your MCP config.

Claude Code

claude mcp add --transport http directus-docs https://directus.io/docs/mcp

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "directus-docs": {
      "type": "http",
      "url": "https://directus.io/docs/mcp"
    }
  }
}

Codex / Windsurf / other HTTP-MCP clients

Point them at https://directus.io/docs/mcp with transport set to http (sometimes called streamable-http).

Available tools

Tool	Inputs	Use it for
`list-docs`	`pathPrefix?`, `limit?`	Discover available docs pages when you do not know exact paths.
`get-doc`	`path`	Fetch a single page's full markdown by path (e.g. `/getting-started/overview`).
`search-docs`	`query`, `section?`, `framework?`, `limit?`	Full-text search across the docs. Returns ranked results with title, snippet, and section.
`search-directus-code`	`query`, `repo?`, `language?`, `path?`, `limit?`	Search source code across allowlisted Directus GitHub repos.
`get-directus-file`	`repo?`, `path`, `ref?`, `offset?`, `bytes?`	Fetch source files from allowlisted Directus GitHub repos.

Try it

After connecting, ask your AI client questions like:

"Search the Directus docs for OAuth setup."
"Get the docs page on configuring the SDK in Nuxt."
"List all guides in the data-model section."
"How do I create a flow in Directus? Use the docs MCP."

The assistant should call search-docs or list-docs, then get-doc to read the relevant page.

Troubleshooting

Connection refused or 404 - confirm the URL is exactly https://directus.io/docs/mcp (note the /docs prefix).
Tools not showing up - restart your MCP client after adding the server. Some clients only load tools at startup.
Search returns nothing - search-docs is case-insensitive but does keyword match. Try fewer or broader terms.

Found a bug? Report it at github.com/directus/docs/issues.

Get once-a-month release notes & real‑world code tips...no fluff. 🐰

Security Best Practices

Harden a Directus project.

Releases

Releases are how we roll out new features, updates, and fixes to Directus.

Docs MCP Server