Connectors

Ein Connector verbindet Ihre Apps mit einem Dienst, den Sie bereits haben: Stripe für Zahlungen, OpenAI für KI, Resend für E-Mail, Google Sheets für Daten. Sie verbinden ihn einmal in Ihrem Konto, und jede App, die Sie auswählen, kann ihn nutzen. Es gibt mehr als sechzig, von Zahlungen und Shops bis zu CRMs, Kalendern, KI- und Design-Werkzeugen.

Jede App hat bereits eine eigene Datenbank, Anmeldung und E-Mails, ohne dass etwas zu verbinden wäre: Das ist Cloud, ganz oben in der Liste, eingebaut und immer aktiv. Connectors sind für das, was von außen kommt.

Wo Sie sie finden

• Auf dem Dashboard oder im Editor: +, dann Connectors, um auszuwählen, welche diese App nutzen darf.
• Manage connectors am Ende dieses Fensters öffnet die Seite Connectors selbst, auf der Dienste verbunden werden. Sie öffnet sich über dem Editor oder dem Dashboard, sodass Sie Ihren Platz behalten.
• Auf der Seite Connectors filtert die Liste links die Kacheln nach All, Enabled, Custom connectors, MCP servers und nach Art des Dienstes, und das Suchfeld findet einen Dienst nach Namen.
• Mit + oben rechts fügen Sie einen hinzu, der nicht in der Liste steht: Beschreiben Sie ihn selbst mit Custom connector, oder bitten Sie uns mit Request a connector. MCP server gibt es dort auch, für die KI, die Ihre Apps erstellt, nicht für die Apps.
• Im Editor zeigt Manage, dann Integrations, was diese App nutzen kann. Siehe Integrationen.

Einen Dienst verbinden

Öffnen Sie den Dienst auf der Seite Connectors. Jeder sagt, was Ihre App damit tun kann, wo es wichtig ist auch, was er nicht tut, und wie stark Ihre Apps ihn in den letzten 30 Tagen genutzt haben. Es gibt zwei Wege: sich beim Dienst anmelden oder die Schlüssel einfügen, die er Ihnen gibt. Die Seite Connectors zeigt den, den jeder Dienst hat. Manche haben beide, und dann steht auf der Seite Sign in with the service, or add your own keys instead.

Mit einer Schaltfläche. Stripe, Notion, Google Sheets, Airtable, Slack, Discord, Calendly, Google Calendar, Microsoft 365, HubSpot, Pipedrive, Zoho CRM, Zoho Books, Salesforce, Linear, Asana, Atlassian (Jira und Confluence), Figma, Canva, GitHub und GitLab werden verbunden, indem Sie sich beim Dienst anmelden und zurückkehren. Sie sehen oder kopieren nie einen Schlüssel. Bei Stripe heißt die Schaltfläche Set up Stripe: siehe Onlineshops. Salesforce bittet Ihren Admin, vor der ersten Anmeldung einmal das Paket von Setherion zu installieren.

Mit Schlüsseln. Bei den anderen fügen Sie die Schlüssel, die der Dienst Ihnen gibt, unter Credentials ein. Where do I find these? öffnet die passende Seite des Dienstes, und jedes Feld hat einen Hinweis, der genau sagt, welchen Schlüssel es verlangt. Test connection probiert sie aus, bevor Sie sich darauf verlassen, und Connect speichert sie. Nach dem Verbinden ändert Update sie, und Remove nimmt sie weg. Ist Connect grau, ist ein Feld leer, oder Sie haben die Zeile noch nicht angekreuzt, die besagt, dass Sie die Bedingungen des Dienstes verstehen: Take me there springt dorthin.

