supabase-mcp（supabase-community/supabase-mcp）：SupabaseのDB操作をClaudeから行えるMCPサーバー

supabase-mcp（supabase-community/supabase-mcp）は、Supabaseのプロジェクトを Claude などのAIアシスタントにつなぐMCPサーバーです。READMEによると、AIがテーブルの管理、設定の取得、データの照会といった作業を行えるようになります。ライセンスはApache 2.0です。Supabaseをデータベースやバックエンドに使っていて、テーブル設計やSQLの確認をAIに手伝わせたい個人事業主・小規模開発者が対象になります。

MCP（Model Context Protocol）は、AIが外部サービスとやり取りするための共通規格です。このリポジトリは、その規格に沿ってSupabaseの操作をAIに公開します。ツールの全一覧はSupabase公式の MCP ページ（supabase.com/mcp）にあり、READMEには個別のツール名までは載っていません。

導入方法
注意点
結び

導入方法

サーバーはSupabaseがホストするリモート版が基本です。自分のPCにインストールするパッケージではなく、MCPクライアントにURLを登録します。READMEが示す設定は次のJSONです。

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

Claude Codeでは、同じ内容をコマンドで登録できます。これはClaude Codeの一般的なMCP登録コマンドに上記URLを当てはめたもので、READMEに記載された手順ではありません。

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

登録後、MCPクライアントがSupabaseへのログインを促します。READMEは、操作したいプロジェクトが属する組織を選ぶよう案内しています。Supabaseのダッシュボードにある「MCP」接続タブからは、プロジェクト専用のURLを生成できます。

URLにはクエリパラメータで制限を付けられます。READMEのAI SDK向けの例では、次の指定が使われています。

https://mcp.supabase.com/mcp?project_ref=<プロジェクトref>&read_only=true&features=database,docs

project_ref：接続先を特定のプロジェクトに限定する
read_only=true：データを変更するツールを除外する
features：使う機能グループを絞る（例：database, docs）

ローカルで動かすSupabase CLI環境では http://localhost:54321/mcp でMCPサーバーを利用できます。セルフホスト版のSupabaseも、公式の「Enabling MCP server」ページに手順があります。READMEによれば、どちらも提供ツールは一部に限られ、OAuth 2.1には対応していません。

開発者向けには、npmパッケージ @supabase/mcp-server-supabase が公開されています。Vercel AI SDKのMCPクライアント向けにツールのスキーマを生成する createToolSchemas() と、自前のHTTPエンドポイントでツールを提供する createSupabaseMcpHandler() が使えます。Claude Codeから使うだけなら不要です。

注意点

最大の論点は、AIにデータベースへの操作権限を渡すことです。READMEは設定の前に、Supabase公式のセキュリティのベストプラクティスを読むよう求めています。LLMをSupabaseプロジェクトにつなぐリスクとその軽減策が書かれているという位置づけです。具体的な内容は公式ドキュメント側にあり、今回の執筆環境からは参照できなかったため、この記事では扱いません。導入前にご自身で確認してください。

認証：ログイン時にSupabaseのOAuthを使います。許可した組織・プロジェクトの範囲がAIの操作範囲になります。
外部通信：リモート版では、クエリやデータの内容が mcp.supabase.com を経由します。顧客情報などを含むDBに向ける場合は、この点を前提に判断が必要です。
権限の絞り込み：read_only=true と project_ref の指定で、書き込みと対象範囲を限定できます。
本番環境：READMEは「開発から本番へ安全に反映する方法」の資料（docs/production.md）を案内しています。
環境による差：CLI版・セルフホスト版は提供ツールが一部に限られます。

このほか、MCPで使うSupabaseの接続先組織の選択ミスや、AIが生成したSQLをそのまま実行する運用にはリスクがあります。まずは読み取り専用・単一プロジェクトで試す構成が、READMEの機能から見て現実的な出発点になります。