AIエージェントにバックエンド構築を任せたい。けれど、データベース設計やマイグレーションの段階で手作業に戻ってしまう——そんな経験のある開発者は多いはずです。
Supabaseが公式にOpenAI Codexプラグインとして利用可能になりました。Codex上から自然言語でSupabaseプロジェクトを操作し、テーブル設計からSQL実行、セキュリティ監査、ログ分析まで一貫して行えます。
この記事でわかること
- Supabase Codexプラグインの仕組みと含まれる機能
- MCP Serverで使える20以上のツール
- Agent Skillsによるベストプラクティスの自動適用
- セットアップ手順
Supabase Codexプラグインとは
Supabase Codexプラグインは、OpenAIのコーディングエージェント「Codex」にSupabaseの操作機能を追加するプラグインです。supabase-communityがGitHubで公開しており、MITライセンスで配布されています。
このプラグインは2つの要素で構成されています。1つはSupabase MCP Serverへのリモート接続、もう1つはSupabase Agent Skillsの組み込みです。MCP Serverがデータベース操作の「手足」を提供し、Agent Skillsが「知識」を補います。
MCP Serverで何ができるか
Supabase MCP Serverは、AIツールとSupabaseプロジェクトの橋渡しをするサーバーです。Model Context Protocol（MCP）という標準プロトコルに準拠しており、20以上のツールを提供しています。
主な操作は以下の通りです。
プロジェクト管理: Supabaseプロジェクトの作成・設定変更をAIツールから直接実行できます。ブランチの管理やTypeScript型の生成にも対応しています。
SQL実行: execute_sqlツールでデータの取得やレポート作成を行えます。通常のクエリはこのツールを使い、スキーマ変更を伴うDDL操作はマイグレーションツールを使う、という使い分けが可能です。
マイグレーション: apply_migrationツールでSQLマイグレーションを適用すると、変更履歴がデータベース内で自動追跡されます。list_migrationsで適用済みマイグレーションの一覧も確認できます。
ログ取得: get_logsツールで、API・PostgreSQL・Edge Functions・Auth・Storage・Realtimeの各サービスのログを取得できます。デバッグやトラブルシューティングに役立ちます。
認証はOAuthのダイナミッククライアント登録をデフォルトで採用しており、ブラウザベースのフローで認証します。パーソナルアクセストークン（PAT）はCI/CDなど非対話環境でのみ必要です。
Agent Skillsが「正しい使い方」を教える
MCP Serverだけでは、AIエージェントがSupabaseの設計思想に沿わないSQLを書いてしまう可能性があります。Agent Skillsはその問題を解決する仕組みです。
Agent Skillsは、AIエージェントが参照できる指示書・スクリプト・リソースをまとめたフォルダです。Agent Skills Open Standard（agentskills.io）に準拠しており、Claude Code、GitHub Copilot、Cursor、Clineなど18以上のAIエージェントに対応しています。
Codexプラグインに含まれるスキルは2種類あります。
supabase: Supabaseの全プロダクト（Database、Auth、Edge Functions、Realtime、Storage、Vectors、Cron、Queues）をカバーする総合スキルです。supabase-jsやSSR統合（Next.js、SvelteKit、Astro、Remix）の使い方、認証トラブルシューティング、CLIやMCP Serverの操作方法を含みます。
supabase-postgres-best-practices: PostgreSQLのパフォーマンス最適化ガイドラインです。クエリパフォーマンス、コネクション管理、スキーマ設計、Row-Level Security（RLS）など8カテゴリのベストプラクティスが、影響度の優先順位付きで収録されています。
これらのスキルはインストール後に自動で有効化されます。エージェントがSupabase関連のタスクを検出すると、該当するスキルを参照して処理を進めます。
セットアップ手順
CodexアプリまたはCLIからプラグインをインストールします。
Codexアプリの場合は、Plugins画面からSupabaseプラグインを検索してインストールするだけです。
CLIの場合、Codexのプラグインブラウザを開き、Supabaseプラグインを選択します。インストール後は、プロンプトウィンドウで「Supabaseプロジェクトのテーブル一覧を見せて」「このクエリを最適化して」などと入力すれば、プラグインが自動で呼び出されます。
@記号を使えばプラグインを明示的に指定して呼び出すことも可能です。
Codexプラグインならではの強み
Supabase MCP Server自体は以前からCursorやClaude Codeなど複数のAIツールで利用できました。今回のCodexプラグインが注目される理由は、MCP ServerとAgent Skillsを1パッケージにまとめている点です。
MCP Serverだけを接続した場合、エージェントは「何ができるか」は把握しますが「どう使うべきか」は知りません。たとえば、RLSを設定せずにテーブルを公開してしまったり、インデックスなしで大量データをクエリしたりする可能性があります。
Agent Skillsが組み込まれていると、エージェントはSupabaseのベストプラクティスを踏まえた上でコードを生成します。セキュリティ設定の漏れやパフォーマンス上の問題を事前に回避できるわけです。
まとめ
Supabase Codexプラグインは、AIコーディングエージェントとBaaS（Backend as a Service）の統合を一歩進めるものです。MCP Serverの20以上のツールでデータベース操作を自動化し、Agent Skillsでコード品質を担保する——この組み合わせにより、プロンプトからバックエンド構築までの距離が縮まります。Supabaseをバックエンドに使っている開発者は、まずプラグインを入れて試してみる価値があります。