OpenConnectorでAIエージェントの接続先を管理する

接続をAction契約へ変換する

OpenConnectorのREADMEは、1,000以上のプロバイダーと10,000以上の事前構築ActionをAIエージェントへ公開する認証ゲートウェイと説明しています。GitHub、Gmail、Notion、BigQuery、Google Analytics、Supabase、Airtable、Slackなどがカタログ例です。数字はREADMEの記載で、性能や対応品質の測定値ではありません。

アプリ側はConnector SDK、oo CLI、MCP、HTTPまたはOpenAPIから入口を選べます。Actionにはリクエストとレスポンスのスキーマ、必要スコープ、遅延読み込みされるexecutorソースがあるため、エージェントへ秘密鍵そのものを渡さず、実行結果と安全なアカウント表示を返す設計です。

docker compose up、Web Console、docs/runtime-api.md、runtime token、allowまたはblock policy、MCPの/v1/actions/*を一度に全部採用せず、1番目の確認では入力、処理、出力、失敗時の表示を分けて記録します。READMEにある名称と手元で実行した版を同じ記録へ残し、画面の成功表示だけで完了としません。設定を変更した場合は変更前の値、実行日時、生成物、ログの該当行を保存し、同じ入力を戻して比較します。

OAuthと資格情報の境界を読む

資格情報の方式としてAPIキー、OAuth2、カスタム資格情報、認証不要のプロバイダーが挙げられています。ランタイムは接続ID、スコープ、runtime token、Actionのallowまたはblockポリシー、ログの秘匿化を扱います。どのプロバイダーでも同じ認証手順になるとはREADMEは述べていません。

導入時は接続を一つだけ作り、Action検索、スキーマ閲覧、必要スコープの表示、実行結果、失敗ログの順に確認します。実行プロセスへプロバイダー秘密情報が出ないことを監視できるか、temporary file transitの保存場所と削除方法が説明されているかも、サービス選定とは別に確認が必要です。

docker compose up、Web Console、docs/runtime-api.md、runtime token、allowまたはblock policy、MCPの/v1/actions/*を一度に全部採用せず、2番目の確認では入力、処理、出力、失敗時の表示を分けて記録します。READMEにある名称と手元で実行した版を同じ記録へ残し、画面の成功表示だけで完了としません。設定を変更した場合は変更前の値、実行日時、生成物、ログの該当行を保存し、同じ入力を戻して比較します。

SDKとMCPを選ぶ場面

Connector SDKはTypeScriptの薄いHTTPクライアントで、self-hostedにはOpenConnector、OOMOL hostedの個人接続やSaaS接続にはConnectorまたはProjectConnectorを使います。oo connectorはActionを検索、検査、実行するローカルエージェント中継です。MCPの入口はhttp://localhost:3000/mcpです。

独自クライアントは/v1/actions/*を直接呼ぶか、生成された/openapi.jsonを参照できます。Web Consoleではコネクター、資格情報、runtime token、利用状況、最近の失敗を確認できます。画面の表示だけでなく、同じActionをSDKとMCPから呼んだ結果の差を記録すると、接続層の責任範囲が見えます。

docker compose up、Web Console、docs/runtime-api.md、runtime token、allowまたはblock policy、MCPの/v1/actions/*を一度に全部採用せず、3番目の確認では入力、処理、出力、失敗時の表示を分けて記録します。READMEにある名称と手元で実行した版を同じ記録へ残し、画面の成功表示だけで完了としません。設定を変更した場合は変更前の値、実行日時、生成物、ログの該当行を保存し、同じ入力を戻して比較します。

Cloudflareと自前運用の差

READMEはOOMOL Hosted、Cloudflare WorkersとD1、R2、Static Assetsを使う構成、DockerまたはNode.jsでの自前運用を並べています。自前構成ではSQLiteまたはPostgreSQLの状態保存、ローカルまたはS3互換のtransit storageを選べ、Fly.ioも選択肢です。

HostedではデプロイとOAuthアプリ設定を任せられる一方、Cloudflareとself-hostでは運用者がその責任を持ちます。互換表、性能基準、サービス保証、長期サポートは素材で確認できません。採用候補の構成ごとに、接続状態、Action実行、ログ、ファイル移送を同じテストで比較してください。

docker compose up、Web Console、docs/runtime-api.md、runtime token、allowまたはblock policy、MCPの/v1/actions/*を一度に全部採用せず、4番目の確認では入力、処理、出力、失敗時の表示を分けて記録します。READMEにある名称と手元で実行した版を同じ記録へ残し、画面の成功表示だけで完了としません。設定を変更した場合は変更前の値、実行日時、生成物、ログの該当行を保存し、同じ入力を戻して比較します。

OpenConnectorを小さく検証する

最初の検証対象をGitHubなど読み取り系のActionに限定し、docker compose up後にWeb Consoleで一つの資格情報とruntime tokenを設定します。docs/runtime-api.mdにあるauth header、response envelope、MCP toolの形式を固定し、provider idとAction idを記録します。

次にallowまたはblockポリシーで対象Actionを制限し、必要スコープを外した場合の失敗とredacted run logsを確認します。Apache-2.0のライセンスは利用条件の確認材料ですが、認証情報の安全性や本番性能の保証ではありません。

docker compose up、Web Console、docs/runtime-api.md、runtime token、allowまたはblock policy、MCPの/v1/actions/*を一度に全部採用せず、5番目の確認では入力、処理、出力、失敗時の表示を分けて記録します。READMEにある名称と手元で実行した版を同じ記録へ残し、画面の成功表示だけで完了としません。設定を変更した場合は変更前の値、実行日時、生成物、ログの該当行を保存し、同じ入力を戻して比較します。

採用を決める記録には、対象機能を使わなかった場合の代替結果も残します。入力を小さくした場合に成功しても、実際のデータ量、権限、保存先、実行先が変われば同じ結論にはなりません。READMEが説明していない保証は未確認として扱い、確認できた出力と確認できなかった項目を分けて判断します。

編集部の結論

OpenConnectorは、利用者のアプリへAIエージェントから継続的にアクセスさせたいプロダクトに向きます。向いていないのは、プロバイダーごとの差異やOAuthアプリの管理を確認せず、カタログ数だけで本番採用を決めるケースです。最初にdocker compose upで隔離環境を起動し、docs/runtime-api.mdのレスポンス、接続エイリアス、redacted run logsを確認してください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes