---
title: Connector 개요
description: 호스팅된 Connector 게이트웨이를 통해 신뢰할 수 있는 백엔드 코드에서 OOMOL 계정에 연결된 Apps를 호출하세요.
lang: ko
canonical_url: https://oomol.com/ko/docs/connector/
markdown_url: https://oomol.com/ko/docs/connector.md
---

# Connector 개요

OOMOL Connector는 개인과 팀을 위한 호스팅 연결 서비스입니다. Gmail, GitHub, Notion, Slack과 같은 Apps를 연결한 다음, OOMOL이 OAuth, 자격 증명 저장, 토큰 갱신, 작업 실행을 관리하는 동안 Agent 또는 신뢰할 수 있는 백엔드에서 승인된 작업을 사용하세요.

이 경로는 `api_…` 형태의 개인 API 키를 사용합니다. 키는 백엔드 환경 또는 시크릿 관리자에 보관하세요.

동료를 초대하거나, 역할을 할당하거나, 연결 액세스를 제어해야 할 때는 [Team management](/ko/docs/team-management/)를 참조하세요.

## OOMOL Connector를 사용하는 이유

- **한 번 연결하고 여러 곳에서 사용:** oo CLI, MCP 또는 SDK를 통해 동일한 App 연결을 호출하고, 지원되는 Agents 전반에서 재사용하세요.
- **인증 작업 감소:** OOMOL이 OAuth 흐름, 자격 증명 저장, 토큰 갱신을 관리합니다.
- **계정 자격 증명 보호:** Agents, Skills 및 애플리케이션 코드는 원시 OAuth 토큰을 받지 않고 승인된 작업을 사용합니다.
- **액세스를 정밀하게 제어:** 각 연결에서 허용되는 작업과 사용할 수 있는 Team 멤버를 구성하세요.
- **개인과 팀 지원:** 개인은 자신의 Apps를 연결할 수 있고, 팀은 연결을 공유하고 멤버 액세스를 관리할 수 있습니다.

## 올바른 Connector 경로 선택

| 목표 | 경로 |
| --- | --- |
| OOMOL 계정에 연결된 Apps 호출 | 호스팅된 `Connector` 클라이언트 |
| 각 제품 사용자가 자신의 계정을 연결하도록 허용 | [SaaS integration](/ko/docs/saas/) |
| 런타임과 자격 증명 저장을 직접 운영 | [OpenConnector](/ko/docs/openconnector/) |

## 호출 작동 방식

1. OOMOL에서 App 계정을 연결합니다.
2. OOMOL Console에서 개인 Connector API 키를 생성합니다.
3. 신뢰할 수 있는 백엔드 코드에서 `@oomol-lab/connector`를 초기화합니다.
4. 작업을 선택하고, 필요할 경우 이름이 지정된 연결을 선택합니다.
5. Connector가 제공자를 호출하고 작업 결과를 반환합니다.

백엔드는 제공자의 원시 OAuth 토큰을 읽지 않고 작업 결과를 받습니다. 실행 메타데이터도 필요하면 executeRaw를 사용하세요. execute는 작업 출력만 반환합니다.

## SDK 기능

| 필요 사항 | SDK 표면 |
| --- | --- |
| 모델링된 작업 실행 | `execute` 또는 `executeRaw` |
| 모델링된 작업 없이 엔드포인트 호출 | `proxy` |
| 제공자 및 작업 스키마 검색 | `catalog` |
| 연결된 계정 목록 | `apps.list` |

## 빌드 시작

[Call connected Apps with the SDK](/ko/docs/connector-client/)를 따라 패키지를 설치하고, API 키를 생성하고, 첫 호출을 수행하고, 연결을 선택하세요. 공유 구성, 오류 처리 및 전체 API 표면은 [TypeScript SDK reference](/ko/docs/connector-sdk/)를 사용하세요.

## 백엔드에 키 보관

개인 API 키를 브라우저 번들, 공개 저장소, 프롬프트 또는 클라이언트 측 로그에 포함하지 마세요. 요청이 개별 제품 사용자로 범위가 지정되어야 할 때는 Connector SaaS 프로젝트를 사용하세요. 관련 없는 최종 사용자 간에 하나의 개인 키를 공유하지 마세요.