oomol-lab/open-connector

OpenConnector – AIエージェントが外部サービスを利用するためのゲートウェイ

概要 | OpenConnectorは、AIエージェント（または任意のアプリ）が、GitHub、Gmail、Notion、Slack、BigQueryなど、数千のサードパーティサービスを呼び出せるようにするオープンソースの「コネクタゲートウェイ」です。エージェントにユーザーの認証情報への直接アクセスを許可することなく、1,000以上のプロバイダーと10,000以上の事前構築済みアクション（個々のAPI呼び出し）のカタログを提供し、エージェントがそれらを検出、検査、呼び出しできます。

AIにとって重要な理由 | 最新のLLM搭載エージェントは、実際のデータに基づいて行動し、タスクを実行する必要があります（メール送信、スプレッドシート更新、データベース照会など）。各エージェントのOAuthフロー、APIキー、ポリシー適用を管理することは複雑で、セキュリティリスクがあります。OpenConnectorは認証情報の管理を一元化し、エージェントが安全に呼び出せる安定した検査可能なAPIを提供します。

主要コンポーネント

• コネクタカタログ – リクエスト/レスポンススキーマ、必要なスコープ、実行可能コードを含む、プロバイダーとアクションの共有レジストリ。
• ランタイムゲートウェイ – 認証情報を保存し、ポリシーを適用し、実行をログし、アクションを実行するNode.js/Cloudflare互換サービス。
• 開発者ツール –
  • Connector SDK（TypeScriptクライアント）プログラムでの使用向け。
  • oo CLI ローカルエージェント中継とデバッグ用。
  • MCP エンドポイント MCPプロトコルを理解するエージェント向け。
  • 直接HTTP/OpenAPIアクセス。
• Webコンソール – カタログの閲覧、認証情報の設定、ランタイムトークンの作成、ログの検査のためのUI。

---

デプロイオプション

• マネージド（OOMOL） – ホスト型OAuthアプリとランタイム、インフラ不要。
• セルフホスト – Docker ComposeまたはプレーンなNode.js。状態はSQLite（デフォルト）またはPostgreSQLに保存。ファイル転送にはS3互換ストレージを使用可能。
• プラットフォームに依存しない – Cloudflare Workers、Fly.io、RepoCloud、nibrun、NEXUS AIなどで動作。

---

典型的なワークフロー

1. ユーザーアカウントを接続 – APIキーまたはOAuth2を使用（例：PUT /api/connections/github）。
2. エージェントがアクションを発見 – カタログまたはOpenAPI仕様を照会してgithub.get_current_userを見つける。
3. エージェントがアクションを呼び出し – ランタイムトークンを使用してPOST /v1/actions/github.get_current_userを呼び出す。
4. ゲートウェイが実行 – 保存された認証情報を使用し、許可/ブロックポリシーを適用し、実行をログし、結果を返す。

---

誰が使うべきか

• ユーザーのSaaSツールへの再利用可能で監査可能なアクセスを必要とするAI駆動製品を構築するチーム。
• 個別のOAuth統合を書かずに、プラグアンドプレイのアクションカタログを求める開発者。
• エージェントに行動を許可しながら、認証情報を管理されたランタイムの背後に置くことを好む組織。

---

はじめに

# クイックローカル起動（Docker Composeがビルド済みイメージをプル）
 docker compose up
 # 認証不要のアクションで確認
 curl -X POST http://localhost:3000/v1/actions/hackernews.get_top_stories \
      -H 'content-type: application/json' -d '{"input":{}}'

その後、コンソール用にhttp://localhost:3000を開くか、OpenAPIリファレンス用にhttp://localhost:3000/docsを開きます。

ライセンスとコミュニティ

• コードはApache-2.0ライセンス。サードパーティのプロバイダー資産は対象外。
• 貢献を歓迎（CONTRIBUTING.mdを参照）。フレンドリーな行動規範があります。

OpenConnector は、LLMエージェントが広大なWebサービスエコシステムと安全かつ確実にやり取りできるようにする配管の役割を果たします。