Directus CMSガイド：開発者のためのデータベースファースト・ヘッドレスCMS

Directus CMSガイド：開発者向けデータベースファーストのヘッドレスCMS

多くのヘッドレスCMSでは、データモデルをシステム内で構築する必要があります。Directusはその逆で、既存のSQLデータベースをラップし、スキーマに一切触れることなく、即座にREST APIとGraphQL APIを提供します。約34.5kのGitHubスターを獲得し、Tripadvisor、Adobe、Mercedes-Benzといった企業に採用されているDirectusは、2026年最高のヘッドレスCMSオプションの中でも、最も高機能なオープンソースの一つです。

Directus CMSとは？

Directusは、既存のあらゆるSQLデータベースを瞬時にREST APIとGraphQL APIでラップするオープンソースのヘッドレスCMSです。StrapiやPayloadとは異なり、Directusは独自のデータベーススキーマを作成せず、あなたのスキーマをそのままミラーリングします。PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB、MS-SQLを含む7つのデータベースをサポートしており、Directusの公式ドキュメントによると、年間収益500万ドル未満の組織には無料で提供されています。

これは、データベースの上に載るスマートなレイヤーのようなものだと考えてください。既存の50テーブルを持つPostgreSQLデータベースを用意し、Directusをそこに接続すれば、数分以内に管理画面UI、ロールベースのアクセス制御、そしてRESTとGraphQLのエンドポイントがすべて手に入ります。マイグレーションスクリプトも不要、データの再構築も不要です。

これこそが「データベースファースト」が実際に意味するものであり、Strapiのようにコードファーストなアプローチ（コンテンツタイプを定義するとデータベーステーブルが生成される仕組み）や、Payload CMSのようなフレームワーク組み込み型のアプローチ（CMSがNext.jsアプリ内に存在する仕組み）とは根本的に異なります。

データベースファーストアーキテクチャとは

クライアントのプロジェクトで既存のPostgreSQLデータベースにDirectusを初めて接続したとき、セットアップの手軽さに驚きました。Directusはデータベーススキーマを自動的に解析し、テーブルは「コレクション」、カラムは「フィールド」として読み取り、既存の構造から管理画面を構築します。

つまり、データが独自のフォーマットに閉じ込められることは決してありません。明日Directusを使うのをやめたとしても、データベースは標準的なSQLデータベースのままです。コンテンツが他社のサーバーに他社のフォーマットで保存されるContentfulやSanityで、同じことができるでしょうか。

また、Directusは単なるCMSではありません。開発チームはこれをコンポーザブルなデータプラットフォームと位置づけており、BaaS（Backend as a Service）、社内向け管理画面、カスタムダッシュボードなどにも活用されています。CMSとしての用途が最も人気ですが、このアーキテクチャはそれ以上の可能性を秘めています。

Directusの主な機能

Directusは、RESTとGraphQLのデュアルAPI、きめ細かなロールベースの権限管理、組み込みのFlowsオートメーション、ドラッグ&ドロップ対応のData Studio、デジタルアセット管理、50以上の言語に対応するネイティブなi18nサポートを提供します。v11.15以降、共同編集とAI Assistantがサードパーティ製プラグインではなくネイティブ機能として搭載されています。

プロジェクトでDirectusを検討する際に最も重要なポイントは以下の通りです。

デュアル REST / GraphQL API

どちらの API も、同じデータから設定ゼロで同時に利用できます。どちらか一方を選ぶ必要はなく、両方を手に入れられます。モバイルチームは REST を、Web フロントエンドは GraphQL を使う、といった使い分けが可能です。REST API は予測しやすいパターン（/items/{collection}）に従い、GraphQL のエンドポイントは /graphql に配置されています。

Flowと自動化

