Leina 
Wanta 
통합 경로 선택
연결된 계정의 소유자, 호출이 실행되는 위치, 자격 증명 경계를 운영하는 주체에 따라 경로를 선택하세요.
네 가지 경로 비교
| 경로 | 연결된 계정 소유자 | 호출 경유 | 운영 주체 |
|---|---|---|---|
| Agent 설정 | 본인 | oo CLI 또는 OOMOL MCP | Agent 환경 |
| 호스팅형 Connector SDK | 본인 | OOMOL 호스팅 게이트웨이 | 백엔드 코드 |
| Connector SaaS 프로젝트 | 제품의 각 사용자 | OOMOL 호스팅 게이트웨이 | 제품 및 사용자 매핑 |
| 자체 호스팅 OpenConnector | 본인 또는 조직 | 자체 OpenConnector 런타임 | 런타임, 스토리지, 보안, 업데이트 |
Agent에서 OOMOL 사용
Codex, ChatGPT, Claude Code 또는 기타 지원되는 Agent가 연결한 Apps로 작업하도록 하려면 이 경로를 선택하세요.
진행 순서:
- OOMOL에서 App을 연결합니다.
- Agent에 oo CLI를 설치하거나 MCP 클라이언트를 구성합니다.
- Agent에게 연결된 App을 사용하도록 요청합니다.
Quickstart로 시작하세요.
백엔드 코드에서 자체 연결 호출
신뢰할 수 있는 백엔드가 OOMOL 계정에 연결된 Apps를 호출해야 할 때 호스팅형 Connector 클라이언트를 선택하세요.
이 경로는 api_… 형식의 개인 API 키를 사용합니다. 키는 백엔드에 보관되며 본인의 연결에 대한 호출을 승인합니다.
OOMOL Connector SDK 가이드를 참고하세요.
최종 사용자가 자신의 계정을 연결하도록 허용
제품의 모든 사용자가 자신의 Gmail, Slack, Notion 또는 다른 제공자 계정을 인증해야 한다면 SaaS용 Connector를 선택하세요.
백엔드가 인증 링크를 생성하고, 결과로 생성된 연결된 계정 ID 옆에 사용자 ID를 저장하며, 해당 사용자를 위해 액션을 실행합니다. 이 경로는 oo_proj_… 형식의 프로젝트 API 키를 사용합니다.
SaaS용 Connector 가이드를 참고하세요.
OpenConnector 직접 실행
팀이 런타임, 데이터베이스, 자격 증명 암호화, 네트워크 액세스, 로그, 업그레이드 프로세스를 운영해야 한다면 자체 호스팅을 선택하세요.
런타임 클라이언트는 oct_… 형식의 토큰을 사용할 수 있습니다. 제공자 OAuth 앱, 암호화 키, 스토리지, 백업, 액션 정책은 본인의 책임입니다.
OOMOL OpenConnector 자체 호스팅 가이드를 참고하세요.
제품별 자격 증명 범위
| 자격 증명 | 사용 주체 | 범위 |
|---|---|---|
api_… | 호스팅형 Connector 클라이언트 | 본인의 개인 연결 |
oo_proj_… | ProjectConnector 및 SaaS API | 하나의 Connector 프로젝트와 해당 최종 사용자 |
oct_… | OpenConnector 클라이언트, HTTP 또는 MCP | 하나의 자체 호스팅 런타임 |
세 가지 자격 증명 유형 모두 신뢰할 수 있는 백엔드, 시크릿 관리자 또는 보호된 Agent 환경에 보관하세요. 브라우저 번들, 공개 리포지토리, 프롬프트에 두지 마세요.
세 가지 질문으로 결정
- 어떤 계정을 연결하는가? 본인 계정이면 Agent 설정 또는 개인 SDK를 선택합니다. 최종 사용자 계정이면 SaaS 프로젝트를 선택합니다.
- 자격 증명 저장과 토큰 갱신은 누가 운영해야 하는가? 운영 부담을 줄이려면 OOMOL 호스팅을 사용하고, 팀이 해당 경계를 소유해야 한다면 자체 호스팅을 사용하세요.
- 액션은 어디에서 호출되는가? 대화형 Agent 작업에는 Agent 설정을, 제품 백엔드 호출에는 SDK 또는 HTTP 경로를 사용하세요.
경로를 선택한 후에는 더 많은 제공자나 프로덕션 정책을 추가하기 전에 해당 Quickstart를 따르세요.