本文へ移動

クイックスタート

OpenConnector を起動して最初の Action を呼び出す

すべてを管理したいならローカル実行、デプロイを省きたいなら OOMOL。どちらも実際の Action 呼び出しにつながります。

01 / 自分のインフラで

ローカルで OpenConnector を動かす。

Git と Docker Compose を含む Docker が必要です。アプリのアカウントを設定する前に、認証不要の Action から始めましょう。

  1. 1. ランタイムを起動

    リポジトリをクローンし、公開済みイメージを起動します。この試用手順は、ご自身のマシン上のローカル環境で行ってください。

    Terminal
    git clone https://github.com/oomol-lab/open-connector.git
    cd open-connector
    docker compose up
    ローカルコンソール
    http://localhost:3000 ↗
    ローカル API リファレンス
    http://localhost:3000/docs ↗
  2. 2. 最初の Action を呼び出す

    別のターミナルで Hacker News の人気記事を取得します。この読み取り専用 Action はプロバイダーのアカウントを必要としません。

    HTTP · Hacker News
    curl -s -X POST \
      http://localhost:3000/v1/actions/hackernews.get_top_stories \
      -H 'content-type: application/json' \
      -d '{"input":{}}'
  3. 3. アカウントを接続

    ローカルコンソールでプロバイダーを選び、認証情報を設定します。OAuth 対応サービスでは、そのサービスに自分の OAuth アプリを登録する必要があります。

    認証情報と OAuth
OpenConnector の実行概要:準備状況、Action のアクティビティ、最近の実行ログ
オープンソースプロジェクトのリポジトリからのスクリーンショットです。カタログの件数は撮影時のバージョンに基づきます。

ランタイムを公開する前に、管理者認証、ランタイムトークン、認証情報の暗号化、公開 OAuth オリジンを設定してください。本番環境の設定はデプロイガイドを参照してください。

詳しいデプロイガイド

02 / デプロイ不要

OOMOL で接続する。

ホスト型ランタイムと対応アプリのマネージド OAuth を利用できます。接続の呼び出し方を選びましょう。

  1. 01

    アプリを接続

    OOMOL にログインし、アプリを選んで利用するアカウントを認可します。一部のアプリは API キーや独自の認証情報が必要です。

  2. 02

    クライアントを選択

    CLI や MCP はエージェント設定ガイドに従って設定します。バックエンドコードでは、個人用 API キーを作成し、Connector SDK クライアントを使います。

  3. 03

    最初の呼び出しを実行

    小さな読み取り専用 Action から始めましょう。実行前に接続先と権限を確認してください。