FlowはDirectusのイベント駆動型自動化システムで、Data Studio UIに直接組み込まれています。CRUDイベント（アイテムの作成、更新、削除）、スケジュール（cron形式）、またはWebhookをきっかけにワークフローを発動できます。操作には、メールの送信、HTTPリクエストの実行、カスタムJavaScriptの実行、データの変換などが含まれます。

AIを活用して構築するチームのために、DirectusにはネイティブのModel Context Protocol (MCP)ガイドサーバーも用意されていますが、その詳細はv11のセクションで触れます。

拡張機能とカスタマイズ

拡張機能システムは、フック(サーバーサイドのイベントハンドラー)、カスタムエンドポイント、UIパネル、完全なモジュール、そしてFlows用のオペレーションノードをサポートしています。拡張機能は、フロントエンドにはVue.js、バックエンドにはプレーンなNode.jsを使用して構築されています。v11.0リリースでは、拡張機能はタイプ別のフォルダ構成から、よりクリーンなバンドル形式へと再構築されました。

機能面でのDirectusと競合他社の比較は以下のとおりです。

Directus v11の新機能（2025〜2026年）

Directus v11では、ネイティブなMCPサーバーサポート（v11.13）、OpenAI・Anthropic・Geminiに対応したAIアシスタント（v11.14）、ライブプレゼンスインジケーター付きの共同編集（v11.15）、ロールベースのデプロイ権限を備えたグローバルなドラフトバージョン（v11.16）が導入されました。これらはすべて、コミュニティの拡張機能ではなく組み込み機能です。

ここはDirectusが最も急速に進化している領域であり、競合のほとんどが完全に見落としているセクションでもあります。上位6つのランキングガイドの中で、これらの内容に触れているのはわずか1つだけです。

MCPサーバーとAIアシスタント

v11.13リリースにより、DirectusはネイティブなMCPサーバーを備えた最初のCMSの1つとなりました。Claude、ChatGPT、またはMCP互換のAIツールを使用している場合、RBAC権限を尊重しながら、コレクションの読み取り、アイテムの作成、フィールドの更新など、Directusのコンテンツを直接管理できます。MCPを初めて使用する方は、Model Context Protocol (MCP)ガイドでこのプロトコルについて詳しく解説しています。

AIアシスタント（v11.14）はMCPとは別のもので、Data Studio内に組み込まれたチャットインターフェースであり、OpenAI、Anthropic、Gemini、さらにはOllamaを通じたローカルモデルにも対応しています。v11.16ではマルチモーダル対応となり、画像やPDFをAIチャットに直接アップロードして処理できるようになりました。

共同編集とドラフトバージョン

v11.15で共同編集がリリースされ、ライブプレゼンスインジケーター（同じアイテムを編集中の他のユーザーを確認可能）と、競合を防ぐフィールドレベルのロックが搭載されました。同じリリースでは、ロールベースのデプロイ権限を備えたVercelデプロイモジュールも追加されました。

v11.16では、グローバルドラフトバージョンによりコンテンツステージングがさらに強化されました。バージョン管理対象のすべてのアイテムに、自動的にドラフトコピーが作成されます。編集者はライブバージョンと比較しながら変更をプレビューし、準備が整った時点でドラフトを本番に昇格させることができます。ロールベースのデプロイ権限により、コンテンツチームは誤って本番環境にプッシュすることなく、変更をステージングできます。

Directus のはじめ方（Docker セットアップ）

Docker を使えば、2 分もかからずに Directus をローカルで実行できます。directus/directus イメージを使って docker-compose.yml ファイルを作成し、データベース接続と管理者の認証情報を環境変数として設定して、docker compose up を実行するだけです。Directus は localhost:8055 で起動します。

Docker のセットアップは、コールドスタートから 2 分かかりませんでした。以下は、Directus コンテナだけでなく PostgreSQL も含めた、スタック全体の完全な docker-compose.yml です：

