Integrationen und verbundene Konten

Manche Apps brauchen einen Dienst, der nicht in der Sandbox von Setup läuft: E-Mail-Versand über Resend, eine Datenbank bei Cloudflare oder Neon, ein Backend bei Convex. Setup baut diese Dienste nicht nach. Du verbindest dein eigenes Konto, und Setup legt dort für jede App einen eigenen Schlüssel, ein eigenes Projekt oder eine eigene Datenbank an.

Setup verzeichnet alles, was es anlegt, zeigt es dir und entfernt es wieder, wenn du die App entfernst. Angelegt wird erst, wenn du den Plan gesehen und bestätigt hast.

Wie Setup erkennt, was eine App braucht

Bei der Analyse eines Projekts sieht sich Setup Abhängigkeiten, Namen von Umgebungsvariablen und Konfigurationsdateien an. Findet es einen externen Dienst, bekommt das Rezept eine Anforderung mit einer verständlichen Begründung, zum Beispiel dass die App E-Mails verschickt.

Startest du die App, zeigt das Formular einen Abschnitt Externe Dienste mit einer Auswahl für jede Anforderung:

• Für mich anlegen. Setup legt in deinem verbundenen Konto an, was die App braucht, und löscht es, wenn du die App entfernst.
• Eigene Werte verwenden. Du gibst Schlüssel ein, die du schon hast. Was du selbst mitbringst, löscht Setup nie.
• Von Hand einrichten. Du folgst den Schritten und fügst dann die Werte ein. Entfernst du die App, erinnert Setup dich daran, alles zu löschen.
• Ohne diesen Dienst starten. Nur bei optionalen Diensten. Die App startet ohne diese Funktion.

Gibt es eine selbst gehostete Alternative, verlinkt der Abschnitt sie. Dann bleibt alles in der Sandbox.

Ein Konto verbinden

Öffne Verbindungen in der Seitenleiste (/dashboard/connections oder /dashboard/<workspace>/connections für eine Organisation) und wähl Konto verbinden. Such den Dienst aus. Der Dialog listet die Schritte beim Anbieter und unter „Nur diese Berechtigungen erteilen“ die kleinsten Rechte, die Setup braucht. Leg dort das Token an, füg es ein und bestätige, zum Beispiel mit Resend verbinden.

Setup prüft die Zugangsdaten mit einer reinen Leseanfrage, wo der Anbieter eine anbietet, und führt das Konto dann als Funktioniert. Schlägt eine Prüfung fehl, steht dort Gestört, und Erneut prüfen wiederholt die Prüfung.

• Nur Workspace-Admins können Konten verbinden oder trennen.
• Zugangsdaten werden verschlüsselt gespeichert, nie wieder angezeigt und nie an eine App weitergegeben. Wohin sie gehen, erklärt das Sicherheitsmodell.
• Manche Dienste bieten statt eines Tokens auch die Anmeldung beim Anbieter an, aber nur, wenn der Betreiber deiner Setup-Instanz dafür eine OAuth-App registriert hat. Sonst fügst du ein Token ein.

Nichts entsteht ohne deine Bestätigung

Wählst du Für mich anlegen und startest die App, plant ein Runner die Änderung mit OpenTofu, und die App steht auf „Wartet auf deine Bestätigung“. Die Seite der App zeigt dann Prüf, was Setup anlegt: jede Ressource in verständlichen Worten, mit einer Kostenangabe (Kostenlos, Kostenloses Kontingent oder Kann etwas kosten) und dem Kostenhinweis des Anbieters.

Wähl Anlegen und App starten oder Stattdessen diese App entfernen. Hat sich der Plan geändert, seit du ihn geöffnet hast, meldet Setup „Der Plan hat sich geändert. Prüf ihn noch mal.“ Der Runner wendet nur einen Plan an, der genau dem bestätigten entspricht, und darf beim Einrichten nur anlegen, nie ändern oder löschen.

Schlägt das Anlegen fehl, entfernt Setup alles, was es schon angelegt hatte, und sagt das auch. Noch mal versuchen plant von vorn.

Das Ressourcenverzeichnis

Jede Ressource, die Setup anlegt, bekommt einen Eintrag in einem Verzeichnis: Anbieter, Art der Ressource, ein verständlicher Name, ihre ID beim Anbieter, ein Kostenhinweis und die Schritte, um sie von Hand zu entfernen. Setup benennt Ressourcen nach der App und versieht sie mit Tags, wo der Anbieter das unterstützt, damit sie sich wiederfinden lassen.

