Vue d’ensemble de Connector

OOMOL Connector est un service de connexion hébergé pour les particuliers et les équipes. Connectez des Apps comme Gmail, GitHub, Notion ou Slack, puis utilisez les opérations approuvées depuis un Agent ou un backend de confiance pendant qu’OOMOL gère OAuth, le stockage des identifiants, le renouvellement des jetons et l’exécution des opérations.

Ce parcours utilise une clé API personnelle au format api_…. Conservez la clé dans un environnement backend ou un gestionnaire de secrets.

Consultez Gestion des Teams pour inviter des collègues, attribuer des rôles ou contrôler l’accès aux connexions.

Pourquoi utiliser OOMOL Connector

Connectez une fois, utilisez à plusieurs endroits : appelez la même connexion d’App via oo CLI, MCP ou le SDK, et réutilisez-la avec les Agents pris en charge.
Réduisez les opérations d’authentification : OOMOL gère les flux OAuth, le stockage des identifiants et le renouvellement des jetons.
Protégez les identifiants des comptes : les Agents, Skills et le code applicatif utilisent les opérations approuvées sans recevoir les jetons OAuth bruts.
Contrôlez précisément l’accès : configurez les opérations autorisées par chaque connexion et les membres de la Team qui peuvent l’utiliser.
Prenez en charge les particuliers et les équipes : les particuliers peuvent connecter leurs propres Apps, tandis que les équipes peuvent partager les connexions et gérer l’accès des membres.

Choisir le parcours Connector approprié

Objectif	Parcours
Appeler les Apps connectées à votre compte OOMOL	Client `Connector` hébergé
Permettre à chaque utilisateur du produit de connecter son propre compte	Intégration SaaS
Exploiter vous-même le runtime et le stockage des identifiants	OpenConnector

Fonctionnement d’un appel

Connectez un compte d’App dans OOMOL.
Créez une clé API Connector personnelle dans OOMOL Console.
Initialisez @oomol-lab/connector dans le code backend de confiance.
Sélectionnez une opération et, si nécessaire, une connexion nommée.
Connector appelle le fournisseur et renvoie le résultat de l’opération.

Votre backend reçoit les résultats et les métadonnées d’exécution sans lire le jeton OAuth brut du fournisseur.

Capacités du SDK

Besoin	Surface du SDK
Exécuter une opération modélisée	`execute` ou `executeRaw`
Appeler un endpoint sans opération modélisée	`proxy`
Découvrir les fournisseurs et les schémas des opérations	`catalog`
Répertorier les comptes connectés	`apps.list`

Commencer le développement

Suivez Appeler les Apps connectées avec le SDK pour installer le package, créer une clé API, effectuer le premier appel et sélectionner une connexion. Utilisez la référence du SDK TypeScript pour la configuration partagée, la gestion des erreurs et l’ensemble de l’API.

Conserver la clé sur le backend

N’incluez pas de clé API personnelle dans les bundles de navigateur, les dépôts publics, les prompts ou les journaux côté client. Utilisez un projet Connector SaaS lorsque les requêtes doivent être limitées à des utilisateurs individuels du produit ; ne partagez pas une clé personnelle entre des utilisateurs finaux sans rapport.