ドキュメントを閲覧

運営元

OpenConnector の概要

OpenConnector は OOMOL のソースコードを公開しているプロジェクトです。利用可能な連携はコネクタ一覧で確認できます。このガイドではデプロイと運用を説明します。

OOMOL OpenConnector は、self-host できる source-available connection runtime です。組織が credential storage、provider connections、network access、action policy、logs、upgrades を自分の環境内で運用する必要がある場合に使用します。

runtime は provider actions を MCP、HTTP、OpenAPI、web console から公開します。Agents と clients は schemas、connection labels、scopes、results を扱い、provider の生の credentials は deployment boundary 内に保持されます。

ライセンスと商用利用

OpenConnector は、Apache 2.0 に追加条件を設けた OpenConnector License を採用しています。

商用利用、改変、組織内での利用、顧客の組織内で使うための導入が認められています。主な価値が別の業務機能にある製品に組み込み、その製品の利用者が自分のアカウントを接続することもできます。

OpenConnector またはその改変版を、OpenConnector の機能を主な価値とするホスティングサービスやマネージドサービスとして第三者に提供する場合は、OOMOL の商用ライセンスが必要です。接続ゲートウェイ、連携プラットフォーム、第三者がアカウントを接続して OpenConnector の操作を実行する API サービスなどが該当します。

v1.9.4 以前の公開済みバージョンには、従来の Apache 2.0 が引き続き適用されます。外部 API の利用規約や認可要件は別途守る必要があります。

deployment target を選択する

Target適しているケース
Docker Composelocal または single-server runtime への最短手順が必要な場合
Source runtimeOpenConnector または provider executors を開発する場合
Cloudflare Workersruntime records を D1、temporary transit files を R2 に保存する場合

セルフホスティングガイドでは、3 つの target をすべて説明しています。

自分で運用するもの

team は次の項目を管理します。

  • Admin token と runtime access tokens。
  • credential encryption keys と機密性の高い runtime storage。
  • OAuth callback URLs で使用する public origin。
  • provider OAuth clients または API key configurations。
  • action allowlists と blocklists。
  • backups、network controls、monitoring、upgrades。

providers を接続する

OpenConnector は、API key、custom credential、OAuth2、no-auth の provider connections に対応しています。一般的な OAuth app configuration guideから始め、provider 固有の設定が必要な場合は各ガイドを開きます。

保護された runtime から始める

runtime を自分の shell の外部に公開する前に、admin token と credential encryption key を設定します。Agents と clients 用に別々の runtime tokens を作成し、利用可能な actions を必要な操作に制限してください。

OOMOL OpenConnector セルフホスティングガイドに従って runtime をデプロイします。その後、TypeScript から OpenConnector SDK で self-hosted runtime を呼び出します。