Connecteurs

Un connecteur relie vos applications à un service que vous avez déjà : Stripe pour les paiements, OpenAI pour l’IA, Resend pour l’e-mail, Google Sheets pour les données. Vous le connectez une fois, sur votre compte, et chaque application que vous choisissez peut l’utiliser. Il y en a plus de soixante, des paiements et des boutiques aux CRM, aux agendas, à l’IA et aux outils de design.

Chaque application a déjà une base de données, une connexion et des e-mails à elle, sans rien à connecter : c’est Cloud, en haut de la liste, intégré et toujours actif. Les connecteurs servent pour ce qui vient de l’extérieur.

Où les trouver

• Sur le tableau de bord ou dans l’éditeur : +, puis Connectors, pour choisir ceux que cette application peut utiliser.
• Manage connectors, au bas de cette fenêtre, ouvre la page Connectors elle-même, où l’on connecte les services. Elle s’ouvre par-dessus l’éditeur ou le tableau de bord, donc vous gardez votre place.
• Sur la page Connectors, la liste à gauche filtre les tuiles par All, Enabled, Custom connectors, MCP servers et par type de service, et la zone de recherche trouve un service par son nom.
• + en haut à droite en ajoute un qui n’est pas dans la liste : décrivez-le vous-même avec Custom connector, ou demandez-le-nous avec Request a connector. MCP server s’y trouve aussi, pour l’IA qui construit vos applications plutôt que pour les applications.
• Dans l’éditeur, Manage, puis Integrations, montre ce que cette application peut utiliser. Voir Intégrations.

Connecter un service

Ouvrez le service sur la page Connectors. Chacun dit ce que votre application peut faire avec lui, ce qu’il ne fait pas quand c’est utile, et combien vos applications l’ont utilisé ces 30 derniers jours. Il y a deux façons d’y entrer : vous connecter au service, ou coller les clés qu’il vous donne. La page Connectors montre celle que chaque service propose. Certains ont les deux, et la page dit alors Sign in with the service, or add your own keys instead.

Avec un bouton. Stripe, Notion, Google Sheets, Airtable, Slack, Discord, Calendly, Google Calendar, Microsoft 365, HubSpot, Pipedrive, Zoho CRM, Zoho Books, Salesforce, Linear, Asana, Atlassian (Jira et Confluence), Figma, Canva, GitHub et GitLab se connectent en vous connectant au service puis en revenant. Vous ne voyez ni ne copiez jamais de clé. Pour Stripe, le bouton est Set up Stripe : voir Boutiques en ligne. Salesforce demande à votre administrateur d’installer une fois le paquet de Setherion avant la première connexion.

Avec des clés. Pour les autres, collez les clés que le service vous donne sous Credentials. Where do I find these? ouvre la bonne page du service, et chaque case a une indication qui dit exactement quelle clé elle attend. Test connection les essaie avant que vous vous y fiiez, et Connect les garde. Une fois connecté, Update les change et Remove les retire. Si Connect est grisé, une case est vide ou vous n’avez pas encore coché la ligne qui dit que vous avez compris les conditions du service : Take me there y mène.

Un service connecté affiche un point vert sur sa tuile, et Enabled à côté de son nom. Avant la première connexion, chaque service dit en termes simples ce que cela signifie pour vous, et vous cochez que vous avez compris. Un badge le résume : Billed by le service quand il vous facture l’usage, par exemple Billed by Supabase, Handles real money pour les paiements et les boutiques, et No usage charges pour les autres.

L’étape suivante après Connect

Juste après avoir connecté un service sur sa page, une carte dit Stripe is connected. Next: use it in this app, ou build an app with it quand vous venez du tableau de bord. Son bouton, Use in this app ou Build an app with it, écrit une demande de départ dans le chat pour vous, comme « Use Stripe in this app: online payments, subscriptions and invoices », et met le service sur la liste de l’application. La demande attend dans la zone de saisie. Rien n’est construit ni dépensé tant que vous n’appuyez pas sur Send. Vous pouvez fermer la carte, et elle ne revient pas aux visites suivantes. Les services de design et de code, comme Figma et GitHub, n’ont pas une telle carte, car ils sont lus pendant la construction d’une application plutôt qu’utilisés par elle.

Ce qu’un service ne fait pas