Ein verbundener Dienst zeigt einen grünen Punkt auf seiner Kachel und Enabled neben seinem Namen. Vor der ersten Verbindung sagt jeder Dienst in einfachen Worten, was er für Sie bedeutet, und Sie kreuzen an, dass Sie das verstanden haben. Ein Abzeichen fasst es zusammen: Billed by der Dienst, wenn er Ihnen die Nutzung berechnet, zum Beispiel Billed by Supabase, Handles real money für Zahlungen und Shops und No usage charges für alle übrigen.

Der nächste Schritt nach Connect

Gleich nachdem Sie einen Dienst auf seiner Seite verbunden haben, erscheint eine Karte mit Stripe is connected. Next: use it in this app, oder build an app with it, wenn Sie vom Dashboard kamen. Ihre Schaltfläche, Use in this app oder Build an app with it, schreibt eine Startanfrage für Sie in den Chat, etwa „Use Stripe in this app: online payments, subscriptions and invoices“, und setzt den Dienst auf die Liste der App. Die Anfrage wartet im Nachrichtenfeld. Es wird nichts erstellt oder verbraucht, bis Sie auf Send klicken. Sie können die Karte schließen, und sie kommt bei späteren Besuchen nicht wieder. Design- und Code-Dienste wie Figma und GitHub haben keine solche Karte, weil sie beim Erstellen einer App gelesen werden, statt von ihr genutzt zu werden.

Was ein Dienst nicht tut

Wo ein Dienst eine offensichtliche Grenze hat, sagt seine Seite es in einem grauen Hinweis, mit einer Schaltfläche zu den Connectors, die die Aufgabe stattdessen erledigen. PayPal ist das Beispiel: Jede Schaltfläche kauft einen Artikel, es gibt keinen Warenkorb, und Ihre App erfährt nicht, wenn jemand bezahlt, deshalb verweist der Hinweis auf Stripe und Paddle.

Wählen, welche Apps ihn nutzen

Einen Dienst zu verbinden, setzt ihn nicht in jede App. Öffnen Sie in der App +, dann Connectors, kreuzen Sie an, welche diese App nutzen darf, und klicken Sie auf Done. Alles, was Sie weglassen, bleibt außerhalb des Codes und der Schlüssel der App. Neben einem Dienst, der noch nicht verbunden ist, steht Connect, das Sie zu seiner Seite führt.

Dann sagen Sie im Chat, was er tun soll:

Sie müssen nicht zuerst ankreuzen. Nennt Ihre Nachricht einen Dienst, den die App noch nicht erreichen kann, bietet eine Leiste über dem Nachrichtenfeld mit This needs Stripe drei Antworten an: Use it here, wenn er bereits verbunden ist, Connect mit einem Schlüssel oder der eigenen Anmeldung des Dienstes, gleich dort, oder Build without it. Ohne ihn sagt die App, dass die Funktion nicht eingerichtet ist, statt vorzutäuschen, dass sie funktioniert.

Permissions

Manche Dienste führen auf, was Ihre Apps damit tun dürfen, unter Permissions auf ihrer Seite, sobald sie verbunden sind. Jede Zeile hat zwei Schaltflächen: Das Häkchen erlaubt es, der durchgestrichene Kreis schaltet es aus.

• Eine Änderung wird gespeichert, sobald Sie darauf klicken, und gilt sofort für jede App, die die Verbindung nutzt, auch für veröffentlichte.
• Eine App, die etwas Ausgeschaltetes versucht, erhält einen Fehler, der das sagt und nennt, wo man es wieder einschaltet. Neue Builds werden informiert und lassen es weg.
• Der Dienst gewährt Ihrem Schlüssel oder Ihrer Anmeldung weiterhin alles, was ihm gegeben wurde. Diese Grenzen sind die von Setherion, zusätzlich gesetzt.
• Wird die Verbindung entfernt, ist wieder alles eingeschaltet.

Bei Shopify ist es anders. Ihre Apps rufen es direkt von der Seite aus mit seinem Storefront-Token auf, der von Natur aus öffentlich ist, daher werden seine Grenzen in Shopify gesetzt: Öffnen Sie Sales channels, dann Headless, dann Ihren Storefront, klicken Sie neben Storefront API auf Manage und bearbeiten Sie Permissions. Seine Seite bei Setherion zeigt dieselben Schritte.

