oomol-lab/open-connector

OpenConnector – AI 에이전트가 외부 서비스를 사용할 수 있는 게이트웨이

정의 | OpenConnector는 오픈소스 "커넥터 게이트웨이"로, AI 에이전트(또는 모든 앱)가 GitHub, Gmail, Notion, Slack, BigQuery 등 수천 개의 타사 서비스를 에이전트가 사용자의 자격 증명에 직접 접근하지 않고도 호출할 수 있게 해줍니다. 1,000개 이상의 프로바이더와 10,000개 이상의 사전 구축된 액션(개별 API 호출) 카탈로그를 제공하여 에이전트가 이를 검색, 검사, 호출할 수 있습니다.

AI에게 중요한 이유 | 최신 LLM 기반 에이전트는 실제 데이터를 기반으로 작업하고 태스크를 수행해야 합니다(이메일 보내기, 스프레드시트 업데이트, 데이터베이스 쿼리). 각 에이전트에 대한 OAuth 흐름, API 키, 정책 적용을 관리하는 것은 복잡하고 보안 위험이 있습니다. OpenConnector는 자격 증명 처리를 중앙화하고 에이전트가 안전하게 호출할 수 있는 안정적이고 검사 가능한 API를 제공합니다.

주요 구성 요소

• 커넥터 카탈로그 – 요청/응답 스키마, 필수 스코프, 실행 코드가 포함된 프로바이더 및 액션의 공유 레지스트리.
• 런타임 게이트웨이 – 자격 증명을 저장하고, 정책을 적용하고, 실행을 기록하고, 액션을 실행하는 Node.js/Cloudflare 호환 서비스.
• 개발자 도구 –
  • Connector SDK(TypeScript 클라이언트): 프로그래매틱 사용을 위해.
  • oo CLI: 로컬 에이전트 릴레이 및 디버깅용.
  • MCP 엔드포인트: MCP 프로토콜을 이해하는 에이전트용.
  • 직접 HTTP/OpenAPI 접근.
• 웹 콘솔 – 카탈로그 검색, 자격 증명 구성, 런타임 토큰 생성, 로그 검사를 위한 UI.

---

배포 옵션

• 관리형(OOMOL) – 호스팅 OAuth 앱 및 런타임, 인프라 불필요.
• 자가 호스팅 – Docker Compose 또는 일반 Node.js. 기본적으로 SQLite, 또는 PostgreSQL에 상태 저장. 파일 전송에는 S3 호환 스토리지 사용 가능.
• 플랫폼 무관 – Cloudflare Workers, Fly.io, RepoCloud, nibrun, NEXUS AI 등에서 작동.

---

일반적인 워크플로

1. 사용자 계정 연동 – API 키 또는 OAuth2 사용(예: PUT /api/connections/github).
2. 에이전트가 액션 검색 – 카탈로그나 OpenAPI 사양에서 github.get_current_user를 조회.
3. 에이전트가 액션 호출 – 런타임 토큰을 사용하여 POST /v1/actions/github.get_current_user을 호출.
4. 게이트웨이 실행 – 저장된 자격 증명으로 실행, 허용/차단 정책 적용, 실행 기록, 결과 반환.

---

사용 대상

• 사용자의 SaaS 도구에 재사용 가능하고 감사 가능한 접근이 필요한 AI 기반 제품을 구축하는 팀.
• 개별 OAuth 통합을 작성하지 않고 플러그 앤 플레이 액션 카탈로그를 원하는 개발자.
• 에이전트가 행동할 수 있게 하면서 자격 증명을 통제된 런타임 뒤에 두는 조직.

---

시작하기

# 빠른 로컬 실행 (Docker Compose가 사전 빌드된 이미지를 가져옴)
 docker compose up
 # 인증 없는 액션으로 확인
 curl -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
      -H 'content-type: application/json' -d '{"input":{}}'

그런 다음 콘솔용으로 http://localhost:3000을 열거나 OpenAPI 참조용으로 http://localhost:3000/docs를 엽니다.

라이선스 및 커뮤니티

• 코드는 Apache-2.0 라이선스. 타사 프로바이더 자산은 포함되지 않습니다.
• 기여를 환영하며(CONTRIBUTING.md 참조), 친근한 행동 강령이 있습니다.

OpenConnector는 따라서 LLM 에이전트가 광범위한 웹 서비스 생태계와 안전하고 안정적으로 상호작용할 수 있게 하는 플러밍 역할을 합니다.