---
author: OOMOL
author_url: https://oomol.com/ja/about/
title: Connector の概要
description: hosted Connector gateway を使い、信頼できる backend code から OOMOL account
  に接続された Apps を呼び出します。
lang: ja
canonical_url: https://oomol.com/ja/docs/connector/
markdown_url: https://oomol.com/ja/docs/connector.md
---

# 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 管理](/ja/docs/team-management/)を参照してください。

## 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](/ja/docs/saas/) |
| runtime と credential storage を自分で運用する | [OpenConnector](/ja/docs/openconnector/) |

## call の仕組み

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

バックエンドはプロバイダーの生の OAuth トークンを読むことなく操作結果を受け取ります。実行メタデータも必要な場合は executeRaw を使います。execute は操作の出力のみを返します。

## SDK の機能

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

## 開発を始める

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

## 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 を共有しないでください。