スキル

supabase/server で Edge Functions に認証とクライアントを足す

Edge Functions と API の fetch を withSupabase で包む。先にスキル対応のエージェントで公式インストールコマンドを実行する。

公式ソース · supabase/server

インストール

npx skills add supabase/server

誰向けか

このスキルは、Edge Functions や API を書いていて、認証、クライアント作成、CORS 処理を何度も手書きしたくない人向けである。公式はサーバー側の包みとして書いてある:認証、クライアント作成、コンテキスト注入はこちらが処理し、あなたは業務ロジックだけ書く。すでに AI コーディングエージェントを使っている人にも向く——原文はスキルを Claude Code、Cursor などのエージェントに入れられると書く。

ブラウザページだけを作り、サーバー入口に触れない人には向かない。リクエストが Edge Functions または API に入って初めて、クライアント作成と認証が入側リクエストに自動で範囲限定される。スキルを入れられるエージェントがまだ無いなら、公式のその 1 本のインストールコマンドを実行できるか確認してから続ける。先に読み取り専用で確かめてもよい:エージェントに fetch を 1 行の設定で包む方法を説明させ、本番関数はすぐ変えない。公式リポジトリは

https://github.com/supabase/server

そのページにすでに書かれたコマンドに従う。

3 分で最初の試行を終える

公式が書いたこの 1 本のスキルインストール経路だけを取る。

前提:このマシンで npx を実行でき、原文が名指しする種類の AI コーディングエージェント、例えば Claude Code または Cursor を使う。普段 Edge Functions や API を書くプロジェクトを開くだけでよい。この段階は説明の確認であり、本番コードを変えず、外向きリクエストも送らない。

インストール場所:プロジェクトルートの端末で実行する:

npx skills add supabase/server

このコマンドはスキルを今のエージェントに入れる。公式は別に書く:Deno または Supabase Edge Functions ではパッケージを入れず、npm:@supabase/server から直接インポートできる。

低リスクなタスクを 1 つ出す:スキルが入ったエージェントに、「withSupabase で fetch を 1 層包み、認証が通ってから処理関数に入る方法」を文章で列挙し、インポート文を書かせる。ファイルに書かない、外部 API を呼ばない、デプロイしない。

成功の合図:エージェントが、1 回のインポートと 1 行の設定のあと認証が検証され、クライアントが用意され、CORS が処理され、処理関数は認証成功後にだけ走ると復唱でき、import { withSupabase } from "npm:@supabase/server" を出すこと。別のインストールコマンドを作ったら、上の公式コマンドに戻って再試行する。

利用例

例 1:既存の Edge Function または API の fetch 入口に公式の包みを足す。原文の主経路は withSupabase で fetch を包むことである。1 回のインポートと 1 行の設定のあと、認証は検証済み、クライアントは用意済み、CORS は処理済みで、処理関数は認証成功時だけ走る。先にエージェントに、変える入口と原状のまま残す業務コードを印させ、確認してから手を動かす。原文に完全な関数例が無いときは「入口が包まれ、認証失敗では処理関数に入らない」までで止め、経路表や秘密鍵方案を自分で足さない。

例 2:Deno または Supabase Edge Functions でパッケージを先に入れず直接インポートする。原文はその環境ではインストール不要で、直接 import { withSupabase } from "npm:@supabase/server" できると書く。そのランタイムですでに処理関数を書いており、インポートパスだけ確かめたい人向け。先にそのインポートが今のファイルのランタイムに合うか確認する。プロジェクトが Deno でも Edge Functions でもなければ、原文はここで止まる。現れないランタイムへ広げない。

利用上の境界

原文がカバーするのはサーバー入口だけである。クライアント作成と認証は、Edge Functions と APIs に入る入側リクエストへ自動で範囲限定される。ブラウザページ、バックグラウンドの定時タスク、指名されていないホスティング環境で使えることは証明しない。

スキルインストールコマンドは原文に 1 本だけ書かれている:npx skills add supabase/server。現れないインストーラを主経路に書かない。原文が Claude Code、Cursor などを名指しするのは例の集合であり、この 2 つだけを支援すると書いてはいけない。

パッケージの使い方側では、原文は Deno / Supabase Edge Functions の直接インポートと、withSupabase で fetch を包むことを出す。環境変数名、CORS の細部スイッチ、失敗再試行方針が見えなければ足さない。処理関数は認証成功後にだけ走る。失敗時にどのステータスコードを返すかは原文に無い。公式ページは

https://github.com/supabase/server

エージェントが勧めるインストール文がそのページと食い違うなら、そのページを優先する。