핵심 개념

세 가지 Connector 제품은 provider, action 및 schema를 공유하지만 서로 다른 계정 격리 및 권한 모델을 사용합니다. 먼저 제품을 식별한 다음 해당 제품의 connection, connected account, Team 또는 Project 리소스를 해석하세요.

세 제품 모두 공유하는 개념

Apps 및 providers

App은 사용자가 보고 연결을 선택하는 서비스입니다(예: Gmail, GitHub, Slack).

provider 또는 service는 해당하는 Connector 통합입니다. 인증, action, schema 및 Connector가 업스트림 API를 요청하는 방식을 정의합니다. App과 provider 이름은 보통 일치하지만, 하나는 사용자 대상 서비스이고 다른 하나는 Connector 구현 경계입니다.

Actions 및 tools

action은 provider가 노출하는 하나의 호출 가능한 작업입니다. action ID는 일반적으로 서비스와 작업을 결합합니다(예: gmail.search_threads). 각 action에는 입력 schema가 있으며 호출이 반환하는 데이터를 정의합니다.

tool은 Agent, CLI 또는 MCP 클라이언트가 action을 보는 호출 표면입니다. SDK는 보통 action을 직접 실행하는 반면, Agent는 사용 가능한 action을 tool로 검색하고 호출합니다.

실행 전에 확인하세요:

• action이 사용할 계정;
• 제출할 파라미터;
• 작업이 데이터를 읽는지, 쓰는지, 삭제하는지 여부;
• 현재 아이덴티티가 해당 계정 리소스를 사용할 수 있는지 여부.

Agents 및 Skills

Agent는 tool을 선택하고, 파라미터를 제공하며, 결과를 사용하여 작업을 계속합니다. OOMOL은 해당 작업 중 사용되는 인가된 App 기능을 제공합니다.

Skill은 재사용 가능한 작업 지침 세트입니다. Agent에게 사용할 tool, 순서, 유지할 제약 조건 및 결과를 구성하는 방법을 알려줍니다. 실행에는 Agent의 아이덴티티와 사용 가능한 tool이 사용되며, Connector는 App 자격 증명을 저장합니다.

OOMOL Connector (Hosted)

Connection

connection은 개인 또는 Team 범위의 App 계정에 대한 하나의 연결 인스턴스입니다. 자체 connection 이름과 ID가 있으며 계정 인가, 상태 및 권한 설정과 연결됩니다.

동일한 App 계정을 두 번 이상 연결할 수 있습니다. 각 connection은 별도로 구성할 수 있습니다:

• Action access: connection이 허용하는 action
• Member access: connection을 사용할 수 있는 Team 멤버

멤버가 호출할 수 있는 action은 해당 멤버가 접근할 수 있는 모든 connection에서 허용된 action의 합집합입니다.

Team

Team은 Hosted Connector의 Team 테넌트 범위입니다. 활성 Team은 호출자가 볼 수 있는 connection과 그 안에서 호출자가 사용할 수 있는 action을 결정합니다.

CLI, MCP 및 SDK 클라이언트는 Team을 명시적으로 선택해야 나중에 기본 Team이 변경되어도 잘못된 connection을 선택하지 않습니다. Team 플랜은 좌석당 청구됩니다. 현재 세부 정보는 Billing in Console에서 확인하세요.

유효 접근

호출은 다음 경계의 교집합 내에서만 실행될 수 있습니다:

Provider authorization
  ∩ connection Action access
  ∩ Team Member access
  ∩ CLI, MCP, or SDK caller identity
  = actions the caller can execute

구성 세부 정보는 Access control 및 Team management를 참조하세요.

Hosted Connector 호출 경로

User connects an App
  → a connection is created
  → Agent or trusted backend selects an action and connection
  → Hosted Connector checks access and loads credentials
  → Provider API
  → result and execution metadata return to the caller

Connector for SaaS

Connector for SaaS를 사용하면 제품 사용자가 자신의 서드파티 계정을 연결할 수 있습니다. 별도의 멀티 테넌트 리소스 모델을 사용합니다:

connected account는 Project에서 하나의 외부 사용자가 인가한 provider 계정을 나타냅니다. 백엔드는 해당 제품 사용자를 위해 action을 실행할 때 이를 선택합니다.

SaaS 호출 경로

Product user completes Provider authorization
  → connected account is linked to an external user ID
  → your backend uses a Project API key
  → ProjectConnector selects the user, connected account, and action
  → Hosted Connector executes the call
  → Provider API

제품은 자체 사용자를 인증하고 안정적이며 추측할 수 없는 외부 사용자 매핑을 유지합니다. 리소스 모델 및 통합 흐름은 Connector for SaaS를 참조하세요.

OpenConnector

OpenConnector는 자체 인프라에 배포하는 오픈 소스 런타임 및 게이트웨이입니다.

• runtime은 provider를 로드하고, connection을 관리하며, 자격 증명을 선택하고, 정책을 적용하며, Provider API를 호출합니다.
• gateway는 runtime이 MCP, HTTP, OpenAPI 및 SDK 클라이언트에 노출하는 접근 표면입니다.
• runtime token은 클라이언트가 runtime 및 해당 기능에 접근할 수 있는지 여부를 제어합니다.

OpenConnector는 runtime, connection 및 접근 정책을 사용자가 관리하는 인프라에 배치합니다. 호출자는 MCP, HTTP, OpenAPI 또는 SDK를 통해 해당 action을 사용합니다.

OpenConnector 호출 경로

You configure a Provider and connection
  → Agent or application selects an action and connection
  → OpenConnector runtime checks the token and policy
  → runtime loads credentials and calls the Provider API
  → result returns to the caller

운영자는 자격 증명 암호화, 토큰, 스토리지, 네트워킹, 로그, 백업 및 업그레이드를 담당합니다. 전체 경계는 OpenConnector를 참조하세요.

자격 증명 경계

원시 Provider OAuth 토큰, API 키 및 사용자 지정 자격 증명은 Agent, Skill, 브라우저 클라이언트 또는 제품 사용자에게 노출되어서는 안 됩니다:

• OOMOL은 Hosted Connector 및 Connector for SaaS의 호스팅 경계 내에서 자격 증명을 저장하고 갱신합니다;
• OpenConnector 운영자는 자체 인프라에서 자격 증명을 보호합니다;
• Connector는 action 또는 지원되는 프록시 요청을 실행할 때 자격 증명을 로드하고 호출자에게 실행 결과만 반환합니다.

올바른 용어 선택

제품을 선택한 후 해당 개요 및 통합 가이드를 계속 진행하세요. 정확한 메서드와 타입은 TypeScript SDK reference를 참조하세요.