Supabase MCP Server

Supabase MCP Server とは？

Supabase MCP は Supabase 公式の Model Context Protocol サーバーです。Cursor、Claude、Windsurf などの AI アシスタントを Supabase プロジェクトに接続し、テーブル管理、SQL やマイグレーションの実行、設定の取得、ログの閲覧、Edge Functions のデプロイを行えるようにします。

https://mcp.supabase.com/mcp で提供されるホスト型サーバーで、OAuth でサインインするため、ほとんどの場合インストールもアクセストークンも不要です。コードは supabase-community/supabase-mcp リポジトリで Apache-2.0 ライセンスのもと公開されています。ローカルの Supabase CLI やセルフホストの Supabase でも MCP エンドポイントが提供されますが、ツールは少なく OAuth には対応していません。

Supabase MCP Server の使い方

始める前に： Supabase のセキュリティガイダンスを読んでください。LLM をデータベースに接続することには現実的なリスクがあるため、開発用プロジェクトを使い、ツール呼び出しの手動承認をオンにしたまま、読み取り専用モードも検討してください。

サーバー URL： https://mcp.supabase.com/mcp。セットアップ中にクライアントがブラウザを開き、Supabase へのログインを求めます。対象のプロジェクトを含む組織を選んでください。Supabase ダッシュボードの Connect ダイアログにある MCP タブから、プロジェクト専用の URL を生成することもできます。

URL オプション（クエリパラメーター）：

• project_ref=<id>：サーバーを 1 つのプロジェクトに限定し、アカウントレベルのツールを無効化
• read_only=true：すべてのクエリを読み取り専用の Postgres ユーザーとして実行
• features=database,docs：指定したツールグループのみを有効化

Claude Code

claude mcp add --scope project --transport http supabase "https://mcp.supabase.com/mcp"

その後、IDE 拡張機能ではなく通常のターミナルで claude /mcp を実行し、supabase を選んで Authenticate を選択します。

Cursor

.cursor/mcp.json（すべてのプロジェクトで使う場合は ~/.cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "supabase": {
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

Codex

codex mcp add supabase --url "https://mcp.supabase.com/mcp"
codex mcp login supabase

Codex 内で /mcp を実行して確認します。

その他のクライアント

Claude.ai では、コネクタディレクトリから Supabase を追加できます。その他のクライアントでは、汎用の設定をそのクライアントの形式に書き換えて使います。

{
  "mcpServers": {
    "supabase": {
      "type": "http",
      "url": "https://mcp.supabase.com/mcp"
    }
  }
}

CI やブラウザでの認証フローを使えないクライアントでは、権限を絞った個人用アクセストークンを作成し、Authorization: Bearer ヘッダーで送ります。Supabase CLI をローカルで実行している場合、サーバーは http://localhost:54321/mcp にあります。

Supabase MCP Server の主な機能

• OAuth 2.1 サインインに対応した公式のホスト型サーバー：多くのクライアントでローカルインストールもトークンも不要
• プロジェクト、データベース、Edge Functions、ログ、アドバイザー、ブランチ、ストレージ、ドキュメントのためのツール
• SQL を読み取り専用の Postgres ユーザーで実行する read_only=true モード
• project_ref によるプロジェクトの限定で、エージェントを 1 つのプロジェクト内に制限
• 機能グループで、タスクに必要なツールだけを公開
• プロジェクトやブランチを作成する前のコスト確認
• ローカルの Supabase CLI やセルフホストの Supabase でも利用可能（ツールは限定的）
• Vercel AI SDK 向けに型付きのツールスキーマを提供する @supabase/mcp-server-supabase パッケージ

Supabase MCP Server のツール

このページには 29 個のツールが機能グループごとに掲載されています。Storage 以外のグループはデフォルトで有効です。

• アカウント： list_organizations、list_projects、create_project、pause_project、restore_project。get_cost と confirm_cost により、エージェントはプロジェクトやブランチの作成前にコストを提示して確認を取ります。
• データベース： list_tables、list_extensions、list_migrations、DDL 用の apply_migration、クエリ用の execute_sql。
• デバッグ： query_logs と get_advisors で、ログやセキュリティ・パフォーマンスに関する指摘を確認します。
• 開発： get_project_url、get_publishable_keys、generate_typescript_types。
• Edge Functions： list_edge_functions、get_edge_function、deploy_edge_function。
• ブランチ（実験的、有料プランが必要）： create_branch、merge_branch、reset_branch、rebase_branch、delete_branch。
• ドキュメント： search_docs で Supabase のドキュメントを検索します。

Supabase MCP Server のユースケース

• スキーマ作業：「Create a profiles table linked to auth.users with row level security, as a migration.」
• データに関する質問：「How many users signed up last week? Use read-only SQL.」
• デバッグ：「Check the API logs for errors in the last hour and run the security advisor.」
• フロントエンドの型付け：「Generate TypeScript types for my database and update types.ts.」
• Edge Functions：「Deploy a function that sends a welcome email on signup.」
• 安全な試行：「Create a development branch, apply this migration there, and show me the diff.」

Supabase MCP Server と代替ツールの比較

Supabase MCP サーバーは、プロジェクト、Edge Functions、アドバイザー、ブランチといった Supabase 固有の機能を理解しています。Postgres データベース（接続文字列経由の Supabase データベースを含む）への SQL アクセスだけが必要なら、Postgres MCP のような汎用サーバーでも対応できますが、プラットフォームの管理はできません。GitHub には「supabase-mcp」という名前の古いコミュニティプロジェクトもありますが、継続的にメンテナンスされているのは公式のホスト型サーバーです。

Supabase MCP Server のトラブルシューティング

• プロジェクトが違う、または表示されない： OAuth のときに、そのプロジェクトを含まない組織を選んでいます。再認証して正しい組織を選ぶか、URL を project_ref で限定してください。
• Claude Code で認証できない： IDE 拡張機能ではなく通常のターミナルで claude /mcp を実行し、supabase を選んで Authenticate を選択します。
• 書き込み系のツールがない： URL に read_only=true が含まれていると無効になります。外すのは本番以外のプロジェクトに限ってください。
• ツールが想定より少ない： ローカル CLI やセルフホスト環境では一部のツールのみで OAuth もなく、Storage もデフォルトで無効です。features= でグループを追加します。
• CI にブラウザがない： OAuth の代わりに、権限を絞った個人用アクセストークンを Authorization: Bearer ヘッダーで使います。