Bei Supabase, Firebase, Google Maps und Cloudinary ist es genauso: Ihre Apps rufen sie direkt von der Seite aus auf, daher werden ihre Grenzen im jeweiligen Dienst gesetzt, und ihre Seite bei Setherion sagt, wo.

Jeder andere Dienst sagt in einem Satz unter Permissions alles, was Ihre Apps damit tun können, etwa nur E-Mails senden oder nur Ihre Produkte lesen. Canva, Figma, GitHub und GitLab sagen, dass Ihre Apps sie nie verwenden: nur Sie, im Editor.

HubSpot

HubSpot bringt Ihr CRM in Ihre Apps: Kontakte, Unternehmen, Deals und Tickets. Es gibt zwei Wege, es zu verbinden.

• Connect with HubSpot: Melden Sie sich bei HubSpot an, wählen Sie das Konto und bestätigen Sie. Solange HubSpot die Prüfung von Setherion nicht abgeschlossen hat, warnt sein Bildschirm, dass die App noch nicht verifiziert ist, und verlangt, dass Sie „I accept the risk“ eingeben, um fortzufahren.
• A service key: Öffnen Sie in HubSpot Development, dann Keys, dann Service keys, und erstellen Sie einen mit Lese- und Schreibzugriff für Kontakte, Unternehmen, Deals und Tickets. Fügen Sie ihn unter Credentials ein. Die Schlüssel von HubSpot beginnen mit pat-.

Wer es in einer veröffentlichten App nutzen darf:

• Anyone: Ein Formular auf Ihrer Website darf einen Kontakt oder ein Ticket hinzufügen.
• Your team only: das CRM lesen und alles darin ändern. Markieren Sie die Konten, die Ihr Team sind, unter Manage, dann Cloud, dann Users. Siehe Im Team arbeiten.

Damit Apps Ihre Deals nicht ändern können, sie aber weiterhin lesen, schalten Sie Change für Deals unter Permissions aus.

Ihr eigenes Supabase

Supabase ist optional: Jede App hat bereits ein Backend. Verbinden Sie es, wenn Sie die Daten einer App in einem eigenen Supabase-Projekt haben möchten.

• Credentials: die Adresse des Projekts und sein anon key, der von Natur aus öffentlich ist. Der service role key ist optional.
• Connect Supabase account unter Creating the tables lässt Setherion die Tabellen, die eine App braucht, in Ihrem Projekt anlegen, über Manage, dann Cloud, jedes Mal, wenn Sie dort auf die Schaltfläche klicken. Sie melden sich bei Supabase an und bestätigen. Die Berechtigung bleibt auf den Servern von Setherion und wird nie an die Apps weitergegeben, die Sie veröffentlichen. Ohne sie sind die Tabellen trotzdem da, und Sie können sie kopieren und selbst in Supabase einfügen.

Wie Sie eine App, die schon Daten hat, in Ihr eigenes Supabase verschieben, lesen Sie unter Erweiterte Einstellungen.

Was es gibt

Jeder Connector, so gruppiert wie die Seiten, die ihn beschreiben. Jede Seite hat pro Dienst ein Aufklappmenü: wofür er da ist, welche Schlüssel er verlangt und wo Sie sie finden, worum Sie bitten können, seine Schalter und seine Grenzen.

Für einen Dienst, der nicht in der Liste steht, beschreiben Sie ihn selbst: siehe Eigene Connectors. Für einen einzelnen Schlüssel, den eine App braucht, genügen Schlüssel und Secrets.

Wer eine Verbindung nutzen kann

Ihre Schlüssel erreichen nie einen Besucher, deshalb ruft eine veröffentlichte App einen Dienst über Setherion auf, und Setherion entscheidet, was erlaubt ist.

