コア概念

3 つの Connector products は providers、actions、schemas を共有しますが、account isolation と permission models は異なります。最初に product を特定し、その connection、connected account、Team、Project resources を解釈してください。

3 つの products に共通する概念

Apps と providers

App は、Gmail、GitHub、Slack など、user が画面上で選択して接続する service です。

provider または service は、対応する Connector integration です。authentication、actions、schemas、Connector が upstream API に request する方法を定義します。App と provider の名前は通常一致しますが、App は user-facing service、provider は Connector implementation boundary を表します。

Actions と tools

action は provider が公開する呼び出し可能な 1 つの operation です。action ID は通常、gmail.search_threads のように service と operation を組み合わせます。各 action は input schema を持ち、call が返す data を定義します。

tool は、Agent、CLI、MCP client が action を認識する calling surface です。SDK は通常 action を直接実行し、Agent は利用可能な actions を tools として検出して呼び出します。

実行前に次の項目を確認してください。

• action が使用する account。
• 送信される parameters。
• operation が data を読み取る、書き込む、または削除するか。
• 現在の identity が対応する account resource を使用できるか。

Agents と Skills

Agent は tool を選び、parameters を指定し、result を使ってタスクを続行します。OOMOL は、その作業で使う認証済み App capabilities を提供します。

Skill は再利用可能な task instructions のセットです。使用する tools、その順序、維持する constraints、result の整理方法を Agent に伝えます。実行には Agent の identity と利用可能な tools が使われ、Connector が App credentials を保存します。

OOMOL Connector（ホスト型）

Connection

connection は、personal または Team scope にある App account の接続 instance です。独自の connection name と ID を持ち、account authorization、status、permission settings に関連付けられます。

同じ App account を複数回接続できます。各 connection では次の項目を個別に設定できます。

• Action access：connection が許可する actions。
• Member access：connection を使用できる Team members。

member が呼び出せる actions は、アクセス可能なすべての connections で許可された actions の和集合です。

Team

Team は Hosted Connector の Team tenant scope です。active Team によって、caller が参照できる connections と、その中で利用できる actions が決まります。

CLI、MCP、SDK clients は Team を明示的に選択し、後で default Team が変更されても誤った connection が選ばれないようにしてください。Team plan は seat ごとに課金されます。現在の詳細は Console の Billing で確認してください。

有効なアクセス

call は次の boundaries の積集合内でのみ実行できます。

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

設定の詳細は、アクセス制御と Team 管理を参照してください。

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

SaaS 向け Connector

Connector for SaaS を使うと、product の users が自分の third-party accounts を接続できます。別の multi-tenant resource model を使用します。

connected account は、Project 内で 1 人の external user が認証した provider account を表します。backend は、その product user の action を実行するときに connected account を選択します。

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

product は自分の users を認証し、安定して推測されにくい external-user mapping を管理します。resource model と integration flow は、Connector for SaaSを参照してください。

OpenConnector

OpenConnector は、自分の infrastructure にデプロイする open-source runtime と gateway です。

• runtime は providers を読み込み、connections を管理し、credentials を選択し、policy を適用して Provider APIs を呼び出します。
• gateway は、runtime が MCP、HTTP、OpenAPI、SDK clients に公開する access surface です。
• runtime token は、client が runtime とその capabilities にアクセスできるかを制御します。

OpenConnector は runtime、connections、access policy を自分が管理する infrastructure に配置します。callers は MCP、HTTP、OpenAPI、SDK から actions を使用します。

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

operator は credential encryption、tokens、storage、networking、logs、backups、upgrades を管理します。boundary の詳細は、OpenConnectorを参照してください。

認証情報の境界

provider の生の OAuth tokens、API keys、custom credentials を Agents、Skills、browser clients、product users に公開しないでください。

• Hosted Connector と Connector for SaaS では、OOMOL が hosted boundary 内で credentials を保存して更新します。
• OpenConnector operator は、自分の infrastructure で credentials を保護します。
• Connector は action または対応する proxy request の実行時に credentials を読み込み、execution result だけを caller に返します。

適切な用語を選択する

product を選択したら、その概要と integration guide に進んでください。正確な methods と types は、TypeScript SDK referenceを参照してください。