Dienste verbindenConnectors

Daten und Inhalte

Datenbanken, Tabellen, Content-Systeme, Dateispeicher und Suche, die Sie mit einer App verbinden können: Supabase, Neon, Firebase, Airtable, Notion, Google Sheets, WordPress, Contentful, Storyblok, Webflow, AWS S3, Cloudinary und Algolia.

Jede App hat bereits eine eigene Datenbank, eine Anmeldung und E-Mails: Das ist Cloud. Verbinden Sie einen dieser Dienste, wenn die Daten schon anderswo liegen, wenn sie in einem eigenen Konto liegen sollen oder wenn die App etwas braucht, das Cloud nicht kann, etwa hochgeladene Dateien aufzubewahren.

Diese Seite hat einen Eintrag pro Dienst. Wie das Verbinden im Allgemeinen funktioniert (der Button oder die Schlüssel, Test connection, die Wahl, welche Apps einen Dienst nutzen, Berechtigungen), steht unter Connectors.

ServiceWofürVerbindung
SupabaseIhr eigenes Supabase-Projekt anstelle des eingebauten BackendsProjektadresse und Schlüssel
NeonIhr eigenes Postgres, mit eigenen ZeilenregelnDie Adresse der Data API
FirebaseFirestore und Anmeldung aus Ihrem Firebase-ProjektDrei Werte aus der Firebase-Konsole
AirtableTabellen als DatenbankEin Button oder ein Token
NotionSeiten und DatenbankenEin Button oder ein Token
Google SheetsEine Tabelle als DatenbankEin Button oder ein API-Schlüssel
WordPressBeiträge und Seiten einer WordPress-WebsiteWebsite-Adresse und ein Anwendungspasswort
ContentfulEinträge aus einem Headless-CMSSpace-ID und ein Delivery-Token
StoryblokStories aus einem Headless-CMSEin öffentliches Zugriffstoken
WebflowSammlungen aus dem Webflow-CMSEin Website-Token
AWS S3Dateien, die Personen hochladenRegion, Bucket und ein Zugriffsschlüssel
CloudinaryBilder und Dateien, bei der Auslieferung skaliertCloud-Name, Upload-Preset und Schlüssel
AlgoliaSuche schon während der EingabeApplication-ID und zwei Schlüssel

Einige Dinge gelten für alle:

  • Geheime Schlüssel bleiben auf den Servern von Setherion, und Ihre veröffentlichte App ruft den Dienst über Setherion auf. Nur Werte, die von Natur aus öffentlich sind, erreichen den Browser: der Supabase-Anon-Schlüssel, die Firebase-Einstellungen, Cloud-Name und Upload-Preset von Cloudinary, der reine Suchschlüssel von Algolia und ein API-Schlüssel für Google Sheets.
  • Die Dienste, die Ihnen direkt etwas berechnen, zeigen auf ihrer Seite Billed by und ihren Namen und bitten Sie, das zu akzeptieren, bevor Sie sich verbinden. Neon, Firebase, Supabase, Airtable, Cloudinary, Algolia und AWS S3 gehören zu dieser Gruppe. Notion, Google Sheets, WordPress, Contentful, Storyblok und Webflow zeigen No usage charges.
  • Jeder Aufruf, den eine veröffentlichte App über Setherion macht, verbraucht einen Integrations-Credit. Siehe Tarife und Credits.
  • Test connection gibt es für jeden Dienst hier außer Firebase.
  • In einem Team-Arbeitsbereich kann die Inhaberin oder der Inhaber einige Verbindungen an die Apps der Mitglieder verleihen (siehe Arbeitsbereiche). Supabase, Neon und Firebase werden nie verliehen, ebenso wenig jeder Dienst, dessen Werte in die veröffentlichte App eingebaut sind: hier Cloudinary, Algolia und Google Sheets.

Datenbanken und Tabellen

Supabase