Quand un service a une limite évidente, sa page le dit dans une note grise, avec un bouton vers les connecteurs qui font le travail à la place. PayPal en est l’exemple : chaque bouton achète un seul article, il n’y a pas de panier, et votre application n’est pas prévenue quand quelqu’un paie, donc la note renvoie vers Stripe et Paddle.

Choisir quelles applications l’utilisent

Connecter un service ne le met pas dans chaque application. Dans l’application, ouvrez +, puis Connectors, cochez ceux que cette application peut utiliser, et appuyez sur Done. Tout ce que vous laissez décoché reste hors du code de l’application et de ses clés. Un service qui n’est pas encore connecté a Connect à côté, qui vous mène à sa page.

Demandez ensuite dans le chat ce qu’il doit faire :

Vous n’avez pas besoin de cocher d’abord. Si votre message nomme un service que l’application ne peut pas encore atteindre, une barre au-dessus de la zone de saisie dit This needs Stripe et propose trois réponses : Use it here quand il est déjà connecté, Connect avec une clé ou la connexion propre au service, sur place, ou Build without it. Sans lui, l’application dit que la fonction n’est pas configurée au lieu de faire comme si elle marchait.

Permissions

Certains services listent ce que vos applications peuvent faire avec eux, sous Permissions sur leur page une fois connectés. Chaque ligne a deux boutons : la coche l’autorise, le cercle barré la désactive.

• Un changement est enregistré dès que vous appuyez, et s’applique aussitôt à chaque application qui utilise la connexion, publiées comprises.
• Une application qui tente quelque chose de désactivé reçoit une erreur qui le dit, et où le réactiver. Les nouvelles constructions en sont informées et s’en passent.
• Le service accorde toujours à votre clé ou à votre connexion tout ce qu’elle avait reçu. Ces limites sont celles de Setherion, posées par-dessus.
• Retirer la connexion réactive tout.

Shopify est différent. Vos applications l’appellent directement depuis la page avec son jeton Storefront, qui est public par nature, donc ses limites se règlent dans Shopify : ouvrez Sales channels, puis Headless, puis votre vitrine, appuyez sur Manage à côté de Storefront API, et modifiez Permissions. Sa page sur Setherion montre les mêmes étapes.

Il en va de même pour Supabase, Firebase, Google Maps et Cloudinary : vos applications les appellent directement depuis la page, donc leurs limites se règlent dans chaque service, et leur page sur Setherion indique où.

Tout autre service dit en une phrase, sous Permissions, tout ce que vos applications peuvent faire avec lui, par exemple seulement envoyer des e-mails ou seulement lire vos produits. Canva, Figma, GitHub et GitLab disent que vos applications ne les utilisent jamais : vous seul, depuis l’éditeur.

HubSpot

HubSpot apporte votre CRM dans vos applications : contacts, entreprises, affaires et tickets. Il y a deux façons de le connecter.

• Connect with HubSpot : connectez-vous chez HubSpot, choisissez le compte et approuvez. Tant que HubSpot n’a pas fini d’examiner Setherion, son écran avertit que l’application n’est pas encore vérifiée et vous demande de saisir « I accept the risk » pour continuer.
• Une clé de service : dans HubSpot, ouvrez Development, puis Keys, puis Service keys, et créez-en une avec lecture et écriture pour les contacts, les entreprises, les affaires et les tickets. Collez-la sous Credentials. Les clés de HubSpot commencent par pat-.

Qui peut l’utiliser dans une application publiée :

• Tout le monde : un formulaire sur votre site peut ajouter un contact ou un ticket.
• Votre équipe seulement : lire le CRM et y changer quoi que ce soit. Marquez les comptes qui sont votre équipe dans Manage, puis Cloud, puis Users. Voir Travailler en équipe.

Pour empêcher les applications de modifier vos affaires tout en continuant à les lire, désactivez Change pour les affaires sous Permissions.

Votre propre Supabase

Supabase est facultatif : chaque application a déjà un backend. Connectez-le quand vous voulez que les données d’une application soient dans un projet Supabase à vous.

