AI エージェントを GitHub に接続

認証方式

• OAuth 2.0
• API キー

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

このコネクターの確認事項

この例は認証済み GitHub ユーザーを読み取ります。目的のアカウントか確認してください。成功しても、リポジトリ単位の権限や他の GitHub Action を検証したことにはなりません。

呼び出す前に Action を確認

例の用途

接続した GitHub ユーザーのプロフィールを取得します。

Action に必要なスコープ

• read:user
• user:email

稼働中のインスタンスからスキーマを取得し、実行前に必須入力、権限、アカウント接続を確認してください。

curl -s http://localhost:3000/v1/actions/github.get_current_user

アカウントを接続したら、使用するリソースに合わせて入力例を変更します。runtime 認証が有効な場合は、runtime の Bearer Token も指定してください。

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

結果の読み方

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 はすでに完了していないか確認し、無条件に同じリクエストを繰り返さないでください。

次のステップ

対応するプロバイダーでは、OOMOL が OAuth アプリの設定と実行環境を管理します。利用するアカウントの選択と権限の承認は、ご自身で行います。