Leina 
Wanta 
integration path を選択する
connected account の所有者、calls の実行場所、credential boundary の運用者に基づいて path を選択します。
4 つの path を比較する
| Path | Connected account の所有者 | Calls の経路 | 自分で運用するもの |
|---|---|---|---|
| Agent setup | 自分 | oo CLI または OOMOL MCP | Agent environment |
| Hosted Connector SDK | 自分 | OOMOL hosted gateway | backend code |
| Connector SaaS project | product の各 user | OOMOL hosted gateway | product と user mapping |
| Self-hosted OpenConnector | 自分または組織 | 自分の OpenConnector runtime | runtime、storage、security、updates |
Agent から OOMOL を使用する
Codex、ChatGPT、Claude Code、その他の対応 Agent から、自分が接続した Apps を使用する場合は、この path を選びます。
次の操作を行います。
- OOMOL で App を接続します。
- Agent に oo CLI をインストールするか、MCP client を設定します。
- 接続済みの App を使うよう Agent に依頼します。
クイックスタートから始めてください。
backend code から自分の connections を呼び出す
信頼できる backend から自分の OOMOL account に接続された Apps を呼び出す場合は、hosted Connector client を選択します。
この方法では、api_… 形式の personal API key を使います。key は backend に保管され、自分の connections に対する calls を認証します。
OOMOL Connector SDK ガイドを参照してください。
end users が自分の accounts を接続できるようにする
product の各 user が自分の Gmail、Slack、Notion、その他の provider account を認証する必要がある場合は、Connector for SaaS を選択します。
backend が authorization links を作成し、得られた connected account ID と一緒に user ID を保存して、その user の actions を実行します。この方法では、oo_proj_… 形式の project API key を使います。
Connector for SaaS ガイドを参照してください。
OpenConnector を自分で実行する
team が runtime、database、credential encryption、network access、logs、upgrade process を運用する必要がある場合は、self-hosting を選択します。
runtime clients では、oct_… 形式の token を使用できます。provider OAuth apps、encryption keys、storage、backups、action policy は自分で管理します。
OOMOL OpenConnector セルフホスティングガイドを参照してください。
product ごとの credential scope
| Credential | 使用する client | Scope |
|---|---|---|
api_… | Hosted Connector client | 自分の personal connections |
oo_proj_… | ProjectConnector と SaaS APIs | 1 つの Connector project とその end users |
oct_… | OpenConnector client、HTTP、MCP | 1 つの self-hosted runtime |
3 種類の credentials はすべて、信頼できる backend、secret manager、または保護された Agent environment に保管してください。browser bundles、public repositories、prompts に置かないでください。
3 つの質問で判断する
- 接続する account の所有者は誰ですか？ 自分の account なら Agent setup または personal SDK、end-user accounts なら SaaS project を選びます。
- credential storage と token refresh を誰が運用しますか？ 運用作業を減らすには OOMOL hosting、team がその boundary を管理する必要がある場合は self-host を選びます。
- actions はどこから呼び出しますか？ 対話的な Agent 作業には Agent setup、product backend calls には SDK または HTTP path を使います。
path を選択したら、providers や production policy を追加する前に、その Quickstart を完了してください。