OpenConnector の概要

OOMOL OpenConnector は、self-host できる open-source 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 内に保持されます。

deployment target を選択する

Target	適しているケース
Docker Compose	local または single-server runtime への最短手順が必要な場合
Source runtime	OpenConnector または provider executors を開発する場合
Cloudflare Workers	runtime 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 を呼び出します。