Jeder Eintrag hat eine Herkunft (Von Setup angelegt, Von dir eingerichtet oder In deinem Konto gefunden) und einen Status wie Aktiv, Wird entfernt oder Überbleibsel. Der Abschnitt Externe Dienste auf der Seite der App listet ihre Einträge, und Verbindungen zeigt, wie viele jedes Konto hat.

Die Zugangsdaten des Kontos erreichen die App nie. Die App bekommt nur die Werte dessen, was Setup für sie angelegt hat, etwa ihren eigenen API-Schlüssel oder die Adresse ihrer Datenbank.

Ressourcen entfernen

Entfernst du eine App, räumt Setup zuerst die Sandbox ab, löscht dann die externen Ressourcen der App in umgekehrter Reihenfolge und prüft, dass nichts übrig ist. Der Aufräumbericht meldet „Alles, was Setup für diese App angelegt hatte, ist entfernt.“ oder listet, worum du dich noch kümmern musst, mit Anleitung. Was du von Hand eingerichtet hast, erscheint als Checkliste. Fehlgeschlagene Löschungen versucht Setup bis zu fünfmal erneut.

Hinweis. Beim Entfernen der App löscht Setup auch die Datenbanken und Buckets, die es angelegt hat, mit allem, was darin liegt. Sichere Daten, die du behalten willst, vorher.

Überbleibsel sind Ressourcen, die Setup angelegt hat, die aber zu keiner App mehr gehören. Einmal am Tag und immer, wenn du bei einem Konto Nach Überbleibseln suchen wählst, listet Setup, was es bei diesem Anbieter benannt oder getaggt hat, und gleicht es mit dem Verzeichnis ab. Noch nicht jeder Anbieter lässt Setup seine Ressourcen auflisten. Jedes Überbleibsel entfernst du mit Entfernen, oder du wählst Habe ich gelöscht, wenn du es selbst gelöscht hast.

Trennst du ein Konto, an dem noch Ressourcen hängen, fragt Setup nach: Erst entfernen löscht sie (Apps, die sie nutzen, funktionieren dann nicht mehr), Behalten und trennen lässt sie in deinem Konto und gibt dir eine Anleitung zum Löschen, sobald ihre App entfernt wird. Laufende Apps behalten in beiden Fällen ihre eigenen Schlüssel.

Anbieter heute

Setup kennt 30 Dienste. Bei jedem kann es den Bedarf erkennen, ein Konto verbinden (mit Prüfung, wo der Anbieter eine reine Leseanfrage erlaubt) und dich durch die Einrichtung von Hand führen. Bei diesen kann es außerdem Ressourcen anlegen:

„Nach Dokumentation geschrieben“ heißt: Das Modul besteht die Prüfungen von OpenTofu, lief aber noch nie gegen ein echtes Konto. Das Dashboard weist bei jedem darauf hin. Bei Cloudflare lassen sich D1- und KV-Tokens nur auf das ganze Konto beschränken.

Stripe, Vercel, OpenAI, Anthropic, OpenRouter, GitHub, Firebase, Clerk, Auth0, Sentry, PostHog, Microsoft Azure, SendGrid, Postmark, Mailgun, Twilio, Netlify, Fly.io, Hetzner Cloud, SMTP-Server und S3-kompatibler Speicher unterstützen Erkennung, Verbindung und geführte Einrichtung. Anlegen kann Setup dort noch nichts.

Was noch fehlt

• Nur das Demo-Modul hat Ressourcen wirklich angelegt und entfernt. Resend und Convex sind gegen Nachbildungen ihrer APIs getestet, der Rest nur gegen die Dokumentation geprüft.
• Die Anmeldung beim Anbieter (OAuth) ist mit echten Anbietern ungetestet, und standardmäßig sind keine OAuth-Apps registriert.
• Die Suche nach Überbleibseln folgt der dokumentierten Seitenaufteilung jedes Anbieters bis zu einer Obergrenze. Ausprobiert wurde das nur an den Nachbildungen.
• Fällt ein Runner aus, während er Ressourcen anlegt, kann die Aufzeichnung darüber verloren gehen. Setup markiert die Einrichtung dann als fehlgeschlagen, und die tägliche Suche nach Überbleibseln findet, was entstanden ist.
• Module stammen nur aus der geprüften Sammlung von Setup, nie aus dem analysierten Projekt. Dass der Assistent neue Module aus der Doku eines Anbieters schreibt, ist nicht gebaut.

Der Assistent und die MCP-Tools erklären Anforderungen, listen Verbindungen und Ressourcen und entfernen Überbleibsel, nachdem du bestätigt hast. Ein Konto verbindest du immer auf der Seite Verbindungen, nie im Chat.