Mode-ai 操作マニュアル

Mode-ai は、ER図（エンティティ関係図）を直感的に描きながら、AIとの連携を通じてデータモデルを「動かす」ツールです。 データエンジニア・アーキテクト・AI活用担当者など、データに携わるすべての方が対象です。

AIR-DML™ エディタ。テキストで構造を記述すると、キャンバスに即時反映されます。

AIR-DML（AI-Ready Database Modeling Language）は Mode-ai 独自のテキスト形式です。 キャンバスで操作すると AIR-DML が自動更新されます。エディタは読み取り専用で、 内容の直接書き込みはできません（ダイアグラムの崩壊を防ぐための仕様です）。

Project "プロジェクト名" {
  database_type: 'PostgreSQL'
}

Table users [alias: "ユーザー"] {
  id         serial      [pk, not null, alias: "ユーザーID"]
  email      varchar(255)[unique, not null, alias: "メールアドレス"]
  name       varchar(100)[not null, alias: "氏名"]
  created_at timestamp   [not null, alias: "作成日時"]

  Note: "システムのユーザーアカウント"
}

Table orders [alias: "注文"] {
  id      serial  [pk, not null, alias: "注文ID"]
  user_id integer [fk, not null, alias: "ユーザーID"]
  total   numeric(10,2) [not null, alias: "合計金額"]

  Note: "注文ヘッダ"
}

Ref: orders.user_id > users.id

自然言語からER図を自動生成。専門知識がなくても設計を始められます。

AI Diagram は、日本語の要件説明を入力するだけで、専門家レベルのER図を自動生成する機能です。 Len Silverston の Universal Data Model を参考にした設計パターンが適用されます。

例: ECサイトの受注管理。注文ヘッダ・明細分離、
注文ステータス履歴、配送先の複数対応を含めてください。

物理DB連携では、既存データベースのスキーマ（テーブル・カラム・型・コメント）を Mode-ai に取り込んで現状（AsIs）を可視化したり、 逆にMode-aiのダイアグラムからDDLを生成して物理DBに適用できます。

Mode-ai は MCP（Model Context Protocol）サーバとして機能します。 MCPトークンを発行してAIツールに設定するだけで、Claude Code や Cortex Code が Mode-ai のスキーマ情報を直接参照できるようになります。

MCPを通じてAIがデータモデルを理解し、より精度の高い提案・コード生成が可能になります。

claude mcp add mode-ai --transport http \
  --url https://mode-ai.io/api/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

cortex mcp add mode-ai --transport http \
  --url https://mode-ai.io/api/mcp \
  --header "Authorization: Bearer <YOUR_TOKEN>"

ダイアグラムはさまざまな形式でダウンロードできます。用途に合わせてお選びください。