インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Supabase をワンクリックで追加して、AI クライアント(Claude、ChatGPT、Copilot、Cursor)を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
AnythingMCP は Claude のコネクタディレクトリに掲載されています。ワンクリックで Claude に追加 (新しいタブで開きます)し、サインインして Claude が使える MCP サーバーを選んでください。
概要
AI に Supabase プロジェクトの管理を任せます。プロジェクトの一覧と稼働状態の確認、スキーマとテーブルの調査、読み取り専用 SQL の実行、ログ、セキュリティとパフォーマンスのアドバイザー、Edge Functions、マイグレーション、ブランチ、Storage バケットの読み取りができます。Management API と個人用アクセストークンを使います。
こう聞いてみよう
Supabase のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Supabase をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Supabase + Claude
AI に Supabase プロジェクトの管理を任せます。プロジェクトの一覧と稼働状態の確認、スキーマとテーブルの調査、読み取り専用 SQL の実行、ログ、セキュリティとパフォーマンスのアドバイザー、Edge Functions、マイグレーション、ブランチ、Storage バケットの読み取りができます。Management API と個人用アクセストークンを使います。
前提条件
完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:
SUPABASE_ACCESS_TOKEN
ステップ 1 — 認証情報を取得
- Supabase のダッシュボードでアカウントメニューから Account preferences → Access Tokens を開き(または https://supabase.com/dashboard/account/tokens に直接アクセスし)、Generate new token をクリックします。
- できれば scoped token にします。AI に見せる組織とプロジェクトを選び、各機能に Read(変更させたい部分だけ Read-write)を付与します。このコネクターのツールが使うのは Projects、Project Settings、Database、Migrations、Backups、Edge Functions、API Keys(API Key Secrets は不要)、Logs、Usage Analytics、Advisors、Storage、Development Branches、Organizations です。
- 有効期限(最長 1 年)を設定してトークンをコピーします。トークンは
sbp_で始まり、Supabase は一度しか表示しません。 - トークンを、Bearer という語を付けずに
SUPABASE_ACCESS_TOKENに貼り付けて、コネクターをインストールします。 - まず
supabase_list_projectsを実行します。トークンでアクセスできるすべてのプロジェクトが、ステータスと ref 付きで表示されます。ref(https://<ref>.supabase.coに含まれる 20 文字の小文字)は、ほかのすべてのツールで使います。
後からアクセス権を変える場合: トークンの権限は作成後に変更できません。広げたり絞ったりするには、新しいトークンを作成して古いトークンを削除してください。一方、従来の(スコープなしの)トークンは、すべての組織に対してあなたと同じフルアクセス権を持ちます。
読み取り専用の設定: scoped token にはすべての機能で Read だけを付与します。Database が Read だけなら、supabase_execute_sql でさえ SQL を読み取り専用で実行します。ほかにデータを変更するツールはありません。普段の質問は supabase_run_read_only_sql で処理されます。このツールは読み取り専用のデータベースユーザーとして 1 つのステートメントを実行し、200 KB を超える結果は切り詰めます。
インストール時はオフ: supabase_execute_sql。postgres としてフル権限で SQL を実行するため、DDL、書き込み、権限付与はすぐに反映され、元に戻せません。AI にデータベースを変更させる場合だけオンにしてください。AI は各ステートメントを提示し、あなたの確認を待ちます。バージョン管理すべきスキーマ変更は、ご自身のマイグレーションの手順で行うほうが適しています。
プロジェクトオーナーとしての視点: コネクターはアプリのユーザーとしてではなく Supabase Management API を通じて動作するため、プロジェクトの REST API や行レベルセキュリティ(row level security)は経由しません。supabase_list_api_keys はすべてのキーの名前を返しますが、値を返すのは公開キーだけです。secret キーと従来の service_role キーは意図的に値なしで一覧され、それを表示するツールはありません。Edge Functions のコードもダウンロードされません。
一時停止したプロジェクト: Free プランのプロジェクトは 1 週間アクティビティがないと一時停止し、ステータスが INACTIVE になります。ダッシュボードでプロジェクトを復元するまで、データベース系のツールは失敗します。アプリでエラーが出たときは、まず supabase_get_project_health を実行してください。
ログとアドバイザー: supabase_query_logs は期間を指定しないと直近 1 分間だけを検索します。期間は最大 24 時間で、プランのログ保持期間内(Free は 1 日、Pro は 7 日、Team は 28 日)である必要があります。supabase_get_security_advisors と supabase_get_performance_advisors は、ダッシュボードの Advisors ページと同じチェックを実行します。ERROR の指摘から、特に行レベルセキュリティなしで公開されているテーブルから対処してください。プレビューブランチ(supabase_list_branches)には有料プランが必要です。
制限: Supabase の Management API は、ユーザーとエンドポイントごとに 1 分あたり 120 リクエスト(同じユーザーのトークンはすべてこの上限を共有)、ログと利用状況は 1 分あたり 30 リクエストまでです。上限を超えると、その 1 分間の残りは 429 が返ります。1 分待ってからやり直してください。
よくあるエラー: 401「Invalid access token」は、トークンが間違っているか、期限切れか、削除されたことを示します。Access Tokens で新しいトークンを作成してください。403 は、トークンにその操作の権限がないことを示します。scoped token の場合は不足している権限が missing_permissions に示されるので、それを含む新しいトークンを作成してください。404 は、プロジェクトの ref が不明か、トークンの組織に含まれないプロジェクトであることを示します。ログで 402 が返るのは、組織の利用枠を使い切ったときです。失敗した SQL ステートメントには Postgres のメッセージが返ります。たとえばテーブルにスキーマを付けていない(public.orders としていない)と「relation "orders" does not exist」になります。
このコネクターは、プロジェクトの作成、一時停止、復元、削除、Edge Functions のデプロイ、シークレット、認証設定、カスタムドメイン、ネットワーク制限、請求の管理は行わず、アプリのテーブルを PostgREST 経由で読むこともありません。
ステップ 2 — アダプターをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
ステップ 3 — Claude にコネクタを追加
サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL(
https://cloud.anythingmcp.com/mcp/…)をコピーします。このガイドでYOUR_SERVER_IDと表示されている箇所に使ってください。
推奨ルート:設定ファイルを触らずに claude.ai web で動作します。
- Claude で Customize → Connectors を開きます。
- + をクリックし、Add custom connector を選びます。
- 名前(例:
Supabase)とリモート MCP サーバー URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDを入力し、Add をクリックします。 - Connect をクリックし、AnythingMCP にサインイン(OAuth)してアクセスを許可します。
下記のすべてのツールがチャットに表示されます。プロンプトを入力し始めてください。
利用可能なツール
| Tool | What it does |
|---|---|
supabase_list_projects | List every project the token can reach: ref, name, organization_slug, region, status (ACTIVE_HEALTHY, INACTIVE when paused, COMING_UP… |
supabase_list_organizations | List the organizations the token can reach, with their slug and name |
supabase_get_organization | Get one organization by slug, including its plan (free, pro, team, enterprise) |
supabase_get_project | Get one project: name, ref, organization, region, status, created_at and database host and Postgres version |
supabase_get_project_health | Check the health of a project's services: for each one name, status (ACTIVE_HEALTHY, COMING_UP, UNHEALTHY) and error or info |
supabase_run_read_only_sql | Run one SQL statement as the read-only database user and return the rows as JSON objects |
supabase_execute_sql | Run SQL with full rights (as postgres): DDL, inserts, updates, deletes, grants |
supabase_list_schemas | List the database's schemas with their owner and number of tables, leaving out Postgres' own (pg_*, information_schema) |
supabase_list_tables | List the tables, views and materialized views of one or more schemas: schema, name, kind, whether row level security is on, estimated row… |
supabase_describe_table | Describe one table or view: columns (name, type, nullable, default, comment), constraints (primary key, foreign keys, unique, check, with… |
supabase_list_extensions | List the Postgres extensions installed in the database: name, version and schema (on Supabase usually extensions) |
supabase_list_migrations | List the migrations recorded for the database (by the Supabase CLI or the dashboard): version (timestamp) and name, oldest first |
supabase_list_backups | List the project's database backups: whether point-in-time recovery is on, and each backup's status and time |
supabase_generate_typescript_types | Generate TypeScript types for the database schema, as the Supabase CLI does: one string with a Database type covering tables, views… |
supabase_list_edge_functions | List the project's Edge Functions: slug, name, status, version, verify_jwt, entrypoint path and when they were created and updated (epoch… |
supabase_get_edge_function | Get one Edge Function by slug: status, version, verify_jwt, entrypoint and import map paths, created and updated times |
supabase_list_api_keys | List the project's API keys: id, name, type (publishable, secret or legacy), prefix and description |
supabase_query_logs | Query the project's logs with SQL (ClickHouse dialect) over one unified logs table: filter on source (edge_logs, postgres_logs, auth_logs… |
supabase_get_api_usage | Get request counts per time bucket for the project's REST, Auth, Storage and Realtime APIs over a recent interval |
supabase_get_security_advisors | Run the security advisor (database linter) on the project: findings such as tables without row level security, exposed auth.users, mutable… |
supabase_get_performance_advisors | Run the performance advisor on the project: findings such as unindexed foreign keys, unused or duplicate indexes, RLS policies that… |
supabase_list_branches | List the project's preview branches (branching, a paid feature): id, name, project_ref of the branch, git_branch, pr_number, is_default… |
supabase_get_branch | Get one preview branch of a project by its name: its own project ref, git branch, pull request number, status and whether it is persistent |
supabase_list_storage_buckets | List the project's Storage buckets: id, name, owner, whether public, and created and updated times |
プロンプトの例
- 「Supabase のプロジェクトのうち、いま正常に動いていないものはどれ?何が問題なのかも教えて。」
- 「Acme Shop プロジェクトでセキュリティアドバイザーを実行して、行レベルセキュリティなしで公開されているテーブルを教えて。」
- 「Acme Shop プロジェクトの public.orders で、先週は 1 日あたり何件の注文が作成された?」
- 「Acme Shop のログから直近 1 時間の Postgres のエラーを表示して、原因を説明して。」
FAQ
Claude Code は Claude Desktop と同じように動作しますか? はい。両方を https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID に向けてください。
次のステップ
このガイドは役に立ちましたか?