# docker-compose.yml
version: "3"
services:
  database:
    image: postgis/postgis:16-3.4-alpine
    environment:
      POSTGRES_USER: directus
      POSTGRES_PASSWORD: directus
      POSTGRES_DB: directus
    volumes:
      - directus_data:/var/lib/postgresql/data

  directus:
    image: directus/directus:11.16
    ports:
      - "8055:8055"
    depends_on:
      - database
    environment:
      KEY: "your-random-key-here"
      SECRET: "your-random-secret-here"
      ADMIN_EMAIL: "[email protected]"
      ADMIN_PASSWORD: "change-me-please"
      DB_CLIENT: "pg"
      DB_HOST: "database"
      DB_PORT: "5432"
      DB_DATABASE: "directus"
      DB_USER: "directus"
      DB_PASSWORD: "directus"
    volumes:
      - directus_uploads:/directus/uploads

volumes:
  directus_data:
  directus_uploads:

Run it:

docker compose up -d

http://localhost:8055 を開き、設定した管理者認証情報でログインすると、Data Studio に入れます。ここからコレクション（テーブル）の作成、フィールド（列）の定義ができ、すぐにコンテンツの管理を始められます。環境変数 KEY と SECRET は JWT トークンの生成に使用されるため、本番環境では上記のプレースホルダーではなくランダムな文字列を使用してください。

Directus SDK によるデータの取得

Directus JavaScript SDK は、REST と GraphQL の両方を通じてデータへの型安全なアクセスを提供します。@directus/sdk をインストールし、createDirectus() でクライアントを作成して、readItems() を使用すれば、フィルタリング、ソート、フィールド選択を備えたコレクションの取得が可能です。

Supabase のクライアントのようなライブラリを使った経験があれば、SDK のコンポーザブルなパターンは直感的に感じられるでしょう。ベースとなるクライアントから始め、関数を組み合わせることで機能を追加していきます。

// lib/directus.ts
import { createDirectus, rest, readItems, createItem } from '@directus/sdk';

const client = createDirectus('http://localhost:8055').with(rest());

// Fetch published articles with specific fields
const articles = await client.request(
  readItems('articles', {
    fields: ['id', 'title', 'slug', 'content', 'author.name'],
    filter: {
      status: { _eq: 'published' }
    },
    sort: ['-date_published'],
    limit: 10
  })
);

アイテムの作成も同じパターンに従います。

// Create a new article
const newArticle = await client.request(
  createItem('articles', {
    title: 'My New Post',
    slug: 'my-new-post',
    content: '<p>Hello from Directus.</p>',
    status: 'draft'
  })
);

認証には、staticToken()（サーバー間通信向け）と authentication()（ログインフローを備えたユーザー向けアプリ向け）のいずれかを選択します。

import { createDirectus, rest, staticToken } from '@directus/sdk';

// Server-side with static token
const client = createDirectus('http://localhost:8055')
  .with(staticToken('your-api-token'))
  .with(rest());

REST API の例

すべての SDK メソッドには、対応する REST エンドポイントがあります。curl や fetch を直接使用したい場合は、以下のようにします:

# 公開済み記事の取得
curl "http://localhost:8055/items/articles?filter[status][_eq]=published&sort=-date_published&limit=10&fields=id,title,slug"
# 新規アイテムの作成
curl -X POST "http://localhost:8055/items/articles" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "My Post", "status": "draft"}'

GraphQLクエリ

同じデータは /graphql のGraphQLから取得できます:

query {
  articles(
    filter: { status: { _eq: "published" } }
    sort: ["-date_published"]
    limit: 10
  ) {
    id
    title
    slug
    content
    author {
      name
    }
  }
}

GraphQLを別途設定・有効化する必要はありません。RESTと併せていつでも利用できます。

Directus と Next.js（フレームワーク連携）

Directus を Next.js に接続するには 3 つの手順が必要です。@directus/sdk をインストールし、lib/directus.ts クライアントを作成し、Server Components 内で readItems() を使ってデータを取得します。Directus は生の JSON を返すため、ベンダー固有のコンポーネントに縛られることなく、レンダリングを完全にコントロールできます。

