Supabase MCP

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase-community/supabase-mcp"],
      "env": {
        "SUPABASE_URL": "https://<YOUR_PROJECT_REF>.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SERVICE_ROLE_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase-community/supabase-mcp"],
      "env": {
        "SUPABASE_URL": "https://<YOUR_PROJECT_REF>.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SERVICE_ROLE_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "supabase": {
      "command": "npx",
      "args": ["-y", "@supabase-community/supabase-mcp"],
      "env": {
        "SUPABASE_URL": "https://<YOUR_PROJECT_REF>.supabase.co",
        "SUPABASE_SERVICE_ROLE_KEY": "<YOUR_SERVICE_ROLE_KEY>"
      }
    }
  }
}

概要

Supabase MCPは、オープンソースのBaaS（Backend as a Service）「Supabase」をAIエージェントから直接操作できるようにするMCPサーバーです。

SupabaseはPostgreSQLをベースとしたデータベース・認証・ストレージ・Edge Functionsを一体提供するプラットフォームです。このMCPを導入することで、Supabase管理ダッシュボードを開くことなく、Claudeへの自然言語の指示だけでデータの検索・更新・スキーマ確認などが行えます。

Next.js + Vercel + Supabaseの構成でアプリ開発をしている場合、Cursorと組み合わせることで開発効率が大幅に向上します。

導入手順

1. Supabaseプロジェクトの準備

Supabase にアクセスしてプロジェクトを作成済みであることを確認してください。

2. APIキーの取得

Supabaseダッシュボードの Project Settings → API から以下の2つを取得します：

• Project URL（例：https://abcdefgh.supabase.co）
• service_role key（anon キーではなく service_role を使用）

⚠️ service_role キーはデータベースへのフルアクセス権限を持ちます。設定ファイルをGitにコミットしないよう注意してください。

3. 設定ファイルへの追記

Claude Desktop の claude_desktop_config.json に設定を追加します（上記の設定例を参照）。

使い方の例

データ検索:

「先週（3月24日〜30日）に新規登録したユーザーを
 メールアドレスと登録日時の一覧で見せて」
→ usersテーブルをクエリして結果を表示

スキーマ確認と最適化提案:

「postsテーブルのスキーマを確認して、
 よく使うクエリパターンに対してインデックスが適切か診断して」
→ スキーマ情報を取得してインデックス追加の提案を生成

Edge Functionsのデバッグ:

「send-welcome-email Functionの最新ログを取得して、
 エラーが出ていたら原因を教えて」
→ Function実行ログを取得してエラー原因を解析

注意事項

• service_role キーはRLSポリシーを無視してデータにアクセスします。本番データベースへの書き込み操作は慎重に行ってください。
• APIキーを含む設定ファイルは .gitignore に追加してバージョン管理から除外してください。
• 大量データの取得はSupabaseの無料プランのリクエスト制限に達する場合があります。