• Credentials : l’adresse du projet et sa clé anon, qui est publique par nature. La clé service role est facultative.
• Connect Supabase account, sous Creating the tables, permet à Setherion de créer dans votre projet les tables dont une application a besoin, depuis Manage, puis Cloud, chaque fois que vous appuyez sur le bouton là-bas. Vous vous connectez chez Supabase et vous approuvez. L’autorisation reste sur les serveurs de Setherion et n’est jamais remise aux applications que vous publiez. Sans elle, les tables sont quand même là pour que vous les copiiez et les colliez vous-même dans Supabase.

Pour déplacer vers votre propre Supabase une application qui a déjà des données, voir Paramètres avancés.

Ce qui existe

Tous les connecteurs, regroupés comme les pages qui les décrivent. Chaque page a un menu déroulant par service : à quoi il sert, quelles clés il demande et où les trouver, quoi demander, ses interrupteurs et ses limites.

Pour un service qui n’est pas dans la liste, décrivez-le vous-même : voir Connecteurs personnalisés. Pour une seule clé dont une application a besoin, Clés et secrets suffit.

Qui peut utiliser une connexion

Vos clés n’arrivent jamais à un visiteur, donc une application publiée appelle un service par Setherion, et Setherion décide de ce qui est permis.

• Seulement les chemins dont une application a besoin. Une application qui envoie des e-mails peut en envoyer, et ne peut atteindre ni votre compte, ni vos clés, ni vos domaines. Une vitrine de boutique lit les produits et ne peut lire ni les commandes ni les clients.
• L’expéditeur et le compte sont fixés. Une application ne peut pas choisir une autre adresse d’expédition, un autre numéro de téléphone, un autre agenda ou une autre liste que ceux que vous avez enregistrés.
• Votre équipe et vos visiteurs sont différents. Pour un CRM, le formulaire d’un visiteur peut laisser un prospect, et votre équipe seule peut tout lire ou tout changer. Marquez votre équipe dans Manage, puis Cloud, puis Users. La page de chaque connecteur dit lesquelles de ses actions sont publiques.
• Tout ce qui atteint une personne ou coûte de l’argent est limité en débit. Les e-mails, les SMS, les messages de chat, les inscriptions et les paiements sont limités à une dizaine d’appels par heure pour chaque visiteur. La lecture de vos propres données en permet bien plus. Une application qui dépasse est invitée à réessayer plus tard.
• Un fusible quotidien et un mensuel. Une application peut faire quelques milliers d’appels par jour à des services, et les appels d’une application publiée utilisent des crédits d’intégration.

Dans un espace de travail d’équipe

Sur Business, Settings, puis Connector settings, donne deux choix à un espace de travail d’équipe. Seul le propriétaire ou un administrateur peut changer le premier, et seul le propriétaire peut prêter.

• Quels connecteurs les applications de l’espace de travail peuvent utiliser. Un connecteur qui n’est pas autorisé est écarté de chaque construction, ne met aucune clé dans une application publiée, et chaque appel vers lui est refusé.
• Prêter les connexions du propriétaire. L’application d’un membre peut utiliser la connexion du propriétaire à un service que le membre n’a pas connecté lui-même. Les clés restent sur nos serveurs et n’arrivent jamais au membre. Le fournisseur facture le compte du propriétaire pour ces appels, et ils comptent sur les crédits d’intégration du créateur.

Les paiements, les boutiques et les bases de données ne sont jamais prêtés : leurs comptes, leurs versements et leurs données appartiennent à celui qui les a connectés. Voir Espaces de travail.

Connecteurs personnalisés et serveurs MCP

Pour un service qui n’est pas dans la liste, décrivez-le vous-même : voir Connecteurs personnalisés. Pour donner à l’IA qui construit vos applications ses propres outils, ajoutez un serveur MCP.

Bon à savoir

• Un appel qu’une application publiée fait à un service connecté utilise un crédit d’intégration. Voir Crédits. Vous voyez ce que chaque application a dépensé dans Consommation.
• Les services qui vous facturent l’usage, comme Resend, Twilio ou OpenAI, facturent votre propre compte, à leurs prix. Fixez-y une limite de dépense : Setherion limite la vitesse à laquelle une application peut appeler, ce qui arrête les abus, mais ne peut pas plafonner ce que vous dépensez.
• Quand une application appelle un service qui n’est pas connecté, Manage, puis Integrations, le dit, avec Add the key.
• Déconnecter un service empêche aussitôt toutes les applications qui l’utilisent de l’atteindre.