これは Directus を扱う中で最もクリーンな部分です。特別なフレームワークアダプターも、Directus 専用の React コンポーネントも、ビルドプラグインもありません。ただのデータ取得です。Next.js で REST API を扱った経験があれば、すでにやり方はご存知のはずです。フレームワーク選びの背景については、Next.js vs Remix の比較をご覧ください。

まず、共有クライアントを作成します（これは SDK セクションと同じファイルですが、デプロイ済みインスタンス向けに設定しています）。

// lib/directus.ts
import { createDirectus, rest, staticToken, readItems } from '@directus/sdk';

const directus = createDirectus(process.env.DIRECTUS_URL!)
  .with(staticToken(process.env.DIRECTUS_TOKEN!))
  .with(rest());

export default directus;
export { readItems };

次に、Server Component で使用します。useEffect もローディング状態も不要で、ただ async/await するだけです。

// app/blog/page.tsx
import directus, { readItems } from '@/lib/directus';

export default async function BlogPage() {
  const posts = await directus.request(
    readItems('posts', {
      fields: ['id', 'title', 'slug', 'excerpt', 'date_published'],
      filter: { status: { _eq: 'published' } },
      sort: ['-date_published'],
    })
  );

  return (
    <main>
      <h1>Blog</h1>
      {posts.map((post) => (
        <article key={post.id}>
          <h2><a href={`/blog/${post.slug}`}>{post.title}</a></h2>
          <p>{post.excerpt}</p>
          <time>{post.date_published}</time>
        </article>
      ))}
    </main>
  );
}

以上です。ベンダーロックインはありません。同じアプローチは、Astro、Nuxt、SvelteKit、あるいは HTTP リクエストを送れる任意のフレームワークで機能します。Directus の公式ドキュメントには Astro や Nuxt 向けのフレームワーク固有ガイドも掲載されていますが、パターンは同じです。クライアントを作成し、readItems() を呼び出し、レンダリングする。それだけです。

Directus CMS の料金とライセンス (2026年)

Directus は、年間収益または調達資金が 500 万ドル未満の組織であれば、MIT ライセンスのもとでセルフホスティングが無料です。500 万ドルを超える場合、本番環境での利用には商用ライセンスが必要です。料金ページによると、Directus Cloud は月額 25 ドル（Starter）から始まり、Professional プランは月額 49 ドル〜499 ドルとなっています。

年間収益500万ドルのライン

これはDirectusに関するビジネス上の事実として最も重要かつ単一のものであり、多くのガイドでは埋もれているか、完全に省略されています。仕組みは次のとおりです。

• 年間収益または累計調達額が500万ドル未満の場合： 永久に無料。MITライセンス。どこにでもセルフホスト可能。機能制限なし。
• 本番環境で500万ドルを超える場合： 商用ライセンスが必要です。価格についてはDirectusの営業にお問い合わせください。
• 開発およびテスト： 企業規模に関係なく常に無料。このラインが適用されるのは本番環境へのデプロイのみです。

500万ドルという数字には、収益だけでなくベンチャーキャピタルからの調達額も含まれます。そのため、600万ドルを調達したシードステージのスタートアップは、技術上このラインを超えることになります。実際には、Directusはアーリーステージの企業に対して厳格に適用してはいませんが、計画を立てる際にはこの点を考慮に入れるべきです。

クラウドプラン

インフラの管理をしたくない場合、Directus Cloud がホスティング、バックアップ、アップデートを代行します。

• Starter: 月額25ドル、小規模プロジェクトや個人サイトに最適
• Professional: 月額49ドル〜499ドル、ストレージ、帯域幅、アセット変換に応じてスケール
• Enterprise: カスタム料金、SLA、専用インフラ、優先サポート