• Nur die Pfade, die eine App braucht. Eine App, die E-Mails sendet, kann senden, aber nicht an Ihr Konto, Ihre Schlüssel oder Ihre Domains. Ein Shop-Frontend liest Produkte und kann keine Bestellungen oder Kunden lesen.
• Absender und Konto stehen fest. Eine App kann keine andere Absenderadresse, Telefonnummer, keinen anderen Kalender und keine andere Liste wählen als die, die Sie gespeichert haben.
• Ihr Team und Ihre Besucher sind verschieden. Bei einem CRM darf das Formular eines Besuchers einen Lead hinterlassen, und nur Ihr Team darf alles lesen oder ändern. Markieren Sie Ihr Team unter Manage, dann Cloud, dann Users. Die Seite jedes Connectors sagt, welche seiner Aktionen öffentlich sind.
• Alles, was eine Person erreicht oder Geld kostet, ist mengenbegrenzt. E-Mails, SMS, Chatnachrichten, Registrierungen und Zahlungen sind auf etwa zehn Aufrufe pro Stunde und Besucher begrenzt. Lesezugriffe auf Ihre eigenen Daten erlauben weit mehr. Eine App, die darüber hinausgeht, wird aufgefordert, es später erneut zu versuchen.
• Eine Tages- und eine Monatssicherung. Eine App kann am Tag ein paar tausend Aufrufe an Dienste machen, und die Aufrufe einer veröffentlichten App verbrauchen Integrations-Credits.

In einem Team-Arbeitsbereich

Im Tarif Business gibt Settings, dann Connector settings, einem Team-Arbeitsbereich zwei Möglichkeiten. Nur der Inhaber oder ein Admin kann die erste ändern, und nur der Inhaber kann verleihen.

• Welche Connectors die Apps des Arbeitsbereichs nutzen dürfen. Ein Connector, der nicht erlaubt ist, wird bei jedem Build weggelassen, legt keinen Schlüssel in eine veröffentlichte App, und jeder Aufruf dorthin wird abgelehnt.
• Die Verbindungen des Inhabers verleihen. Die App eines Mitglieds kann die Verbindung des Inhabers zu einem Dienst nutzen, den das Mitglied nicht selbst verbunden hat. Die Schlüssel bleiben auf unseren Servern und erreichen das Mitglied nie. Der Anbieter berechnet dem Konto des Inhabers diese Aufrufe, und sie zählen zu den Integrations-Credits des Erstellers.

Zahlungen, Shops und Datenbanken werden nie verliehen: Ihre Konten, Auszahlungen und Daten gehören dem, der sie verbunden hat. Siehe Arbeitsbereiche.

Eigene Connectors und MCP-Server

Für einen Dienst, der nicht in der Liste steht, beschreiben Sie ihn selbst: siehe Eigene Connectors. Um der KI, die Ihre Apps erstellt, eigene Werkzeuge zu geben, fügen Sie einen MCP-Server hinzu.

Gut zu wissen

• Ein Aufruf einer veröffentlichten App an einen verbundenen Dienst verbraucht einen Integrations-Credit. Siehe Credits. Was jede App ausgegeben hat, sehen Sie unter Verbrauch.
• Dienste, die Ihnen die Nutzung berechnen, wie Resend, Twilio oder OpenAI, berechnen sie Ihrem eigenen Konto, zu ihren Preisen. Legen Sie dort ein Ausgabenlimit fest: Setherion begrenzt, wie schnell eine App aufrufen darf, was Missbrauch verhindert, kann aber nicht begrenzen, was Sie ausgeben.
• Wenn eine App einen Dienst aufruft, der nicht verbunden ist, sagt Manage, dann Integrations, das, mit Add the key.
• Wird ein Dienst getrennt, können alle Apps, die ihn nutzen, ihn sofort nicht mehr erreichen.