Einen Marketplace-Connector installieren

Ein Marketplace-Connector (Item-Typ node) ist eine WebAssembly-Komponente, die dem Workflow-Builder einen wiederverwendbaren Node-Typ hinzufügt. Nach der Installation erscheint er in der Node-Palette und kann in jeden Workflow deines Workspace eingebunden werden — wobei der Netzwerk-Egress auf die Ressource-Credentials beschränkt ist, die du bei der Installation zuordnest.

Den Katalog durchsuchen

Öffne die Seite Marketplace in der Seitenleiste. Nutze die Filterleiste, um die Ergebnisse einzugrenzen:

• Art — wähle Connector, um nur node-Items anzuzeigen.
• Suche — Teilstring-Suche über Name und Zusammenfassung eines Items.
• Verifiziert — aktiviere das Häkchen, um nur Items anzuzeigen, die das automatische Review-Gate bestanden haben.

Jedes Listing zeigt den aktuellen Preis (kostenlos oder Einmalkauf), den Herausgeber, die Installationsanzahl und die durchschnittliche Käuferbewertung.

Hinweis

Alle kostenpflichtigen und zentralen (offiziellen) Connectors müssen ein verpflichtendes automatisches Review durchlaufen, bevor sie das Badge Verifiziert erhalten. Kostenlose Community-Listings nutzen eine Nachveröffentlichungs-Moderation.

Einen Connector installieren

1. Item-Seite öffnen. Klicke auf einen Connector im Katalog, um dessen Detailseite anzuzeigen: Port-Schema, deklarierte Ressource-Anforderungen, Capabilities und Changelog.

2. Installations-Assistent öffnen. Klicke beim Item auf Installieren. Der erste Schritt ist die Installationsvorschau, in der SupaCloud transitive Abhängigkeiten auflöst (andere Marketplace-Items, auf die der Connector angewiesen ist) und alle benötigten Ressource-Arten auflistet (zum Beispiel seafile_webdav).

3. Ressourcen zuordnen. Wähle für jede erforderliche Ressource-Art eine vorhandene Workspace-Ressource dieser Art aus dem Dropdown aus. (Lege die Ressource vorher unter Ressourcen an, falls du noch keine hast.) Der Connector kann nur die Hosts erreichen, die von den hier zugeordneten Ressourcen deklariert werden — es wird kein allgemeiner Netzwerkzugriff gewährt.

4. Capability-Oberfläche akzeptieren. Lies die deklarierten Capabilities des Connectors und bestätige sie. Dieser Schritt ist verpflichtend; die Installation wird erst nach deiner Bestätigung fortgesetzt.

5. Installation abschließen. Klicke im abschließenden Bestätigungsschritt auf Installieren. (Bei kostenpflichtigen Items musst du den Stripe-Checkout zuvor im Vorschau-Schritt abschließen, bevor du fortfahren kannst.) SupaCloud registriert den Connector in der Node-Typ-Registry deines Workspace.

Tipp

Ein installiertes Item zeigt einen „Update verfügbar“-Chip auf seiner Katalogkarte und ein Update-Banner auf seiner Detailseite, sobald eine neuere Version veröffentlicht wird.

Ein Paket mit Datenbankschema installieren

Manche Marketplace-Items — ein Workflow oder Skript, das eigene Tabellen braucht, nicht nur ein Connector — bringen ein gemeinsames Datenbankschema mit (ADR 0057). Deklariert ein Item eines, wendet die Installation dessen Migrationen auf eine von dir zugeordnete PostgreSQL-Ressource an, sodass die Flows des Items schon beim ersten Lauf ihre Tabellen haben.

• Die Installation erfordert eine postgresql-Ressourcenzuordnung. Die Installationsvorschau führt postgresql unter den benötigten Ressourcen auf; ordne eine vorhandene PostgreSQL-Ressource zu (oder lege zuerst eine unter Ressourcen an). Ohne sie wird die Installation abgelehnt — das Schema wird nie stillschweigend übersprungen.
• Die Vorschau legt den Datenbank-Fußabdruck offen: den Schemanamen, seine Mandantenisolierung und den Namen jeder Migration mit einem SHA-256- Fingerabdruck ihres SQL, sodass du vor dem Bestätigen genau prüfen kannst, was ausgeführt wird.
• Die Anwendung ist Alles-oder-nichts: Kann das Schema nicht angewendet werden, wird die Installation abgelehnt und es bleibt nichts zurück. Eine erneute Installation setzt sauber fort.

Achtung

Die Migrationen eines Pakets laufen auf der von dir zugeordneten Datenbank, mit den Rechten dieser Ressource. Nur signierte, verifizierte zentrale Katalog-Items dürfen ein Schema mitbringen — ordne eine least-privileged PostgreSQL-Rolle mit Rechten nur auf das Zielschema zu statt eines Superusers.

Den Connector in einem Workflow verwenden

Nach der Installation steht der Connector-Node-Typ im Workflow-Builder zur Verfügung:

1. Öffne oder erstelle einen Workflow unter Workflows.
2. Klicke auf der Canvas auf die Schaltfläche +, um die Node-Palette zu öffnen.
3. Suche den Connector unter seiner Kategorie oder nach Name.
4. Ziehe ihn auf die Canvas und verbinde seine Eingangs- und Ausgangsports mit anderen Nodes.
5. Im Einstellungsbereich des Nodes sind die bei der Installation zugeordneten Ressource-Bindungen bereits vorausgefüllt — du kannst die Bindung pro Node ändern, wenn dein Workspace mehrere Ressourcen derselben Art enthält.

Hinweis

Die Connector-Ausführung ist sandboxed: Ausgehende HTTP-Anfragen sind auf die zugelassenen Egress-Authorities der zugeordneten Ressource beschränkt, und jede Anfrage wird vor dem Verlassen des Hosts auf SSRF geprüft.

Bewertungen und Updates

Eine Bewertung abgeben. Sobald du den Connector installiert hast, ermöglicht dir das Bewertungsformular auf der Item-Detailseite, eine Sternebewertung (1–5) und einen kurzen Kommentar zu hinterlassen. Bewertungen sind installationsgebunden — nur ein Workspace, der das Item installiert hat, kann es bewerten.

Update-Signal. Wenn der Herausgeber eine neue Version veröffentlicht, erscheint das Badge Update verfügbar auf der Katalogkarte des Items und ein Update-Banner auf dessen Detailseite. Klicke auf Jetzt aktualisieren, um die neueste Version in einem Schritt anzuwenden; deine vorhandenen Ressource-Zuordnungen bleiben erhalten.

Siehe auch

• Dein erster Agent-Run
• Referenz: Web-Terminal-Befehle
• ADR 0034 — Marketplace: Workflows, Scripts und Connector-Nodes