oomol-lab/open-connector

Open-source auth gateway connecting 1500+ SaaS providers to AI agents through SDK, CLI, MCP, HTTP, and OpenAPI.

OpenConnector – AI 에이전트를 위한 통합 커넥터 게이트웨이

무엇인가요 – AI 에이전트(또는 모든 앱)가 OAuth 흐름이나 API 키를 직접 관리할 필요 없이 수천 개의 서드파티 서비스(GitHub, Gmail, Notion, Slack, BigQuery, …)를 호출할 수 있게 해주는 오픈소스 런타임입니다. 단일 HTTP/OpenAPI 엔드포인트, CLI, 또는 MCP 프로토콜을 통해 1,000개 이상의 프로바이더와 10,000개 이상의 사전 구축된 Action 카탈로그를 제공합니다.

왜 중요한가요 – 현대의 LLM 기반 어시스턴트는 사용자가 이미 사용 중인 도구에 대한 신뢰할 수 있고 감사 가능한 접근 권한이 필요합니다. OpenConnector는 견고한 "credential boundary"를 제공합니다. 즉, 에이전트는 메타데이터와 결과만 수신하며, 실제 비밀 정보(secrets)는 제어된 런타임 내부에 유지됩니다.

핵심 기능

| Feature | What you get | |---|---|| | Provider catalog | 인기 있는 SaaS 제품(GitHub, Gmail, Supabase, 등)에 대한 요청/응답 스키마 및 필수 scope가 포함된 완성된 정의. | | Credential handling | API 키, OAuth2(토큰 갱신 포함), 커스텀 자격 증명, 그리고 인증이 전혀 필요 없는 서비스에 대한 내장 지원. | | Inspectable Action contracts | 각 Action은 JSON schema, 필수 scope, 그리고 지연 로딩되는 executor source와 함께 제공되어 디버깅과 정책 적용을 쉽게 만듭니다. | | Runtime controls | 연결별 토큰, scope 제한, 허용/차단 정책, 임시 파일 전송, 그리고 마스킹 처리된 실행 로그. | | Multiple deployment models | • Managed SaaS on OOMOL (인프라 운영 불필요)
• Cloudflare Workers (D1, R2, static assets)
• Docker / Node.js (SQLite 또는 PostgreSQL, 선택 사항인 S3-compatible storage)
• Kubernetes Helm chart
• Fly.io Docker host | | Developer tooling | • Connector SDK (가벼운 TypeScript HTTP client)
• oo CLI (검색, 검사 및 Action 실행을 위한 로컬 릴레이)
• MCP 엔드포인트 (MCP 프로토콜을 사용하는 에이전트용)
• OpenAPI 스펙 (/openapi.json) (모든 HTTP client용) | | Web console | 프로바이더 브라우징, 자격 증명 구성, 런타임 토큰 생성, 로그 확인 및 Action 테스트를 위한 UI. |

일반적인 사용 사례

AI-assistant platforms가 사용자 권한이 부여된 서비스를 호출하는 재사용 가능하고 감사 가능한 방식이 필요할 때 (예: 사용자의 Gmail을 읽거나 Notion에 글을 쓸 수 있는 챗봇).
Enterprise SaaS products가 모든 서드파티 자격 증명을 자체 데이터베이스에 저장하지 않고도 "에이전트 기반" 워크플로우를 임베딩하고 싶을 때.
Developer teams가 컴플라이언스 또는 데이터 주권 문제로 인해 셀프 호스팅 가능한 런타임을 선호할 때.
Prototypers가 OAuth 연동 작업을 직접 작성하지 않고도 빠르게 "Pipedream-like" Action 카탈로그를 사용하고 싶을 때.

시작하기 (가장 빠른 방법)

Docker 이미지를 실행하세요

docker compose up   # pulls ghcr.io/oomol-lab/open-connector:latest

로컬 콘솔을 여세요: http://localhost:3000 (또는 개발용 콘솔 http://localhost:5173).

인증이 필요 없는 Action을 테스트하세요:

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

실제 프로바이더(예: GitHub)를 콘솔을 통해 또는 README에 표시된 간단한 PUT 요청을 통해 연결하세요.
에이전트 코드에서 Connector SDK 또는 oo CLI를 사용하여 Action을 발견하고 호출하세요.

위치

Source: https://github.com/oomol-lab/open-connector
License: Apache-2.0 (프로젝트 코드에만 해당하며, 서드파티 프로바이더 자산은 포함되지 않습니다).
Community: Pull request를 통한 기여를 환영합니다. 프로바이더 추가 가이드라인은 CONTRIBUTING.md를 참조하세요.

요약 (TL;DR)

OpenConnector는 AI 에이전트를 위한 OAuth 및 API 키 관리를 중앙 집중화하는 셀프 호스팅(또는 SaaS 호스팅) 게이트웨이로, 깔끔한 HTTP/OpenAPI 인터페이스를 통해 방대한 양의 즉시 사용 가능한 Action 카탈로그를 제공합니다. 사용자가 이미 의뢰존하는 수많은 SaaS 서비스에 대해 안전하고 감사 가능한 접근 권한을 제공하는 LLM 기반 도구를 구축하는 모든 사람을 위해 설계되었습니다.