Wofür es gedacht ist. Ihr eigenes Supabase-Projekt: seine Datenbank, die Anmeldung und der Dateispeicher. Es ist optional, denn jede App hat bereits ein Backend. Wählen Sie es, wenn die Daten einer App in einem Projekt liegen sollen, das Ihnen gehört. Solange Supabase für eine App aktiv ist, nutzt diese App es für Daten, Anmeldung und Dateien anstelle des eingebauten Backends.

Verbinden. Fügen Sie die Project URL (wie https://abcdefgh.supabase.co) und den Anon Key ein, beide aus Supabase unter Project Settings, dann API. Der Anon-Schlüssel beginnt mit eyJ oder sb_publishable_; nutzen Sie den Kopieren-Button von Supabase, denn ein abgeschnittener Schlüssel wird abgelehnt. Der Service Role Key ist optional und beginnt mit eyJ oder sb_secret_.

Die Tabellen anlegen. Klicken Sie auf Connect Supabase account, melden Sie sich bei Supabase an und stimmen Sie zu. Danach gibt es in einer App, die Tabellen braucht, unter Manage, dann Cloud, einen Button, der sie in Ihrem Projekt anlegt, jedes Mal wenn Sie ihn drücken. Die Berechtigung bleibt auf unseren Servern. Ohne sie steht dasselbe SQL zum Kopieren bereit, damit Sie es selbst in Supabase einfügen. Sobald Ihr Konto verbunden ist, können Sie in einer Liste Your projects auch Use this project drücken, statt die Schlüssel einzufügen.

Fragen. „Speichere die Buchungen in meinem Supabase und lass Kunden sich mit E-Mail anmelden.“ „Füge eine Tabelle für Produkte mit Name, Preis und Foto hinzu.“

Gut zu wissen. Apps auf Ihrem eigenen Supabase können Secrets noch nicht nutzen. Wie Sie eine App verschieben, die schon Daten hat, steht unter Erweiterte Einstellungen.

Neon

Wofür es gedacht ist. Ihr eigenes Postgres bei Neon als Datenbank der App. Setherion erreicht es über die Data API von Neon, und Postgres selbst entscheidet per Row-Level-Security, wer welche Zeile sieht. Das passt zu einer App, in der jede Person ihre eigenen Zeilen sieht, zu einem Katalog, den alle lesen dürfen, oder zu einer Team-Ansicht.

Verbinden. Fügen Sie die Data API address aus Neon ein: Ihr Projekt, dann Data API, der REST-Endpunkt, der auf /rest/v1 endet. Sie muss auf neon.tech liegen. Klicken Sie dann auf Test connection. Solange Neon nicht gesagt wurde, dass es Setherion vertrauen soll, lehnt es ab, und das Ergebnis nennt Ihnen die JWKS-Adresse, die Sie dort einfügen.

Der JWKS-Schritt. Öffnen Sie in Neon Data API, dann Authentication, wählen Sie einen benutzerdefinierten Anbieter und fügen Sie diese JWKS-Adresse ein. Lassen Sie die Audience leer. So lernt Neon, der angemeldeten Person zu vertrauen, die Setherion bei jedem Aufruf mitsendet. Wenn Test nach einigen Minuten immer noch ablehnt, entfernen Sie den Anbieter in Neon und fügen Sie ihn erneut hinzu.

Fragen. „Führe in meiner Neon-Datenbank für jede angemeldete Person eine Aufgabenliste.“ „Zeige die Tabelle products aus Neon als Shop-Seite, nach Kategorie gefiltert.“

Berechtigungen. Drei Schalter unter Permissions: Zeilen lesen, Zeilen hinzufügen, ändern und löschen sowie Datenbankfunktionen ausführen.

Gut zu wissen. Die Tabellen gibt es erst, wenn Sie das SQL ausgeführt haben, das die KI dafür schreibt (eine Datei namens neon/setup.sql), einmalig im SQL Editor von Neon. Ein Besucher, der nicht angemeldet ist, erreicht nur, was Sie der anonymen Rolle von Neon gewährt haben.

Firebase

Wofür es gedacht ist. Firestore für Daten und Firebase Authentication für die Anmeldung, aus Ihrem eigenen Firebase-Projekt. Von Firebase ist nichts anderes eingebaut.

Verbinden. Drei Werte aus den Einstellungen der Web-App Ihres Projekts in der Firebase-Konsole: der API Key (beginnt mit AIza), die Project ID und die App ID (wie 1:123:web:abc). Alle drei sind von Natur aus öffentlich und gehen in die veröffentlichte App. Für Firebase gibt es kein Test connection: Connect behält die Werte.

Fragen. „Lass Personen ein Konto erstellen und führe eine private Notizliste in Firestore.“ „Zeige eine Live-Liste der Nachrichten aus meinem Firebase-Projekt.“

Gut zu wissen. Bei Firebase schützt nicht der Schlüssel Ihre Daten, sondern die Sicherheitsregeln. Jeder kann die Einstellungen aus einer veröffentlichten App auslesen, daher steht ein Projekt im Testmodus dem ganzen Internet offen. Legen Sie die Firestore-Regeln in der Firebase-Konsole fest, bevor die App etwas Persönliches speichert. Die KI schreibt jedes Dokument so, dass es zu einer Nutzer-ID aus Firebase Authentication gehört, und sagt das auf dem Bildschirm, wenn die App persönliche Daten speichert.

Airtable

Wofür es gedacht ist. Eine Tabelle aus Zeilen als Datenbank der App: ein CRM, eine Bestandsliste, Inhalte, die Sie in Airtable pflegen.

Verbinden. Klicken Sie auf Connect with Airtable, melden Sie sich an und haken Sie die Bases an, die die App nutzen darf, klicken Sie dann auf Choose base und wählen Sie eine aus. Oder nutzen Sie stattdessen Schlüssel: ein Personal Access Token (beginnt mit pat) aus Ihrem Airtable-Konto und die Base ID (beginnt mit app, zu sehen in der Adresse Ihrer Base).

Fragen. „Zeige meinen Bestand aus der Tabelle Products in Airtable, mit Foto und Preis.“ „Füge jede Anfrage aus dem Kontaktformular als neue Zeile in meiner Tabelle Enquiries hinzu.“

Grenzen. Apps erreichen die eine Base, die Sie gewählt haben, und sonst nichts in Ihrem Konto, auch wenn das Token mehr könnte. Eine Tabelle mit Leerzeichen im Namen wird für Sie behandelt. Airtable liefert lange Tabellen seitenweise, und die App wird angewiesen, jede Seite abzurufen oder zu sagen, dass die Liste unvollständig ist. Test connection liest die Tabellen der Base, schlägt also fehl, wenn diese Base nicht angehakt war.

Seiten und Tabellen

Notion

Wofür es gedacht ist. Eine Notion-Datenbank als leichtes Content-System oder Aufgabenliste sowie Notion-Seiten, die eine App anzeigt oder ausfüllt.

Verbinden. Klicken Sie auf Connect with Notion, melden Sie sich an und haken Sie die Seiten an, die die App nutzen darf. Die App kann dann diese Seiten lesen und beschreiben und sonst nichts. Oder nutzen Sie ein Token: Legen Sie unter notion.so/my-integrations eine interne Integration an und fügen Sie ihr Internal Integration Token ein (beginnt mit ntn_ oder secret_), mit einer optionalen Default Database ID. Geben Sie bei einem Token in Notion jede Seite oder Datenbank für die Integration frei, sonst antwortet Notion auf alles mit 404.

Fragen. „Zeige die Team-Seite aus meiner Notion-Datenbank, mit Foto und Rolle jeder Person.“ „Füge jede Formularnachricht als neue Zeile in meinen Notion-Aufgaben hinzu.“

Grenzen. Eine Abfrage liefert höchstens 100 Zeilen, daher wird die App bei einer langen Datenbank angewiesen, weiterzufragen, bis Notion sagt, dass es keine mehr gibt.

Gut zu wissen. Die KI, die Ihre Apps erstellt, kann Ihr Notion auch über einen MCP-Server lesen, was eine eigene Sache ist: siehe MCP-Server.

Google Sheets

Wofür es gedacht ist. Eine Tabelle, die Sie als Daten der App bearbeiten: Preise, eine Speisekarte, Angebote, Teammitglieder und Anmeldungen, die in Zeilen gesammelt werden.

Verbinden, mit dem Button. Klicken Sie auf Connect with Google, melden Sie sich an, klicken Sie dann auf Choose spreadsheet und wählen Sie die eine Datei. Die Tabelle bleibt privat, die App liest und beschreibt sie über Setherion, und der Rest Ihres Drive bleibt außer Reichweite.

Verbinden, mit einem Schlüssel. Fügen Sie einen Google-API-Schlüssel ein, bei dem in Google Cloud die Google Sheets API aktiviert und der auf diese API und auf Ihre Website beschränkt ist, sowie die Tabellen-ID. Dieser Weg funktioniert nur bei einer Tabelle, die mit „Jeder mit dem Link kann ansehen“ freigegeben ist, und nur lesend.

Fragen. „Zeige die Preisliste aus meiner Tabelle und aktualisiere sie, wenn ich die Tabelle bearbeite.“ „Füge jede Buchungsanfrage als neue Zeile am Ende meiner Tabelle hinzu.“

Grenzen. Mit dem Button eine Tabelle und die Tabs darin. Ein Bereich nennt einen Tab, wenn Sie also einen Tab umbenennen, sagen Sie es im Chat.

Notion, Airtable und Google Sheets werden über Setherion im Namen aller erreicht, die Ihre veröffentlichte App öffnen. Verbinden Sie nur, was die App anzeigen oder ausfüllen soll.

Inhalte aus einem CMS

Diese vier lesen Inhalte, die Sie anderswo schreiben, und zeigen sie in Ihrer App. Alle vier lesen nur, und nur das Veröffentlichte: Ein Entwurf erreicht nie eine öffentliche Seite.

WordPress

Wofür es gedacht ist. Die veröffentlichten Beiträge, Seiten und Medien einer WordPress-Website, in einer App angezeigt: ein Blog, eine Nachrichtenseite, ein Portfolio.

Verbinden. Die Site address (sie muss mit https:// beginnen), ein Username und ein Application password. Erstellen Sie dieses in WordPress unter Users, dann Profile, dann Application Passwords, dann Add New. Der kostenlose Tarif von WordPress.com bietet sie nicht an. Test connection meldet sich auf der Website an.

Fragen. „Füge eine Blog-Seite hinzu, die meine 10 neuesten WordPress-Beiträge mit ihren Bildern auflistet.“ „Zeige jeden Beitrag auf einer eigenen Seite, anhand seines Slugs.“

Berechtigungen. Je ein Schalter Read für Beiträge, Seiten, Bilder und Dateien, Kategorien, Tags und Kommentare.

Gut zu wissen. Auf die Website wird nie etwas geschrieben. Beiträge und Seiten werden so gezeigt, wie sie veröffentlicht sind, und Kommentare so, wie sie freigegeben sind. Der Text eines Beitrags kommt als HTML von Ihrer eigenen Website, daher stellt die App ihn mit ihrer eigenen Typografie dar.

Contentful

Wofür es gedacht ist. In Contentful geschriebene Einträge: Artikel, Produkte, Seiten, Teammitglieder, was auch immer Ihre Inhaltstypen sind.

Verbinden. Die Space ID (Settings, dann General settings) und das Content Delivery API token (Settings, dann API keys). Nutzen Sie das Delivery-Token, nicht das Management-Token. Die Environment ist optional und lautet master, wenn sie leer bleibt. Test connection liest Ihre Inhaltstypen.

Fragen. „Zeige meine Blogbeiträge aus Contentful, die neuesten zuerst, mit dem Titelbild.“ „Erstelle für jeden Produkteintrag eine Seite, gefunden über seinen Slug.“

Berechtigungen. Je ein Schalter Read für Einträge, Bilder und Dateien sowie Inhaltstypen.

Gut zu wissen. Die Feldnamen stammen aus Ihrem Inhaltsmodell, daher liest die KI zuerst die Inhaltstypen, statt zu raten. Ein Rich-Text-Feld kommt als Dokumentbaum an, den die App selbst darstellt.

Storyblok

Wofür es gedacht ist. In Storyblok geschriebene Stories, Seiten und Blöcke: ein Blog, eine Landingpage, eine Liste von Produkten oder Teammitgliedern.

Verbinden. Ein Access token: in Storyblok Settings, dann Access tokens, ein Public-Token. Die Region ist optional: eu (der Standard) oder us, wie in den Einstellungen Ihres Spaces angezeigt.

Fragen. „Liste die neuesten Stories im Ordner blog auf.“ „Erstelle die Seite Über uns aus der Story mit dem Slug about.“

Berechtigungen. Je ein Schalter Read für Stories, Links, Datasource-Einträge und Tags.

Gut zu wissen. Es wird nur veröffentlichter Inhalt gelesen: Setherion erzwingt das, sodass ein versehentlich eingefügtes Vorschau-Token keine Entwürfe auf eine öffentliche Seite bringen kann. Eine Story ist ein Baum aus Blöcken, und die App stellt die dar, die Ihr Space verwendet.

Webflow

Wofür es gedacht ist. Die Sammlungen, die Sie im Webflow-CMS schreiben: ein Blog, ein Team, eine Speisekarte, Projekte oder Standorte.

Verbinden. Ein Site API token. Öffnen Sie in Webflow Site settings, dann Apps & integrations, dann API access, und erzeugen Sie ein Token, bei dem CMS und Sites auf Read-only stehen.

Fragen. „Zeige die neuesten Blogbeiträge aus meiner Webflow-Sammlung.“ „Gib jedem Teammitglied eine eigene Seite, anhand des Slugs des Eintrags.“

Grenzen. Es werden nur veröffentlichte Einträge gelesen. Sie kommen aus dem Cache von Webflow, daher kann eine Änderung einige Minuten brauchen, bis sie erscheint. Die Aufrufe, die Ihre Website und deren Sammlungen finden, zählen bei den kleineren Tarifen gegen das Limit von Webflow von 60 pro Minute, daher wird die App angewiesen, ihre Antworten einen Tag lang zu behalten, statt bei jedem Besuch zu fragen. Dieser Connector hat keine Schalter für Berechtigungen.

Dateien, Bilder und Suche

AWS S3

Wofür es gedacht ist. Dateien, die Personen in Ihren Apps hochladen (Fotos, Dokumente, Anhänge), aufbewahrt in Ihrem eigenen S3-Bucket. Das eingebaute Backend speichert Einträge und keine Dateien, deshalb gehen Uploads hierhin.

Verbinden. Vier Werte: die Bucket region (wie eu-west-2, das ist London), der Bucket name (Kleinbuchstaben, Ziffern und Bindestriche, keine Punkte) sowie eine Access key ID und ein Secret access key von AWS unter IAM, dann Users, ein Nutzer, der nur für Setherion angelegt wurde, dann Security credentials, dann Create access key. Das Secret wird nur einmal angezeigt. Test connection liest den Bucket, lädt dann über einen signierten Link eine kleine Testdatei hoch, liest sie zurück, löscht sie und prüft, ob Ihr Bucket Uploads aus Browsern zulässt. Schlägt diese letzte Prüfung fehl, schauen Sie zuerst in die CORS-Einstellungen des Buckets.

Fragen. „Lass Kunden ihrer Reparaturanfrage ein Foto anhängen.“ „Zeige die hochgeladenen Dokumente jeder Bestellung auf der Bestellseite.“

Grenzen.

  • Dateien dürfen jeweils bis zu 25 MB groß sein.
  • Jede App erhält im Bucket einen eigenen Ordner, apps/ gefolgt von der ID der App, und Setherion lehnt jeden Schlüssel außerhalb davon ab. Ein Bucket kann alle Ihre Apps bedienen, ohne dass eine die Dateien einer anderen liest.
  • Besucher können keine Dateien auflisten. Eine Datei wird über ihren Schlüssel erreicht, den die App beim Eintrag aufbewahrt, und Links, die eine Datei zeigen, gelten eine Stunde.
  • Das Auflisten und Löschen der Dateien einer App ist nur dem Team der App vorbehalten. Hochladen und Anzeigen stehen allen offen, die die App nutzen.

Berechtigungen. Drei Schalter: Dateien hochladen, Dateien anzeigen sowie Dateien auflisten und löschen.

Gut zu wissen. Eine Dateiauswahl in der Vorschau des Editors lädt in Ihren echten Bucket hoch, genau wie die veröffentlichte App.

Cloudinary

Wofür es gedacht ist. Bilder und Dateien aus einer App hochladen und sie in der angezeigten Größe über das CDN von Cloudinary ausliefern.

Verbinden. Vier Werte: Cloud Name, ein Unsigned Upload Preset, ein API Key und ein API Secret. Legen Sie das Preset in Cloudinary unter Settings, dann Upload, als unsigniertes an. Die Schlüssel finden Sie unter Settings, dann API keys. Ohne Preset kann das Hochladen nicht funktionieren, und die App sagt das, statt so zu tun, als ginge es.

Fragen. „Lass Verkäufer Produktfotos hochladen und zeige sie in der passenden Größe.“ „Füge eine Galerie-Seite hinzu, auf der Besucher Bilder einsenden können.“

Grenzen. Der Browser lädt mit dem Preset direkt zu Ihrem Cloudinary hoch. Der Cloud-Name und das Preset gehen in die veröffentlichte App, wie Cloudinary es vorsieht. Das API Secret nicht: Setherion nutzt Key und Secret nur für Test connection, daher liegt nie ein Secret in der App. Jeder Upload und jeder Aufruf geht auf Ihr Cloudinary-Konto.

Gut zu wissen. Der Skill File upload baut auf diesem Connector auf: siehe Skills.

Algolia

Wofür es gedacht ist. Sofortige Suche schon während der Eingabe über Produkte, Artikel oder beliebige Einträge, die Sie indexieren.

Verbinden. Drei Werte aus dem Algolia-Dashboard unter Account, dann API keys: die Application ID, der Admin API Key und der Search-Only API Key.

Die zwei Schlüssel. Besucher suchen in ihrem Browser mit dem reinen Suchschlüssel, den man bedenkenlos veröffentlichen kann und der in die App geht. Der Admin-Schlüssel kann einen Index löschen, daher verlässt er nie unsere Server: Die App nutzt ihn über Setherion nur, um Einträge zu indexieren. Ist kein reiner Suchschlüssel gespeichert, kann die Suche nicht laufen, und die App sagt das, statt auf den Admin-Schlüssel zurückzugreifen. Datensätze oder einen Index löschen, einen leeren oder einen über einen anderen verschieben kann nur Ihr Team; Datensätze hinzufügen und aktualisieren kann jeder, der die App nutzt.

Fragen. „Füge dem Shop ein Suchfeld hinzu, das Produkte schon beim Tippen findet.“ „Indexiere meine Produkte in Algolia, wenn ich eines hinzufüge.“

Gut zu wissen. Der Skill Search baut auf diesem Connector auf: siehe Skills.

War diese Seite hilfreich?

Der Community beitreten

Fragen, Ideen und was andere erstellen.