OpenConnector est un connector gateway open source pour AI agents, et une alternative à Composio. Connectez les comptes d'apps utilisateur une fois, puis exposez un catalog partagé de 1,000+ providers et 10 000+ Actions prêtes à l'emploi aux agents et applications.
Important
Besoin d'un OAuth prêt à l'emploi ? Les connectors hébergés par OOMOL incluent des apps OAuth configurées pour les providers pris en charge et des Connect credits mensuels représentant environ 15 000 à 20 000 appels gratuits selon l'utilisation. OpenConnector self-hosted prend également en charge OAuth, mais vous devez enregistrer et configurer vos propres apps OAuth.
Utilisez le Connector SDK dans le code applicatif, oo CLI comme relais pour les agents locaux, MCP pour les hosts d'agents, HTTP/OpenAPI pour les clients personnalisés, et la Web Console locale pour l'administration et le débogage.
- Gardez credentials, scopes, schemas, policies et run logs dans un runtime inspectable.
- Exécutez-le en local, sur Fly.io, sur une infrastructure compatible Cloudflare ou via le runtime hébergé d'OOMOL.
- Utilisez les mêmes provider ids, Action ids, schemas et contracts entre les déploiements open source et SaaS commercial.
- Un connector catalog prêt à l'emploi couvrant GitHub, Gmail, Notion, BigQuery, Google Analytics, Supabase, Airtable, Slack et d'autres produits.
- Une gestion centralisée des credentials dans un seul runtime : API keys, OAuth2, custom credentials et providers sans authentification.
- Des Action contracts inspectables et extensibles : request/response schemas, required scopes et executor source chargé à la demande.
- Des runtime controls pour la production : connection identity, scopes, runtime tokens, action allow/block policies, transit temporaire de fichiers et journaux d'exécution masqués.
- Des options de déploiement via Docker ou Node.js en local, Fly.io avec stockage SQLite persistant, Cloudflare Workers / D1 / R2 / Static Assets, ou le runtime hébergé d'OOMOL.
OpenConnector convient aux produits où les agents ont besoin d'un accès durable aux outils des utilisateurs sans donner les provider credentials au processus agent.
- Produits d'agents qui nécessitent un accès réutilisable aux apps de travail, outils développeur, systèmes de données, plateformes de communication et services d'IA.
- Produits ajoutant des workflows d'agents et ayant besoin d'Action contracts stables et inspectables pour accéder aux applications des utilisateurs.
- Équipes qui veulent commencer vite avec hosted auth tout en gardant une voie vers un runtime privé ou self-hosted.
| Outil | Rôle |
|---|---|
| Connector SDK | Client HTTP TypeScript léger. Utilisez OpenConnector pour un runtime self-hosted, et Connector / ProjectConnector pour les connexions personnelles et SaaS end-user hébergées par OOMOL. |
| oo CLI | Relais de connector Actions pour agents locaux. oo connector peut chercher, inspecter et exécuter des Actions sur les runtimes OOMOL-hosted ou OpenConnector self-hosted. |
| MCP | Exposer les Actions d'app à des hosts d'agents compatibles MCP via http://localhost:3000/mcp. |
| HTTP / OpenAPI | Appeler directement /v1/actions/* ou inspecter le document /openapi.json généré. |
Consultez runtime-api.md pour les endpoints, response envelopes, auth headers, outils MCP et exemples d'Action guide.
OpenConnector inclut un Dashboard local pour parcourir les connectors, configurer les credentials, créer des runtime tokens et inspecter l'usage du runtime.
Le connector catalog permet de voir les services disponibles, de rechercher des providers et d'ouvrir leurs Actions et leur credential setup depuis un seul endroit.
Après le déploiement, la page Overview affiche le runtime readiness, les providers disponibles, les Actions exécutables, les failures récentes, les tool call trends et les recent calls.
Les noms et marques des providers appartiennent à leurs propriétaires respectifs et sont utilisés uniquement à des fins d'identification et d'interopérabilité.
flowchart LR
Agent["AI Agent / App"] -->|"SDK / CLI / MCP / HTTP"| Gateway["OpenConnector Gateway"]
Gateway --> Auth["Credential & OAuth Boundary"]
Gateway --> Catalog["Provider Catalog"]
Gateway --> Actions["Open-source Action Executors"]
Gateway --> Policy["Tokens, Scopes, Allow/Block Policy"]
Gateway --> Logs["Run Logs"]
Actions --> Providers["1,000+ Providers"]
Console["Web Console"] --> Gateway
Cloudflare["Cloudflare Workers, D1, R2"] -. deploy .-> Gateway
Les apps et agents découvrent les Actions, inspectent les schemas et scopes, sélectionnent un connection alias et exécutent via le gateway. Les provider secrets restent derrière la frontière du runtime ; les agents reçoivent les metadata, labels de compte sûrs et résultats d'exécution nécessaires à la run.
| Parcours | Idéal pour | Inclus |
|---|---|---|
| Open source self-host | Développeurs et équipes qui veulent un contrôle total | Runtime Docker ou Node local, stockage SQLite, MCP, HTTP, OpenAPI et Web Console |
| Fly.io self-host | Équipes qui veulent un runtime Docker hébergé | Runtime Docker Node, stockage SQLite sur un volume Fly, TLS, health checks, MCP, HTTP, OpenAPI et Web Console |
| Déploiement compatible Cloudflare | Équipes qui veulent un runtime hébergé léger | Workers runtime, état D1, fichiers de transit R2 et Static Assets pour la console |
| OOMOL | Équipes bloquées par l'approbation OAuth ou les délais de lancement | Auth hébergée et infrastructure runtime avec les mêmes provider et Action contracts ; compatible avec l'interface open source pour un déploiement privé ou self-hosted ultérieur |
Le
guide vidéo de déploiement Cloudflare Workers
montre comment lancer OpenConnector sur Cloudflare avec Workers, D1, R2 et la Web Console. La vidéo
suit le même flux que cloudflare.md : créer les ressources Cloudflare, copier
wrangler.example.jsonc vers wrangler.local.jsonc, appliquer les migrations D1, définir les
secrets requis et exécuter npm run deploy:cloudflare.
Note
Ces étapes démarrent un runtime self-hosted. Les providers OAuth nécessitent les OAuth client credentials des apps que vous enregistrez auprès de ces providers. Pour permettre aux utilisateurs d'autoriser les providers pris en charge sans configurer vos propres apps OAuth, utilisez les connectors hébergés par OOMOL.
Démarrez le runtime depuis l'image publiée avec Docker Compose :
docker compose upCela récupère ghcr.io/oomol-lab/open-connector:latest. Pour builder depuis les sources :
docker compose -f docker-compose.yml -f docker-compose.build.yml up --buildOuvrez la console locale et la référence API générée :
http://localhost:3000
http://localhost:3000/docs
Exécutez une Action sans authentification pour vérifier le runtime :
curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
-H 'content-type: application/json' \
-d '{"input":{}}'Consultez quickstart.md pour la configuration locale complète, la première connexion provider, le flux OAuth et les paramètres runtime.
GitHub est l'exemple authentifié le plus simple, car il peut utiliser un personal access token :
curl -s -X PUT http://localhost:3000/api/connections/github \
-H 'content-type: application/json' \
-d '{"authType":"api_key","values":{"apiKey":"github_pat_..."}}'
curl -s -X POST http://localhost:3000/v1/actions/github.get_current_user \
-H 'content-type: application/json' \
-d '{"input":{}}'Pour les apps OAuth2, named connections, credential encryption, token refresh et action policies, consultez credentials.md et configuration.md.
Ouvrez http://localhost:3000 après le démarrage du runtime. La console permet de parcourir les
providers, configurer les API keys et OAuth clients, créer des runtime tokens, inspecter les Action
schemas, déboguer les Actions, revoir les exécutions récentes et accéder aux metadata OpenAPI et MCP
générées.
OpenConnector peut être déployé sur Cloudflare : Workers exécute le runtime, D1 stocke l'état, R2 gère les fichiers de transit et Static Assets sert la Web Console.
Consultez cloudflare.md pour la création des ressources, les migrations, les secrets, la preview Worker locale et le déploiement distant.
OpenConnector peut aussi être déployé sur Fly.io avec le runtime Docker Node et un stockage SQLite persistant sur un volume Fly.
Consultez fly-io.md pour créer l'app Fly, configurer le volume et les secrets, déployer, définir un domaine personnalisé et ajuster le scaling.
Exécutez OpenConnector depuis une image préconstruite sur GitHub Packages (GHCR) :
ghcr.io/oomol-lab/open-connector. Utilisez latest pour la dernière release, une version épinglée comme
v1.0.0 en production, ou tip pour le dernier build de main.
Consultez docker-ghcr.md (anglais) pour les tags d'image, le pull et l'exécution.
OpenConnector et Wanta sont deux projets open source pour les Agents IA dans l'écosystème OOMOL. OpenConnector connecte les Agents à des services externes comme Gmail, Slack et Notion. Wanta fournit une application Agent desktop complète propulsée par OpenCode et utilise OpenConnector pour accéder aux services SaaS connectés.
- Exécution locale : utilisez votre propre modèle compatible OpenAI sans créer de compte Wanta.
- Développement personnalisé : forkez Wanta et adaptez prompts, outils, interface, modèles et identité.
- Services hébergés : l'expérience hébergée, facultative, fournit modèles gérés, connexions OAuth et espaces d'équipe.
Issues et pull requests sont les bienvenues.
- Démarrage rapide
- Outils développeur
- Tutoriel Gmail OAuth et SDK (anglais)
- Runtime API et MCP
- Déploiement Fly.io
- Déploiement Cloudflare
- Image Docker (GHCR) (anglais)
- Configuration
- Credentials et OAuth
- Format du catalog
- Langage de verification
- Contribution
- Code de conduite
- Sécurité
Utilisez Node.js 22 ou plus récent :
npm install
npm run devLe runtime API local écoute sur http://localhost:3000. Le serveur de développement Web Console
écoute sur http://localhost:5173 et proxy les requêtes API vers le runtime.
Avant d'ouvrir une pull request :
npm run fix-check
npm testLe code provider se trouve dans src/providers/<service>. Consultez
CONTRIBUTING.md pour les règles de contribution des
providers.
Sauf indication contraire, le code source, les scripts, les échafaudages de projet générés, les tests et la documentation rédigés pour ce repository sont sous Apache License, Version 2.0. Consultez LICENSE.txt.
La licence Apache-2.0 de ce repository n'accorde aucun droit sur les produits, providers, apps, APIs, trademarks, service marks, trade names, logos, icons, brand assets, documentation, screenshots ou autres contenus protégés appartenant à leurs détenteurs respectifs.
Les noms de providers et d'apps, metadata, liens, scopes, permissions et logos/icons optionnels sont inclus uniquement pour identifier les services et permettre l'interopérabilité. Tous les droits sur les marques et produits tiers restent la propriété de leurs détenteurs respectifs. Leur présence dans ce catalog n'implique aucune approbation, sponsorisation, partenariat, certification ou vérification par ces détenteurs.
Si vous contribuez des provider metadata ou assets, soumettez uniquement des éléments pour lesquels vous avez les droits nécessaires. Préférez les liens vers les assets publics officiels plutôt que de copier des fichiers de marque dans ce repository.
Gardez les issues et pull requests ciblées, respectueuses et actionnables. La participation à ce projet est régie par CODE_OF_CONDUCT.md.
Si OpenConnector vous est utile, attribuez-lui une ⭐ pour aider davantage de développeurs à découvrir le projet.
Merci à toutes les personnes qui ont contribué à OpenConnector. Vous souhaitez les rejoindre ? Consultez le guide de contribution.
