Mit supabase/server Auth und Clients für Edge Functions ergänzen

Für wen

Dieses Skill passt zu Leuten, die Edge Functions oder APIs schreiben und Auth, Client-Erzeugung und CORS-Behandlung nicht immer wieder von Hand schreiben wollen. Offiziell ist es eine serverseitige Hülle: Auth, Client-Erzeugung und Kontextinjektion übernimmt sie, du schreibst die Geschäftslogik. Es passt auch zu Leuten, die schon einen KI-Coding-Agenten nutzen — der Ursprungstext sagt, das Skill lässt sich in Agenten wie Claude Code und Cursor einbauen.

Es passt nicht zu Leuten, die nur Browserseiten bauen und nie einen Server-Einstieg berühren. Die Anfrage muss in Edge Functions oder eine API eintreten, bevor Client-Erzeugung und Auth automatisch auf die eingehende Anfrage begrenzt werden. Fehlt noch ein Agent, der Skills installieren kann, zuerst prüfen, dass der offizielle Installationsbefehl ausführbar ist. Eine schreibgeschützte Prüfung reicht auch: den Agenten erklären lassen, wie man fetch mit einer Konfigurationszeile umhüllt, und Produktionsfunktionen nicht sofort ändern. Das offizielle Repository ist

https://github.com/supabase/server

Die auf dieser Seite bereits geschriebenen Befehle befolgen.

Ersten Versuch in 3 Minuten abschließen

Nur den einen Skill-Installationsweg gehen, den der offizielle Text schreibt.

Voraussetzung: dieser Rechner kann npx ausführen, und du nutzt eine der im Ursprungstext genannten KI-Coding-Agenten, zum Beispiel Claude Code oder Cursor. Das Projekt öffnen, in dem du sonst Edge Functions oder APIs schreibst, reicht. Dieser Schritt ist eine Erklärungsprüfung; keinen Live-Code ändern und keine Anfragen nach außen senden.

Installationsort: im Terminal im Projektwurzelverzeichnis ausführen:

npx skills add supabase/server

Der Befehl installiert das Skill in den aktuellen Agenten. Der offizielle Text sagt außerdem: in Deno oder Supabase Edge Functions kannst du auf ein Paket verzichten und direkt aus npm:@supabase/server importieren.

Eine risikoarme Aufgabe auslösen: den Agenten mit installiertem Skill bitten, in Text aufzulisten „wie man fetch mit withSupabase umhüllt, sodass die Handler-Funktion erst nach erfolgreicher Auth läuft“, und die Importzeile zu schreiben. Keine Dateien schreiben, keine externen Schnittstellen aufrufen, nicht deployen.

Erfolgssignal: der Agent kann wiederholen, dass nach einem Import und einer Konfigurationszeile Auth geprüft, der Client bereit, CORS behandelt ist und die Handler-Funktion nur nach erfolgreicher Auth läuft; und er liefert import { withSupabase } from "npm:@supabase/server". Erfindet er einen anderen Installationsbefehl, zum offiziellen Befehl oben zurück und erneut versuchen.

Anwendungsfälle

Fall 1: Dem fetch-Einstieg einer vorhandenen Edge Function oder API die offizielle Hülle geben. Der Hauptweg im Ursprungstext ist, fetch mit withSupabase zu umhüllen: nach einem Import und einer Konfigurationszeile ist Auth geprüft, der Client bereit, CORS behandelt, und die Handler-Funktion läuft nur bei erfolgreicher Auth. Zuerst den Agenten den zu ändernden Einstieg und den unverändert zu lassenden Geschäftscode markieren lassen, dann nach Bestätigung handeln. Fehlt ein vollständiges Funktionsbeispiel, bei „Einstieg ist umhüllt, fehlgeschlagene Auth betritt die Handler-Funktion nicht“ stehen bleiben; keine Routingtabelle und kein Geheimnisschema erfinden.

Fall 2: In Deno oder Supabase Edge Functions direkt importieren statt zuerst ein Paket zu installieren. Der Ursprungstext sagt, diese Umgebung kann die Installation überspringen und direkt import { withSupabase } from "npm:@supabase/server" nutzen. Das passt zu Leuten, die in dieser Laufzeit schon Handler schreiben und nur den Importpfad prüfen wollen. Zuerst bestätigen, dass der Import zur Laufzeit der aktuellen Datei passt; ist das Projekt weder Deno noch Edge Functions, endet der Ursprungstext hier — nicht auf eine ungenannte Laufzeit ausweiten.

Nutzungsgrenzen

Der Ursprungstext deckt nur den Server-Einstieg ab: Client-Erzeugung und Auth werden automatisch auf eingehende Anfragen begrenzt, die Edge Functions und APIs betreten. Er beweist keine Nutzung auf Browserseiten, Hintergrund-Cronjobs oder ungenannten Hosting-Umgebungen.

Nur ein Skill-Installationsbefehl steht im Ursprungstext: npx skills add supabase/server. Keinen nie genannten Installer auf den Hauptweg schreiben. Claude Code, Cursor und andere sind eine Beispielmenge, nicht die einzigen zwei unterstützten Agenten.

Auf der Paketseite gibt der Ursprungstext den Direktimport für Deno / Supabase Edge Functions und das Umhüllen von fetch mit withSupabase. Siehst du keine Umgebungsvariablennamen, CORS-Detailschalter oder Wiederholstrategie bei Fehlern, nichts ergänzen. Die Handler-Funktion läuft nur nach erfolgreicher Auth; welcher Statuscode bei Fehlschlag zurückkommt, steht nicht. Die offizielle Seite ist

https://github.com/supabase/server

Weicht ein vom Agenten vorgeschlagener Installationssatz von dieser Seite ab, gilt diese Seite.