OpenConnector — open-source шлюз для подключения AI-агентов к 1000+ SaaS-сервисам

OpenConnector — это open-source шлюз-коннектор, который связывает AI-агентов с пользовательскими SaaS-аккаунтами. Проект позиционируется как альтернатива Composio с фокусом на полный контроль над рантаймом, инспектируемые контракты Action и совместимость между open-source и коммерческими развёртываниями.

Идея проста: пользователь один раз подключает свои учётные записи (GitHub, Gmail, Notion, Slack и сотни других), а агенты получают доступ к каталогу из 1000+ провайдеров и 10 000+ готовых Actions через единый gateway. Учётные данные никогда не покидают границу рантайма — агенты видят только метаданные, безопасные метки аккаунтов и результаты выполнения.

Архитектура

OpenConnector работает как промежуточный слой между AI-агентом и SaaS-провайдерами:

AI Agent → [SDK / CLI / MCP / HTTP] → OpenConnector Gateway
                                            ├── Credential & OAuth Boundary
                                            ├── Provider Catalog
                                            ├── Action Executors
                                            ├── Tokens, Scopes, Allow/Block Policy
                                            └── Run Logs
                                                 ↓
                                          1000+ Providers

Агенты обнаруживают доступные Actions, инспектируют схемы запросов/ответов и требуемые scopes, выбирают connection alias и выполняют вызов через gateway. Все секреты провайдеров остаются за границей рантайма.

Ключевые возможности

Каталог коннекторов — GitHub, Gmail, Notion, BigQuery, Google Analytics, Supabase, Airtable, Slack и сотни других сервисов. Каждый провайдер имеет набор предопределённых Actions с документированными схемами.

Управление учётными данными — поддержка API-ключей, OAuth2, кастомных типов аутентификации и провайдеров без аутентификации. Шифрование учётных данных, автоматический refresh токенов.

Инспектируемые контракты Action — для каждого Action доступны схема запроса, схема ответа, список требуемых scopes и lazy-loaded исходный код исполнителя.

Политики рантайма — identity подключений, ограничение scopes, runtime-токены, allow/block-политики для отдельных Action, транзитные файлы и маскирование логов.

Варианты развёртывания — локальный Docker или Node.js, Fly.io с персистентным SQLite-хранилищем, Cloudflare Workers с D1/R2/Static Assets, либо хостинг от OOMOL.

Инструменты разработчика

OpenConnector предоставляет четыре способа взаимодействия:

Быстрый старт

Запуск через Docker Compose из опубликованного образа:

docker compose up

Образ загружается из GitHub Container Registry: ghcr.io/oomol-lab/open-connector:latest. Для сборки из исходников:

docker compose -f docker-compose.yml -f docker-compose.build.yml up --build

После запуска доступны:

• Веб-консоль: http://localhost:3000
• API-документация: http://localhost:3000/docs

Проверка рантайма вызовом Action без аутентификации:

curl -s -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Подключение провайдера

Простейший пример — подключение GitHub через 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":{}}'

Для OAuth2-приложений, именованных подключений, шифрования учётных данных и Action-политик предусмотрена детальная документация.

Веб-консоль

OpenConnector включает локальный дашборд для администрирования:

• Просмотр каталога коннекторов с поиском по провайдерам
• Настройка API-ключей и OAuth-клиентов
• Создание runtime-токенов
• Инспекция схем и отладка Action
• Просмотр истории запусков и ошибок
• Доступ к авто-генерируемой OpenAPI-спецификации и MCP-метаданным

При npm-разработке консоль доступна на http://localhost:5173 (dev-сервер проксирует запросы к рантайму). При Docker-развёртывании — на http://localhost:3000.

Развёртывание на Cloudflare и Fly.io

Cloudflare Workers — облегчённый рантайм с Workers (выполнение), D1 (состояние), R2 (транзитные файлы) и Static Assets (консоль). Видео-инструкция по развёртыванию доступна на YouTube.

Fly.io — Node.js Docker-рантайм с персистентным SQLite на Fly-томе, TLS, health checks и полным набором API.

Docker (GHCR) — готовый образ ghcr.io/oomol-lab/open-connector с тегами latest (актуальный релиз), v1.0.0 (закреплённая версия) и tip (последняя сборка из main).

Для кого

OpenConnector подходит командам, которые:

• Строят AI-агентов, нуждающихся в долговременном доступе к рабочим инструментам пользователей
• Добавляют agent workflows и нуждаются в стабильных, инспектируемых контрактах Action
• Хотят быстрый старт через hosted auth, но сохраняют путь к self-hosted-рантайму

Проект написан на TypeScript (Node.js 22+), распространяется под лицензией Apache 2.0 и имеет 2,5k звёзд на GitHub. Активная разработка с 247 коммитами и 5 релизами (последний — v1.1.0 от 13 июля 2026).