Connecter des servicesConnecteurs

Données et contenu

Bases de données, feuilles de calcul, systèmes de contenu, stockage de fichiers et recherche que vous pouvez connecter à une application : Supabase, Neon, Firebase, Airtable, Notion, Google Sheets, WordPress, Contentful, Storyblok, Webflow, AWS S3, Cloudinary et Algolia.

Chaque application a déjà sa propre base de données, sa propre connexion et ses propres e-mails : c’est Cloud. Connectez l’un de ces services quand les données vivent déjà ailleurs, quand vous voulez qu’elles vivent dans un compte à vous, ou quand l’application a besoin de quelque chose que Cloud ne fait pas, comme conserver des fichiers téléversés.

Cette page présente un service par entrée. Pour savoir comment la connexion fonctionne en général (le bouton ou les clés, Test connection, le choix des applications qui utilisent un service, les autorisations), voir Connecteurs.

ServiceÀ quoi il sertComment il se connecte
SupabaseVotre propre projet Supabase à la place du backend intégréAdresse du projet et clés
NeonVotre propre Postgres, avec vos propres règles de lignesL’adresse de la Data API
FirebaseFirestore et la connexion depuis votre projet FirebaseTrois valeurs de la console Firebase
AirtableDes tables comme base de donnéesUn bouton, ou un jeton
NotionPages et bases de donnéesUn bouton, ou un jeton
Google SheetsUne feuille de calcul comme base de donnéesUn bouton, ou une clé d’API
WordPressArticles et pages d’un site WordPressAdresse du site et mot de passe d’application
ContentfulEntrées d’un CMS headlessSpace ID et jeton de diffusion
StoryblokStories d’un CMS headlessUn jeton d’accès public
WebflowCollections du CMS WebflowUn jeton de site
AWS S3Fichiers que les gens téléversentRégion, bucket et clé d’accès
CloudinaryImages et fichiers, redimensionnés à la livraisonCloud name, upload preset et clés
AlgoliaRecherche au fil de la frappeApplication ID et deux clés

Quelques points valent pour tous :

  • Les clés secrètes restent sur les serveurs de Setherion, et votre application publiée appelle le service par l’intermédiaire de Setherion. Seules les valeurs publiques par conception arrivent dans le navigateur : la clé anon de Supabase, les paramètres Firebase, le cloud name et l’upload preset de Cloudinary, la clé de recherche seule d’Algolia, et une clé d’API Google Sheets.
  • Les services qui vous facturent directement affichent Billed by et leur nom sur leur page, et vous demandent de l’accepter avant de vous connecter. Neon, Firebase, Supabase, Airtable, Cloudinary, Algolia et AWS S3 font partie de ce groupe. Notion, Google Sheets, WordPress, Contentful, Storyblok et Webflow affichent No usage charges.
  • Chaque appel qu’une application publiée fait par l’intermédiaire de Setherion utilise un crédit d’intégration. Voir Forfaits et crédits.
  • Test connection existe pour chaque service ici sauf Firebase.
  • Dans un espace de travail d’équipe, le propriétaire peut prêter certaines connexions aux applications des membres (voir Espaces de travail). Supabase, Neon et Firebase ne sont jamais prêtés, ni aucun service dont les valeurs sont intégrées à l’application publiée : ici Cloudinary, Algolia et Google Sheets.

Bases de données et tables

Supabase

À quoi il sert. Votre propre projet Supabase : sa base de données, sa connexion et son stockage de fichiers. Il est facultatif, car chaque application a déjà un backend. Choisissez-le quand vous voulez que les données d’une application soient dans un projet qui est le vôtre. Tant que Supabase est activé pour une application, celle-ci l’utilise pour les données, la connexion et les fichiers à la place du backend intégré.

