OpenConnector로 구축하는 AI 에이전트 커넥터 게이트웨이: 1,000개 이상의 서비스와 10,000개 이상의 액션을 하나의 런타임으로 연결

AI 에이전트와 외부 서비스 연동을 효율적으로 관리하는 OpenConnector

AI 에이전트가 다양한 외부 서비스와 연동되기 위해서는 인증 정보 관리, API 호출, 권한 제어, 실행 로그 관리 등 복잡한 기능이 함께 필요합니다. 서비스가 많아질수록 각각의 API를 직접 연동하고 관리하는 부담도 커집니다.

OpenConnector는 이러한 문제를 해결하기 위해 제공되는 오픈소스 커넥터 게이트웨이입니다. 사용자의 애플리케이션 계정을 한 번만 연결하면 GitHub, Gmail, Notion, Slack 등 1,000개 이상의 서비스와 10,000개 이상의 사전 구축된 Action을 AI 에이전트와 애플리케이션에서 공통으로 사용할 수 있습니다.

또한 Composio의 대안으로 활용할 수 있으며, 인증 정보와 실행 정책, 스키마, 실행 로그를 하나의 런타임에서 관리하여 보다 안전하고 일관된 AI 서비스 개발 환경을 제공합니다.

반응형

---

OpenConnector란 무엇인가

OpenConnector는 AI 에이전트와 다양한 SaaS 및 클라우드 서비스를 연결하는 오픈소스 커넥터 게이트웨이입니다.

애플리케이션에서 각각의 API를 직접 구현하는 대신, OpenConnector가 제공하는 Connector Runtime을 통해 필요한 서비스를 연결하고 Action을 실행할 수 있습니다.

주요 특징은 다음과 같습니다.

• 오픈소스 기반 AI Connector Gateway
• Composio를 대체할 수 있는 구조
• 사용자 계정을 한 번 연결하면 여러 AI 에이전트와 애플리케이션에서 재사용 가능
• 1,000개 이상의 Provider 지원
• 10,000개 이상의 사전 구현된 Action 제공

---

OpenConnector가 제공하는 주요 기능

다양한 서비스 커넥터 제공

OpenConnector는 다양한 업무 서비스와 데이터 플랫폼을 지원합니다.

대표적인 Provider는 다음과 같습니다.

• GitHub
• Gmail
• Notion
• BigQuery
• Google Analytics
• Supabase
• Airtable
• Slack

이 외에도 다양한 SaaS 및 개발 도구가 포함된 커넥터 카탈로그를 제공합니다.

이를 통해 개발자는 각 서비스별 API를 직접 구현하지 않고도 필요한 기능을 손쉽게 사용할 수 있습니다.

---

다양한 인증 방식 지원

서비스마다 인증 방식은 모두 다릅니다.

OpenConnector는 이러한 차이를 내부적으로 처리하여 통합된 방식으로 사용할 수 있도록 지원합니다.

지원하는 인증 방식

• API Key
• OAuth2
• Custom Credentials
• 인증이 필요 없는 Provider(No-auth)

또한 OAuth 토큰 관리 및 Credential 암호화도 지원하여 운영 환경에서도 활용할 수 있습니다.

---

Action 기반 실행 구조

OpenConnector에서는 API를 직접 호출하는 대신 Action이라는 단위로 기능을 제공합니다.

각 Action에는 다음과 같은 정보가 포함됩니다.

• Request Schema
• Response Schema
• 필요한 권한(Scope)
• 실행 소스(Executor)

덕분에 AI 에이전트는 실행 전에 필요한 입력값과 권한을 쉽게 확인할 수 있으며, 안정적인 호출이 가능합니다.

---

Runtime 중심의 보안 관리

OpenConnector는 민감한 인증 정보를 AI 에이전트에게 직접 전달하지 않습니다.

대신 Runtime 내부에서 다음 요소를 관리합니다.

• 사용자 인증 정보
• Scope 관리
• Runtime Token
• Action 허용 및 차단 정책
• 임시 파일 처리
• 실행 로그(Redacted Run Log)

AI 에이전트는 필요한 실행 결과만 전달받으며 실제 Provider의 인증 정보는 Runtime 내부에 안전하게 유지됩니다.

---

OpenConnector 아키텍처

OpenConnector는 AI 에이전트와 외부 서비스를 연결하는 중간 계층(Gateway) 역할을 수행합니다.

전체 동작 과정은 다음과 같습니다.

1. AI Agent 또는 애플리케이션이 Action을 검색합니다.
2. Action의 Schema와 필요한 권한을 확인합니다.
3. 사용할 Connection Alias를 선택합니다.
4. Gateway를 통해 Action을 실행합니다.
5. Runtime이 실제 Provider API를 호출합니다.
6. 실행 결과만 AI Agent에 반환합니다.

이 구조를 통해 Provider의 인증 정보는 Runtime 내부에만 존재하며, 에이전트는 필요한 메타데이터와 실행 결과만 사용할 수 있습니다.

---

다양한 개발 환경 지원

OpenConnector는 여러 개발 환경에서 사용할 수 있도록 다양한 인터페이스를 제공합니다.

