本文へ移動

ドキュメント

OpenConnector クライアント：SDK・CLI・HTTP・MCP

TypeScript SDK、oo CLI、HTTP、MCP から runtime を呼び出します。公開 Hacker News Action から始めましょう。

保守：OOMOL·

ソース確認日：2026-09-09. 例はリンク先のソースリビジョンと照合済みです。実際の外部 API の検証を示すものではなく、稼働中のバージョンとは異なる場合があります。

OpenConnector を使う場面

AI エージェントが認可済みのアカウントで外部サービスを呼び出す場合や、自社のインフラで認証情報と実行ポリシーを管理したい場合に OpenConnector を使います。

始め方

セルフホストまたは OOMOL ホストのランタイムを選び、アカウントを接続します。Action を探して入力スキーマと権限を確認し、小さな読み取り専用の呼び出しを行って結果を確認してください。

ランタイムと API の範囲

このドメインはプロジェクト情報とドキュメントを提供するもので、実行可能なコネクター API や MCP サーバーではありません。リクエストは選択したランタイムに送信してください。セルフホストでは、そのランタイムの /openapi.json と /docs を参照します。自社のユーザーにアカウント接続を提供する SaaS 製品は、別の OOMOL 製品連携ガイドに従ってください。

製品統合ガイド ↗

公式 oo CLI をインストール

公式インストールガイドに従って oo を導入し、oo connector で Action を探して呼び出します。選択したデプロイ先に合わせてランタイム URL、ランタイムトークン、アカウント接続を設定してください。

公式 oo CLI をインストール ↗

公式 TypeScript SDK

npm から @oomol-lab/connector をインストールしてください。自分のランタイムには OpenConnector クライアントを使います。ホスト型の個人アカウントや SaaS のエンドユーザー接続には OOMOL SDK ガイドを参照してください。

npm
npm install @oomol-lab/connector
npm: @oomol-lab/connector ↗

ランタイムの OpenAPI リファレンス

固定したランタイムのリビジョンから生成した仕様をダウンロードできます。使用前に runtimeUrl を自分のデプロイ先に設定してください。プロバイダー固有の Action スキーマは、そのランタイムのカタログで取得します。このサイトは API 呼び出しを実行しません。

ランタイムの OpenAPI リファレンス →ランタイムのソース· 72de05b ↗

TypeScript

最初に @oomol-lab/connector をインストールしてください。この例では、Node.js から稼働中のローカル OpenConnector を呼び出します。

TypeScript
import { OpenConnector } from "@oomol-lab/connector";

const connector = new OpenConnector({
  baseUrl: "http://localhost:3000",
  runtimeToken: process.env.OOMOL_CONNECT_RUNTIME_TOKEN,
});

const stories = await connector.hackernews.get_top_stories({});
console.log(stories);

CLI

oo CLI をインストールし、connector コマンドの接続先をローカル環境に設定します。認証を有効にした環境では、ランタイムトークンも必要です。

CLI
oo connector login http://localhost:3000
oo connector search "Hacker News"
oo connector schema hackernews.get_top_stories
oo connector run hackernews --action get_top_stories --data '{}'

HTTP

この読み取り専用 Action はプロバイダーの認証なしでローカル環境から呼び出せます。ランタイムの認証が有効な場合は Bearer トークンを追加してください。

HTTP
curl -s -X POST \
  http://localhost:3000/v1/actions/hackernews.get_top_stories \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

MCP

対応するエージェントホストに、この HTTP MCP エンドポイントを設定してください。クライアント認証と利用可能なツールはランタイム API ガイドを参照してください。

MCP
http://localhost:3000/mcp

結果の読み方

HTTP ランタイムの応答には success、message、data、meta が含まれます。HTTP ステータスだけでなく success と Action の出力スキーマを確認してください。実行メタデータに executionId があれば、対応するマスキング済みログを探せます。以下は応答形式の例であり、実際の API 実行結果ではありません。

応答形式の例
{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

呼び出しに失敗した場合

  • 認証エラーではエンドポイントと認証情報の種類を確認します。管理者認証は /api、ランタイム Bearer トークンは /v1 と /mcp 用です。プロバイダーの API キーをランタイムトークンの代わりには使えません。
  • 権限エラーでは Action の必要 scopes、ランタイムの Action ルール、接続へのアクセス権を確認します。有効なトークンでも指定アカウントを使えない場合があります。
  • 結果が空の場合は接続アカウントと対象リソースの共有範囲を確認します。認証に成功しても、すべてのワークスペース、チャンネル、文書へアクセスできるわけではありません。
  • 再試行前にエラーと実行ログを確認します。データを変更する Action はすでに完了していないか確認し、無条件に同じリクエストを繰り返さないでください。
Markdown で読む