Connexion. Collez le Project URL (comme https://abcdefgh.supabase.co) et l’Anon Key, tous deux depuis Supabase sous Project Settings, puis API. La clé anon commence par eyJ ou sb_publishable_ ; utilisez le bouton de copie de Supabase, car une clé tronquée est refusée. La Service Role Key est facultative, et commence par eyJ ou sb_secret_.

Création des tables. Appuyez sur Connect Supabase account, connectez-vous chez Supabase et approuvez. Ensuite, dans une application qui a besoin de tables, Manage, puis Cloud, propose un bouton qui les crée dans votre projet à chaque fois que vous appuyez dessus. L’autorisation reste sur nos serveurs. Sans elle, le même SQL est là pour que vous le copiiez vous-même dans Supabase. Une fois votre compte connecté, une liste Your projects vous permet aussi d’appuyer sur Use this project au lieu de coller les clés.

Demandez. « Enregistre les réservations dans mon Supabase et laisse les clients se connecter avec leur e-mail. » « Ajoute une table pour les produits avec un nom, un prix et une photo. »

À savoir. Les applications sur votre propre Supabase ne peuvent pas encore utiliser les Clés et secrets. Pour déplacer une application qui a déjà des données, voir Paramètres avancés.

Neon

À quoi il sert. Votre propre Postgres sur Neon comme base de données de l’application. Setherion l’atteint par la Data API de Neon, et Postgres décide lui-même qui voit quelle ligne, grâce à la sécurité au niveau des lignes. Cela convient à une application où chaque personne voit ses propres lignes, à un catalogue que tout le monde peut lire, ou à une vue d’équipe.

Connexion. Collez la Data API address de Neon : votre projet, puis Data API, le point d’accès REST qui se termine par /rest/v1. Elle doit être sur neon.tech. Appuyez ensuite sur Test connection. Tant que Neon n’a pas été informé qu’il doit faire confiance à Setherion, il refuse, et le résultat vous donne l’adresse JWKS à y coller.

L’étape JWKS. Dans Neon, ouvrez Data API, puis Authentication, choisissez un fournisseur personnalisé et collez cette adresse JWKS. Laissez l’audience vide. C’est ainsi que Neon apprend à faire confiance à la personne connectée que Setherion envoie avec chaque appel. Si Test répond toujours non au bout de quelques minutes, supprimez le fournisseur dans Neon et ajoutez-le de nouveau.

Demandez. « Garde une liste de tâches pour chaque personne connectée dans ma base de données Neon. » « Affiche la table des produits de Neon sous forme de page de boutique, filtrée par catégorie. »

Autorisations. Trois interrupteurs sous Permissions : lire des lignes, ajouter, modifier et supprimer des lignes, et exécuter des fonctions de la base de données.

À savoir. Les tables n’existent qu’une fois que vous avez exécuté le SQL que l’IA écrit pour elles (un fichier appelé neon/setup.sql), une seule fois, dans le SQL Editor de Neon. Un visiteur qui n’est pas connecté n’atteint que ce que vous avez accordé au rôle anonyme de Neon.

Firebase

À quoi il sert. Firestore pour les données et Firebase Authentication pour la connexion, depuis votre propre projet Firebase. Rien d’autre de Firebase n’est pris en charge.

Connexion. Trois valeurs, tirées des paramètres de l’application web de votre projet dans la console Firebase : l’API Key (commence par AIza), le Project ID et l’App ID (comme 1:123:web:abc). Les trois sont publiques par conception et vont dans l’application publiée. Il n’y a pas de Test connection pour Firebase : Connect conserve les valeurs.

Demandez. « Laisse les gens créer un compte et garder une liste privée de notes dans Firestore. » « Affiche une liste en direct de messages depuis mon projet Firebase. »

À savoir. Chez Firebase, ce n’est pas la clé qui protège vos données : ce sont les règles de sécurité. N’importe qui peut lire les paramètres dans une application publiée, donc un projet laissé en mode test est ouvert à tout internet. Définissez les règles Firestore dans la console Firebase avant que l’application ne stocke quoi que ce soit de personnel. L’IA écrit chaque document de façon qu’il appartienne à un id d’utilisateur de Firebase Authentication, et le dit à l’écran quand l’application stocke des données personnelles.

Airtable

À quoi il sert. Une table de lignes comme base de données de l’application : un CRM, une liste de stock, du contenu que vous gardez dans Airtable.

Connexion. Appuyez sur Connect with Airtable, connectez-vous et cochez les bases que l’application peut utiliser, puis appuyez sur Choose base et choisissez-en une. Ou utilisez des clés à la place : un Personal Access Token (commence par pat) depuis votre compte Airtable, et le Base ID (commence par app, visible dans l’adresse de votre base).

Demandez. « Affiche mon stock depuis la table Products d’Airtable, avec la photo et le prix. » « Ajoute chaque demande du formulaire de contact comme une nouvelle ligne dans ma table Enquiries. »

Limites. Les applications atteignent la seule base que vous avez choisie et rien d’autre dans votre compte, même si le jeton pouvait faire davantage. Une table dont le nom contient des espaces est prise en charge pour vous. Airtable renvoie les longues tables une page à la fois, et l’application reçoit la consigne de récupérer chaque page ou de dire que la liste est partielle. Test connection lit les tables de la base, il échoue donc si cette base n’a pas été cochée.

Pages et feuilles

Notion

À quoi il sert. Une base de données Notion comme système de contenu léger ou liste de tâches, et des pages Notion affichées ou remplies par une application.

Connexion. Appuyez sur Connect with Notion, connectez-vous et cochez les pages que l’application peut utiliser. L’application peut alors lire et écrire ces pages et rien d’autre. Ou utilisez un jeton : créez une intégration interne sur notion.so/my-integrations et collez son Internal Integration Token (commence par ntn_ ou secret_), avec un Default Database ID facultatif. Avec un jeton, partagez chaque page ou base de données avec l’intégration dans Notion, sinon Notion répond 404 à tout.

Demandez. « Affiche la page de l’équipe depuis ma base de données Notion, avec la photo et le rôle de chaque personne. » « Ajoute chaque message de formulaire comme une nouvelle ligne dans mes tâches Notion. »

Limites. Une requête renvoie au plus 100 lignes, donc pour une longue base de données l’application reçoit la consigne de continuer à demander jusqu’à ce que Notion dise qu’il n’y en a plus.

À savoir. L’IA qui construit vos applications peut aussi lire votre Notion par un serveur MCP, ce qui est distinct : voir Serveurs MCP.

Google Sheets

À quoi il sert. Une feuille de calcul que vous modifiez comme données de l’application : des prix, un menu, des annonces, des membres de l’équipe, et des inscriptions recueillies sous forme de lignes.

Connexion, avec le bouton. Appuyez sur Connect with Google, connectez-vous, puis appuyez sur Choose spreadsheet et choisissez le fichier voulu. La feuille reste privée, l’application la lit et l’écrit par l’intermédiaire de Setherion, et le reste de votre Drive reste hors d’atteinte.

Connexion, avec une clé. Collez une clé d’API Google avec l’API Google Sheets activée dans Google Cloud, limitée à cette API et à votre site, et l’id de la feuille. Cette méthode ne fonctionne que sur une feuille partagée en « toute personne disposant du lien peut afficher », et uniquement en lecture.

Demandez. « Affiche la liste de prix de ma feuille et mets-la à jour quand je modifie la feuille. » « Ajoute chaque demande de réservation comme une nouvelle ligne au bas de ma feuille. »

Limites. Avec le bouton, une seule feuille de calcul et les onglets qu’elle contient. Une plage désigne un onglet : si vous renommez un onglet, dites-le dans la discussion.

Notion, Airtable et Google Sheets sont atteints par l’intermédiaire de Setherion au nom de toutes les personnes qui ouvrent votre application publiée. Ne connectez que ce que l’application est censée afficher ou remplir.

Du contenu depuis un CMS

Ces quatre-là lisent du contenu que vous écrivez ailleurs et l’affichent dans votre application. Tous les quatre ne font que lire, et seulement ce qui est publié : un brouillon n’atteint jamais une page publique.

WordPress

À quoi il sert. Les articles, pages et médias publiés d’un site WordPress, affichés dans une application : un blog, une page d’actualités, un portfolio.

Connexion. La Site address (elle doit commencer par https://), un Username et un Application password. Créez-le dans WordPress sous Users, puis Profile, puis Application Passwords, puis Add New. Le forfait gratuit de WordPress.com n’en propose pas. Test connection se connecte au site.

Demandez. « Ajoute une page de blog qui liste mes 10 articles WordPress les plus récents avec leurs images. » « Affiche chaque article sur sa propre page, à partir de son slug. »

Autorisations. Un interrupteur Read pour chacun : articles, pages, images et fichiers, catégories, étiquettes et commentaires.

À savoir. Rien n’est jamais écrit sur le site. Les articles et les pages sont affichés tels que publiés, et les commentaires tels qu’approuvés. Le texte d’un article arrive en HTML depuis votre propre site, donc l’application le dessine avec sa propre typographie.

Contentful

À quoi il sert. Des entrées écrites dans Contentful : articles, produits, pages, membres de l’équipe, quels que soient vos types de contenu.

Connexion. Le Space ID (Settings, puis General settings) et le Content Delivery API token (Settings, puis API keys). Utilisez le jeton de diffusion, pas celui de gestion. L’Environment est facultatif et vaut master lorsqu’il est laissé vide. Test connection lit vos types de contenu.

Demandez. « Affiche mes articles de blog depuis Contentful, les plus récents d’abord, avec l’image de couverture. » « Fais une page pour chaque entrée de produit, retrouvée par son slug. »

Autorisations. Un interrupteur Read pour chacun : entrées, images et fichiers, et types de contenu.

À savoir. Les noms de champs viennent de votre modèle de contenu, donc l’IA lit d’abord les types de contenu au lieu de deviner. Un champ de texte enrichi arrive sous forme d’arbre de document que l’application dessine elle-même.

Storyblok

À quoi il sert. Des stories, des pages et des blocs écrits dans Storyblok : un blog, une page d’atterrissage, une liste de produits ou de membres de l’équipe.

Connexion. Un Access token : dans Storyblok, Settings, puis Access tokens, un jeton Public. La Region est facultative : eu (par défaut) ou us, comme indiqué dans les paramètres de votre space.

Demandez. « Liste les stories les plus récentes sous le dossier blog. » « Construis la page À propos à partir de la story dont le slug est about. »

Autorisations. Un interrupteur Read pour chacun : stories, liens, entrées de datasource et étiquettes.

À savoir. Seul le contenu publié est lu : Setherion l’impose, donc un jeton de prévisualisation collé par erreur ne peut pas mettre de brouillons sur une page publique. Une story est un arbre de blocs, et l’application dessine ceux que votre space utilise.

Webflow

À quoi il sert. Les collections que vous écrivez dans le CMS Webflow : un blog, une équipe, un menu, des projets ou des lieux.

Connexion. Un Site API token. Dans Webflow, ouvrez Site settings, puis Apps & integrations, puis API access, et générez un jeton avec CMS et Sites réglés sur Read-only.

Demandez. « Affiche les articles de blog les plus récents de ma collection Webflow. » « Donne à chaque membre de l’équipe sa propre page, à partir du slug de l’élément. »

Limites. Seuls les éléments publiés sont lus. Ils viennent du cache de Webflow, donc un changement peut mettre quelques minutes à apparaître. Les appels qui trouvent votre site et ses collections comptent dans la limite de Webflow de 60 par minute sur les forfaits plus petits, donc l’application reçoit la consigne de garder leurs réponses pendant un jour au lieu de les redemander à chaque visite. Ce connecteur n’a pas d’interrupteurs d’autorisations.

Fichiers, images et recherche

AWS S3

À quoi il sert. Les fichiers que les gens téléversent dans vos applications (photos, documents, pièces jointes), conservés dans votre propre bucket S3. Le backend intégré conserve des enregistrements et aucun fichier, c’est donc ici que vont les téléversements.

Connexion. Quatre valeurs : la Bucket region (comme eu-west-2, qui est Londres), le Bucket name (lettres minuscules, chiffres et tirets, sans points), et un Access key ID et une Secret access key depuis AWS sous IAM, puis Users, un utilisateur créé uniquement pour Setherion, puis Security credentials, puis Create access key. Le secret n’est affiché qu’une fois. Test connection lit le bucket, puis téléverse un petit fichier de test par un lien signé, le relit, le supprime, et vérifie que votre bucket laisse les navigateurs téléverser. Si cette dernière vérification échoue, regardez d’abord les paramètres CORS du bucket.

Demandez. « Laisse les clients joindre une photo à leur demande de réparation. » « Affiche les documents téléversés de chaque commande sur la page de la commande. »

Limites.

  • Les fichiers font jusqu’à 25 Mo chacun.
  • Chaque application a son propre dossier dans le bucket, apps/ suivi de l’id de l’application, et Setherion refuse toute clé en dehors. Un seul bucket peut servir toutes vos applications sans que l’une lise les fichiers d’une autre.
  • Les visiteurs ne peuvent pas lister les fichiers. Un fichier s’atteint par sa clé, que l’application garde avec l’enregistrement, et les liens qui affichent un fichier durent une heure.
  • Lister et supprimer les fichiers d’une application est réservé à l’équipe de l’application. Téléverser et afficher sont ouverts à toute personne qui utilise l’application.

Autorisations. Trois interrupteurs : téléverser des fichiers, afficher des fichiers, et lister et supprimer des fichiers.

À savoir. Un sélecteur de fichiers dans l’aperçu de l’éditeur téléverse vers votre vrai bucket, exactement comme l’application publiée.

Cloudinary

À quoi il sert. Téléverser des images et des fichiers depuis une application, et les livrer à la taille affichée, par le CDN de Cloudinary.

Connexion. Quatre valeurs : Cloud Name, un Unsigned Upload Preset, une API Key et un API Secret. Créez le preset dans Cloudinary sous Settings, puis Upload, de type unsigned. Les clés se trouvent sous Settings, puis API keys. Sans preset, le téléversement ne peut pas fonctionner, et l’application le dit au lieu de faire semblant.

Demandez. « Laisse les vendeurs téléverser des photos de produits et affiche-les à la bonne taille. » « Ajoute une page de galerie où les visiteurs peuvent envoyer des images. »

Limites. Le navigateur téléverse directement vers votre Cloudinary avec le preset. Le cloud name et le preset vont dans l’application publiée, comme Cloudinary le prévoit. L’API secret, non : Setherion n’utilise la clé et le secret que pour Test connection, donc aucun secret ne se trouve jamais dans l’application. Chaque téléversement et chaque affichage sont sur votre compte Cloudinary.

À savoir. Le skill File upload repose sur ce connecteur : voir Skills.

Algolia

À quoi il sert. Une recherche instantanée, au fil de la frappe, sur des produits, des articles ou tout élément que vous indexez.

Connexion. Trois valeurs depuis le tableau de bord d’Algolia sous Account, puis API keys : l’Application ID, l’Admin API Key et la Search-Only API Key.

Les deux clés. Les visiteurs cherchent dans leur navigateur avec la clé de recherche seule, qui peut être publiée sans risque et va dans l’application. La clé admin peut supprimer un index, donc elle ne quitte jamais nos serveurs : l’application ne l’utilise, par l’intermédiaire de Setherion, que pour indexer des enregistrements. Sans clé de recherche seule enregistrée, la recherche ne peut pas fonctionner, et l’application le dit au lieu de se rabattre sur la clé admin. Supprimer des enregistrements ou un index, le vider ou en déplacer un sur un autre est réservé à votre équipe ; ajouter et mettre à jour des enregistrements fonctionne pour toute personne qui utilise l’application.

Demandez. « Ajoute une zone de recherche à la boutique qui trouve les produits pendant que je tape. » « Indexe mes produits dans Algolia quand j’en ajoute un. »

À savoir. Le skill Search repose sur ce connecteur : voir Skills.

Cette page vous a-t-elle été utile ?

Rejoindre la communauté

Questions, idées et ce que construisent les autres.