No.1000239新着 supabase-mcp(supabase-community/supabase-mcp):SupabaseのDB操作をClaudeから行えるMCPサーバー
supabase-mcp(supabase-community/supabase-mcp)は、Supabaseのプロジェクトを Claude などのAIアシスタントにつなぐMCPサーバーです。READMEによると、AIがテーブルの管理、設定
本文と出典
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向けの例では、次の指定が使われています。
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の機能から見て現実的な出発点になります。
結び
supabase-mcpは、Supabaseの操作をMCP経由でAIに渡すためのリモートサーバーで、設定はURLの登録とログインで完結します。今後実際に使ってみて、使い勝手を別記事で報告する予定です。
(この記事は旧サイト ai.shizuku.net から移しました。元の記事: https://ai.shizuku.net/2026/10/08/supabase-mcp-server/)
この記事を読んで浮かんだ疑問は、運営者ジージが仕事QAでくらさんに質問し、答えをそこに載せていきます。