シート単位のライセンスはありません。チーム全員が同じプランを利用できます。ユーザーごとに課金する Contentful（Contentful の料金内訳を参照）や、API 使用量とデータセットの帯域幅に基づいて課金する Sanity と比較してみてください。

Directus vs Strapi vs Payload：3者の比較

Directusは既存のデータベースを移行なしでラップし、Strapiはコンテンツタイプから独自のスキーマを生成し、PayloadはNext.jsアプリに直接組み込まれます。Directusは7つのデータベースをサポートし、Strapiは2つ、Payloadも2つをサポートしています。3つともオープンソースですが、その思想はかなり異なります。

StrapiとDirectusの両方でプロジェクトを構築してきた経験から言えば、最大の違いはデータベースに対する考え方です。Strapiでは、管理UIまたはコードでコンテンツタイプを定義すると、Strapiがデータベーステーブルを作成・管理してくれます。Directusでは、データベースこそが信頼できる唯一の情報源であり、Directusはそれを読み取って適応します。

Directusを選ぶべきケース： 既存のデータベースがある場合、すぐに使えるREST+GraphQLの両方が必要な場合、あるいはOracleDBやCockroachDBのような一般的でないデータベースをサポートする必要がある場合。

Strapiを選ぶべきケース： 最大のエコシステムとコミュニティを求める場合、UIでコンテンツタイプを定義したい場合、あるいは既存のデータベースがなくゼロから始める場合。詳細はStrapi完全ガイドをご覧ください。

Payloadを選ぶべきケース： CMSをNext.jsアプリケーションに直接組み込みたい場合、TypeScriptファーストな設定を好む場合、あるいはHTTPを完全にスキップするLocal APIが必要な場合。全体像はPayload CMS徹底解説をご覧ください。

Directusを使うべきでないケース

ビジュアルページビルダー、Next.jsフレームワークとの緊密な統合、NoSQLバックエンドが必要な場合、Directusは適切な選択肢ではありません。また、フラットファイルCMSやWordPressで十分なシンプルなプロジェクトにとっても、余分な負担となってしまいます。

本来Directusを選ぶべきでないチームが選んでしまった例をいくつも見てきましたが、そのパターンはたいてい次のいずれかです。

• ビジュアルページビルダーが必要。 DirectusのData Studioは構造化データの管理には優れていますが、ドラッグ＆ドロップのサイトビルダーではありません。ビジュアル編集が最優先なら、Storyblokを検討してください。比較についてはStoryblokガイドをご覧ください。
• NoSQLにこだわっている。 Directusは設計上SQL専用です。データがMongoDBにあるなら、Payload CMSが自然な選択肢です。
• プロジェクトがシンプルなブログである。 個人ブログのためにDocker、PostgreSQL、Directusを立ち上げるのは、はっきり言ってやりすぎです。WordPress、Markdownファイルを使ったAstro、あるいはGhostなら、はるかに短い時間で公開にこぎ着けられます。
• フレームワーク内のCMSが欲しい。 CMSをNext.jsのコードベース内に第一級の存在として組み込みたいなら、Payloadはこれをネイティブに実現します。Directusは常に独立したサービスです。
• 大規模な組織である。 会社の収益が500万ドルの基準を超えると、本番環境での商用ライセンスが必要になります。StrapiやPayloadのような完全なオープンソースの代替手段なら、収益に関係なくセルフホスティングは無料です。そのコストを比較検討してください。

これらはどれも欠点ではなく、設計上の判断です。Directusはデータプラットフォームであり、ウェブサイトビルダーではありません。この違いを理解しておくことで、何か月もの無駄な苦労を避けられます。

よくある質問

Directus CMSとは？

Directusは、既存のSQLデータベースを瞬時にRESTおよびGraphQL APIでラップするオープンソースのヘッドレスCMSです。PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB、MS-SQLに対応しています。従来のCMSとは異なり、Directusは独自のスキーマを作成せず、既存のデータベース構造を自動的に読み取り、ミラーリングします。

Directus は本当に無料？

