Claude CodeからDBを扱う。
SQL・Schema・FunctionsまでAIへ。
Supabase MCPを接続すると、Claude CodeからPostgreSQLデータベース、 マイグレーション、ログ、Edge Functions、型情報などへアクセスできます。 AI開発を「コード編集」から「バックエンド全体の操作」へ広げる公式連携です。
Supabase MCPを使うと、テーブル構造、マイグレーション、ログ、型情報などをClaude Codeから直接確認できるため、 バックエンドとフロントエンドをまたいだ開発がしやすくなります。
Supabase MCPとは？
Supabase MCPは、Supabaseが提供する公式のModel Context Protocolサーバーです。
Claude CodeなどのAIエージェントをSupabaseへ接続し、AIがプロジェクト情報やデータベースを扱えるようにします。
Hosted Supabaseの公式エンドポイントは次のURLです。
https://mcp.supabase.com/mcpローカルでSupabase CLIを使っている場合は、ローカルMCPサーバーも利用できます。
http://localhost:54321/mcpSupabase MCPでできること
テーブル一覧の取得、SQL実行、Postgres拡張機能の確認などができます。
既存マイグレーションを確認し、新しいDB変更を適用できます。
API、Postgres、Auth、Storage、Realtime、Edge Functionsなどのログを確認できます。
現在のDBスキーマからTypeScript型を生成できます。
Edge Functionsの一覧・取得・デプロイをAIから行えます。
公式ドキュメントを検索して、最新仕様を確認しながら開発できます。
Claude CodeにSupabase MCPを接続する
Supabase公式ドキュメントでは、Claude Code向けに次のコマンドが案内されています。
claude mcp add --scope project --transport http supabase \
"https://mcp.supabase.com/mcp?features=docs,account,database,debugging,development,functions,branching"設定後はSupabaseアカウントへの認証が必要です。
claude /mcp表示されたSupabaseサーバーを選び、Authenticateからブラウザ認証を進めます。
通常の利用では、以前のようにPersonal Access Tokenを手動発行する必要はありません。
Supabase MCPは特定プロジェクトにスコープできます。 すべてのプロジェクトをAIから見られる状態にするより、対象を限定した方が安全です。
Supabase MCPで重要な3つの設定
これらはURLパラメータとして組み合わせられます。
https://mcp.supabase.com/mcp?project_ref=YOUR_PROJECT_REF&read_only=true実際の開発ではどう使える？
Claude CodeがSupabaseからテーブルやマイグレーション情報を取得します。
現在のフロントエンド・API実装とDB構造を比較します。
必要なコード・SQL・マイグレーションを作成します。
エラーやセキュリティ・パフォーマンス上の問題を調査します。
必要に応じて型生成やEdge Functionsの更新まで進めます。
Claude CodeからSQLを扱う
Supabase MCPにはexecute_sqlがあり、Claude CodeからSQLを実行できます。
たとえば、
> customerテーブルの構造を確認してください。
> 現在のコードで使用しているフィールドと比較してください。
> 不整合があれば修正案を出してください。といった形で、コードとDBを同時に見ながら調査できます。
マイグレーションもAIから扱える
Supabase MCPには、マイグレーション一覧の取得と適用に使えるツールがあります。
DBスキーマ変更をAIに任せる場合は、特にPreviewや開発用プロジェクトで検証することが重要です。
AIがSQLを書けること自体は珍しくなくなりました。 MCPの価値は、現在のSupabase状態を確認した上で変更案を作り、ログやマイグレーション履歴まで含めて検証できることにあります。
Edge Functionsも管理できる
Supabase MCPでは、Edge Functionsについて次のような操作ができます。
現在のプロジェクトにあるEdge Functionsを確認できます。
指定したEdge Functionのコードや情報を取得できます。
新しいEdge Functionや更新版をデプロイできます。
ログとAdvisorでデバッグする
Supabase MCPのDebugging機能では、各サービスのログやAdvisor情報を取得できます。
対象にはAPI、Postgres、Edge Functions、Auth、Storage、Realtimeなどが含まれます。
> Auth関連のログを確認してください。
> 直近のエラー原因を調査してください。
> コード側で修正できる問題なら、
最小変更で対応してください。「Dashboardでログを見る → コピーする → AIへ貼る」という往復を減らせるのが大きなメリットです。
TypeScript型生成もできる
Supabase MCPには、現在のDBスキーマからTypeScript型を生成する機能があります。
DBスキーマとフロントエンド側の型定義を揃えたい場合に便利です。
特にNext.js + TypeScript + Supabaseの構成では、スキーマ変更後の型ずれを減らす用途に向いています。
本番DBへそのまま接続していい？
MCPを本番データへ接続しないことを推奨している。
AIエージェントにデータベース操作能力を与える以上、 コード生成ツール以上に慎重な権限設計が必要です。
- 開発・テスト用プロジェクトを優先する
- production dataへ直接接続しない
- 必要ならread-only modeを使う
- project_refで対象プロジェクトを限定する
- featuresで利用可能ツールを絞る
- AIのツール実行内容を毎回確認する
- 機密データや個人情報を含む環境では特に慎重に扱う
Supabaseは、LLMとデータソースを接続する際の主要なリスクとしてプロンプトインジェクションも挙げています。
たとえばDB内のユーザー入力に悪意ある命令が含まれていた場合、AIがその内容を「指示」と誤認する可能性があります。
書き込みを禁止しても、AIが読めるデータそのものが機密情報なら、 プロンプトインジェクションなどによって不適切に読み出されるリスクは残ります。
Project Scopeが重要な理由
project_refを指定すると、MCPサーバーを特定プロジェクトだけに限定できます。
このモードでは、Supabaseアカウント全体に関する一部の管理ツールも無効になります。
AI開発では、必要以上に広いアクセス権を与えない「最小権限」の考え方が重要です。
Branchingと組み合わせる
Supabase MCPはBranching関連ツールにも対応しています。
Branchingを使えば、本番DBを直接変更せず、開発用ブランチで変更をテストしてからマージする運用ができます。
なおSupabase公式では、MCPのBranching機能はExperimentalで、利用には有料プランが必要とされています。
Supabase Pluginとの違い
SupabaseにはMCPだけでなく、AI Coding Agents向けPluginもあります。
実際のDB・ログ・Functions・プロジェクト情報へアクセスするための接続レイヤー。
Supabase固有のベストプラクティスや開発手順をAIエージェントへ提供します。
Supabase公式では、MCPとAgent Skillsをまとめて導入できるPluginも提供しています。
どちらか片方だけではなく、MCPで実データやプロジェクト状態を確認し、 PluginやSkillsでSupabaseのベストプラクティスを補う組み合わせが強力です。
Vercel MCPと組み合わせると強い
Supabase MCPとVercel MCPを組み合わせると、Webアプリ開発のかなり広い範囲をAIへ接続できます。
DB・型・Auth・Functions・ログを確認。
Next.jsやAPIコードを実装・修正。
Previewやデプロイ状態・ログを確認。
実際の画面でE2Eテスト。
Claude Code × Supabaseで何が変わる？
「アプリの状態」そのものを見る。
データベース、ログ、型、Functions、コードを1つのAIエージェントが横断できれば、 「どこが壊れているか」を探す時間そのものを減らせます。
従来は、
コードを見る → Supabase Dashboardを見る → SQL Editorを見る → Logsを見る → コードへ戻る
という往復が必要でした。
Supabase MCPによって、これらのコンテキストをClaude Codeへ集約できます。
MCPで実際のDBやログへつながることで、AIは単なるコード生成ツールではなく、 アプリ全体の状態を見ながら問題解決する開発エージェントへ近づいていきます。
関連記事
出典：Supabase公式「Supabase MCP Server」「Supabase Remote MCP Server」「Supabase is now an official Claude connector」「Supabase Plugin for AI Coding Agents」ほか。機能・提供状況は記事執筆時点の情報です。
