supabase/server로 Edge Functions에 인증과 클라이언트를 보태기

Install

npx skills add supabase/server

누구에게 맞나

이 스킬은 Edge Functions나 API를 쓰면서 인증, 클라이언트 생성, CORS 처리를 반복해서 손으로 쓰고 싶지 않은 사람에게 맞다. 공식은 서버 측 래퍼로 쓴다: 인증, 클라이언트 생성, 컨텍스트 주입은 이쪽이 처리하고 당신은 업무 로직만 쓴다. 이미 AI 코딩 에이전트를 쓰는 사람에게도 맞다——원문은 스킬을 Claude Code, Cursor 같은 에이전트에 넣을 수 있다고 적는다.

브라우저 페이지만 만들고 서버 입구를 건드리지 않는 사람에게는 맞지 않는다. 요청이 Edge Functions 또는 API로 들어와야 클라이언트 생성과 인증이 인바운드 요청으로 자동 범위 한정된다. 스킬을 설치할 수 있는 에이전트가 아직 없으면 공식의 그 한 설치 명령을 실행할 수 있는지 확인한 뒤 계속한다. 먼저 읽기 전용으로 확인해도 된다: 에이전트에게 fetch를 한 줄 설정으로 감싸는 방법을 설명하게 하고 프로덕션 함수는 바로 바꾸지 말 것. 공식 저장소는

https://github.com/supabase/server

해당 페이지에 이미 적힌 명령을 따른다.

3분 안에 첫 시도 끝내기

공식이 적은 이 한 스킬 설치 경로만 탄다.

전제: 이 머신에서 npx를 실행할 수 있고, 원문이 지목한 종류의 AI 코딩 에이전트(예: Claude Code 또는 Cursor)를 사용한다. 평소 Edge Functions나 API를 쓰는 프로젝트를 열면 된다. 이 단계는 설명 확인이며 라이브 코드를 바꾸지 말고 밖으로 요청도 보내지 말 것.

설치 위치: 프로젝트 루트의 터미널에서 실행한다:

npx skills add supabase/server

이 명령은 스킬을 현재 에이전트에 넣는다. 공식은 따로 적는다: Deno 또는 Supabase Edge Functions에서는 패키지를 설치하지 않고 npm:@supabase/server에서 바로 가져올 수 있다.

저위험 작업을 한 번 건다: 스킬이 설치된 에이전트에게 「withSupabase로 fetch를 한 겹 감싸고 인증이 통과한 뒤에만 처리 함수로 들어가는 방법」을 글로 나열하고 가져오기 문을 쓰게 한다. 파일에 쓰지 말고, 외부 인터페이스를 호출하지 말고, 배포하지 말 것.

성공 신호: 에이전트가 한 번 가져오기와 한 줄 설정 뒤에 인증이 검증되고, 클라이언트가 준비되며, CORS가 처리되고, 처리 함수는 인증 성공 후에만 실행된다고 되말할 수 있고 import { withSupabase } from "npm:@supabase/server"를 준다. 다른 설치 명령을 지어내면 위의 공식 명령으로 돌아가 다시 시도한다.

사용 사례

사례 1: 기존 Edge Function 또는 API의 fetch 입구에 공식 래퍼를 더한다. 원문의 주 경로는 withSupabase로 fetch를 감싸는 것이다. 한 번 가져오기와 한 줄 설정 뒤에 인증이 검증되고, 클라이언트가 준비되며, CORS가 처리되고, 처리 함수는 인증 성공 시에만 실행된다. 먼저 에이전트에게 바꿀 입구와 그대로 둘 업무 코드를 표시하게 한 뒤 확인 후 손댄다. 원문에 완전한 함수 예가 없으면 「입구가 감싸졌고 인증 실패 시 처리 함수에 들어가지 않음」까지로 멈추고 라우팅 표나 비밀키 방안을 스스로 보태지 말 것.

사례 2: Deno 또는 Supabase Edge Functions에서 패키지를 먼저 설치하지 않고 바로 가져온다. 원문은 그 환경에서 설치 없이 바로 import { withSupabase } from "npm:@supabase/server"할 수 있다고 적는다. 이미 그 런타임에서 처리 함수를 쓰며 가져오기 경로만 확인하고 싶은 사람에게 맞다. 먼저 그 가져오기가 현재 파일의 런타임에 맞는지 확인한다. 프로젝트가 Deno나 Edge Functions가 아니면 원문은 여기까지이며 나타나지 않은 런타임으로 넓히지 말 것.

사용 경계

원문은 서버 입구만 다룬다. 클라이언트 생성과 인증은 Edge Functions와 APIs로 들어오는 인바운드 요청으로 자동 범위 한정된다. 브라우저 페이지, 백그라운드 예약 작업, 이름 없는 호스팅 환경에서 쓸 수 있음을 증명하지 않는다.

스킬 설치 명령은 원문에 한 줄만 적혀 있다: npx skills add supabase/server. 나타나지 않은 설치기를 주 경로에 넣지 말 것. 원문이 Claude Code, Cursor 등을 지목하는 것은 예시 집합이며 이 두 에이전트만 지원한다고 쓰면 안 된다.

패키지 사용 쪽에서 원문은 Deno / Supabase Edge Functions의 직접 가져오기와 withSupabase로 fetch를 감싸는 것을 준다. 환경 변수 이름, CORS 세부 스위치, 실패 재시도 정책이 보이지 않으면 보태지 말 것. 처리 함수는 인증 성공 후에만 실행된다. 실패 시 어떤 상태 코드를 반환하는지는 원문에 없다. 공식 페이지는