Directus は、年間収益または資金調達総額が 500 万ドル未満の組織であれば、MIT ライセンスのもとでセルフホスティングによる利用が無料です。この基準を超える場合、本番環境での利用には商用ライセンスが必要です。開発・テスト環境は常に無料で利用できます。マネージドホスティングの Directus Cloud は月額 25 ドルから提供されています。

DirectusはStrapiとどう違うのですか？

Directusはデータベースファーストであり、既存のSQLデータベースをスキーマを変更せずにラップします。Strapiはコードファーストであり、コンテンツタイプを定義するとStrapiがデータベーステーブルを生成します。Directusは7つのデータベースをサポートしているのに対し、Strapiは2つをサポートしています。どちらもREST APIを提供していますが、DirectusはネイティブなGraphQLを備えているのに対し、Strapiではプラグインが必要です。

Directusはどのデータベースに対応していますか？

Directusは7つのSQLデータベースに対応しています。PostgreSQL、MySQL、MariaDB、SQLite、OracleDB、CockroachDB、MS-SQLです。既存のデータベースに接続し、スキーマを自動的に解析します。このマルチデータベース対応はヘッドレスCMSの中でもユニークであり、競合製品の多くは1つか2つのデータベースエンジンにしか対応していません。

DirectusはWordPressの代わりになるか？

Directusは、特にヘッドレスまたはAPI主導のプロジェクトにおいて、コンテンツ管理の面でWordPressの代わりになり得ます。ただし、Directusにはフロントエンド、テーマ、ページビルダーが組み込まれていません。Next.jsやAstroなどのフレームワークを使って、独自のフロントエンドを構築する必要があります。シンプルなブログやビジュアル編集が必要なサイトには、WordPressの方が依然として実用的です。

Directusにはビジュアルエディターがありますか？

DirectusにはData Studioが含まれています。これは構造化データの管理、ダッシュボードの構築、権限の設定を行うための強力な管理UIです。ただし、StoryblokやWordPressのようなビジュアルページビルダーやWYSIWYGサイトエディターは備えていません。Directusはドラッグ＆ドロップによるページ構成ではなく、データ管理を目的として設計されています。

Directus は EC に適していますか？

Directus は商品情報管理（PIM）システムとして十分に機能します。商品カタログのモデリング、属性の管理、API 経由でのデータ配信が可能です。ただし、Directus は EC プラットフォームではありません。ショッピングカート、決済フロー、決済処理といった機能は備わっていません。トランザクション層には Shopify、Saleor、Medusa などを組み合わせて利用してください。

Directus は Next.js で使えますか？

はい。@directus/sdk パッケージをインストールし、Directus インスタンスを指すクライアントを作成して、Server Components 内で readItems() を使ってデータを取得します。Directus はプレーンな JSON を返すため、ベンダー固有の React コンポーネントは必要ありません。同じ方法は、Astro、Nuxt、SvelteKit など、あらゆる JavaScript フレームワークで機能します。

Directus は共同編集をサポートしていますか？

はい。バージョン 11.15（2026 年 2 月）以降、サポートしています。Directus にはネイティブの共同編集機能が備わっており、誰が何を編集しているかを示すライブプレゼンスインジケーターと、競合を防止するためのフィールドレベルのロックが利用できます。これはプラグインではなく、組み込みの機能です。v11.16 のグローバルドラフトバージョンと組み合わせることで、チームは公開前の変更をステージングしてプレビューできます。

Directus MCPサーバーとは？

Directusは、v11.13（2025年11月）でネイティブのModel Context Protocolサーバーを導入しました。MCPにより、ClaudeやChatGPTなどのAIツールがDirectusのコンテンツと直接やり取りできるようになり、自然言語を使ってアイテムの読み取り、作成、更新を行うことができます。MCPサーバーは既存のRBAC権限を尊重するため、AIのアクセスも人間のユーザーと同じルールに従います。