개발 도구	설명
Connector SDK	TypeScript 기반 HTTP 클라이언트
oo CLI	로컬 에이전트 Relay 및 Action 실행
MCP	MCP 호스트와 연동하여 Action 제공
HTTP/OpenAPI	REST API 및 OpenAPI 문서 제공
Web Console	관리자 기능 및 디버깅 지원

개발 환경에 따라 원하는 방식으로 Runtime과 통신할 수 있습니다.

---

Web Console에서 제공하는 기능

OpenConnector에는 관리 및 운영을 위한 Web Console이 포함되어 있습니다.

주요 기능은 다음과 같습니다.

• Provider 검색
• API Key 및 OAuth 설정
• Runtime Token 생성
• Action Schema 확인
• Action 디버깅
• 최근 실행 내역 조회
• OpenAPI 문서 확인
• MCP 메타데이터 확인

운영 중인 Runtime 상태를 시각적으로 관리할 수 있어 개발과 운영 모두에 활용할 수 있습니다.

---

배포 환경

OpenConnector는 다양한 환경에 배포할 수 있도록 지원합니다.

Local 환경

• Docker
• Node.js

로컬 개발 및 테스트에 적합합니다.

---

Cloudflare

Cloudflare 환경에서는 다음 서비스를 활용합니다.

• Workers
• D1
• R2
• Static Assets

Web Console과 Runtime을 함께 운영할 수 있습니다.

---

Fly.io

Fly.io에서는 다음 구성을 지원합니다.

• Node Docker Runtime
• SQLite Persistent Storage

영구 저장소를 포함한 운영 환경을 구성할 수 있습니다.

---

Hosted Runtime

OOMOL에서 제공하는 Hosted Runtime도 사용할 수 있습니다.

자체 인프라를 운영하지 않고도 OpenConnector 환경을 활용할 수 있습니다.

---

Quick Start

OpenConnector는 Docker를 이용하여 쉽게 실행할 수 있습니다.

docker compose up

소스에서 직접 빌드하는 경우에는 다음 명령을 사용합니다.

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

실행 후에는 다음 주소에서 확인할 수 있습니다.

http://localhost:3000

API 문서는 다음에서 제공합니다.

http://localhost:3000/docs

---

간단한 Action 실행 예제

Runtime이 정상적으로 실행되면 Action을 바로 호출할 수 있습니다.

예를 들어 Hacker News의 인기 게시물을 조회하는 Action은 다음과 같습니다.

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

---

GitHub Provider 연결 예제

GitHub Personal Access Token을 이용한 연결 예제입니다.

curl -X PUT http://localhost:3000/api/connections/github \
-H "content-type: application/json" \
-d '{
  "authType":"api_key",
  "values":{
    "apiKey":"github_pat_..."
  }
}'

연결 이후 현재 사용자 정보를 조회하는 Action을 실행할 수 있습니다.

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

이처럼 인증 정보를 Runtime에 등록한 후 필요한 Action만 호출하는 구조를 제공합니다.

---

OpenConnector를 활용하기 적합한 환경

OpenConnector는 다음과 같은 서비스에서 활용하기 적합합니다.

• AI Agent 플랫폼
• AI Workflow 서비스
• SaaS 통합 서비스
• 업무 자동화 플랫폼
• 다양한 사용자 계정을 관리해야 하는 서비스
• 자체 Runtime을 운영하려는 개발 조직

특히 사용자 인증 정보를 AI 에이전트가 직접 보유하지 않고 Runtime에서 관리해야 하는 환경에 적합합니다.

---

OpenConnector의 주요 장점

OpenConnector의 핵심 장점은 다음과 같습니다.

• 오픈소스 기반으로 자유로운 확장 가능
• 1,000개 이상의 Provider 지원
• 10,000개 이상의 사전 구축된 Action 제공
• 인증 정보와 실행 정책을 Runtime에서 안전하게 관리
• SDK, CLI, MCP, HTTP API 등 다양한 개발 인터페이스 제공
• Docker, Fly.io, Cloudflare 등 다양한 배포 환경 지원
• OpenAPI 및 Web Console을 통한 운영 편의성 제공
• 오픈소스와 상용 SaaS 환경에서 동일한 Provider 및 Action 계약 사용 가능

---

728x90

OpenConnector는 AI 에이전트가 다양한 외부 서비스를 안전하고 일관된 방식으로 사용할 수 있도록 지원하는 오픈소스 커넥터 게이트웨이입니다.

단순히 API를 연결하는 수준을 넘어 인증 정보 관리, 권한 제어, 실행 정책, Action 스키마, 실행 로그 등을 하나의 Runtime에서 통합 관리할 수 있다는 점이 큰 특징입니다.

또한 SDK, CLI, MCP, HTTP API, Web Console 등 다양한 개발 도구를 제공하며, Docker부터 Cloudflare, Fly.io, Hosted Runtime까지 폭넓은 배포 환경을 지원하여 개발 환경에 맞는 유연한 운영이 가능합니다.

AI 에이전트 기반 서비스가 확대되는 환경에서 OpenConnector는 복잡한 서비스 연동을 단순화하고, 안정적인 인증 및 실행 환경을 제공하는 효과적인 커넥터 플랫폼으로 활용될 수 있습니다.

300x250

https://github.com/oomol-lab/open-connector

GitHub - oomol-lab/open-connector: Open-source auth gateway connecting 1000+ SaaS providers to AI agents through SDK, CLI, MCP,