Connector の概要

OOMOL Connector は、個人と teams 向けの hosted connection service です。Gmail、GitHub、Notion、Slack などの Apps を接続すると、OOMOL が OAuth、credential storage、token refresh、action execution を管理する間、Agent または信頼できる backend から承認済みの actions を使用できます。

この方法では、api_… 形式の personal API key を使います。key は backend environment または secret manager に保管してください。

同僚の招待、roles の割り当て、connection access の管理が必要な場合は、Team 管理を参照してください。

OOMOL Connector を使用する理由

一度接続して複数の場所で利用： 同じ App connection を oo CLI、MCP、SDK から呼び出し、対応する Agents 間で再利用できます。
authentication operations を削減： OOMOL が OAuth flows、credential storage、token refresh を管理します。
account credentials を保護： Agents、Skills、application code は、生の OAuth tokens を受け取らずに承認済み actions を使用します。
アクセスを正確に制御： 各 connection で許可する actions と、それを使用できる Team members を設定します。
個人と teams に対応： 個人は自分の Apps を接続でき、teams は connections を共有して member access を管理できます。

適切な Connector path を選択する

目的	Path
OOMOL account に接続された Apps を呼び出す	hosted `Connector` client
product の各 user が自分の account を接続できるようにする	SaaS integration
runtime と credential storage を自分で運用する	OpenConnector

call の仕組み

OOMOL で App account を接続します。
OOMOL Console で personal Connector API key を作成します。
信頼できる backend code で @oomol-lab/connector を初期化します。
action と、必要に応じて名前付き connection を選択します。
Connector が provider を呼び出し、action result を返します。

backend は provider の生の OAuth token を読むことなく、action results と execution metadata を受け取ります。

SDK の機能

必要な操作	SDK surface
model 化された operation を実行	`execute` または `executeRaw`
model 化された action がない endpoint を呼び出す	`proxy`
providers と action schemas を探す	`catalog`
connected accounts を一覧表示	`apps.list`

開発を始める

SDK で接続済み Apps を呼び出すに従い、package のインストール、API key の作成、最初の call、connection の選択を行います。共通 configuration、error handling、完全な API surface については、TypeScript SDK referenceを参照してください。

key を backend に保管する

personal API key を browser bundles、public repositories、prompts、client-side logs に含めないでください。request を product user ごとに scope する必要がある場合は Connector SaaS project を使用し、関係のない end users 間で 1 つの personal key を共有しないでください。