このページは AI コーディングエージェントスキルの一部で、人間ではなくエージェント向けに書かれています。人間向けの Base44 ドキュメントはデベロッパードキュメントを参照してください。

コネクタの作成

コネクタは、Base44 アプリを Google Calendar、Slack、Notion などの外部サービスに接続する OAuth インテグレーションです。接続後、バックエンド関数でアクセストークンを使用して外部 API を直接呼び出せます。

主要なコンセプト

直接 API アクセス: コネクタは生の OAuth アクセストークンを提供します - バックエンド関数から外部 API を直接呼び出します
アプリビルダーのアカウント: エンドユーザーのアカウントではなく、あなた (アプリビルダー) のアカウントを接続します
バックエンド関数のみ: セキュリティのため、トークンはサーバー側でのみアクセスできます

ファイルの場所

base44/connectors/ ディレクトリ (または config.jsonc の connectorsDir で指定されたディレクトリ) にコネクタファイルを作成します。 ファイル命名: {type}.jsonc または {type}.json 例:

base44/connectors/googlecalendar.jsonc
base44/connectors/slack.jsonc
base44/connectors/notion.json

スキーマ

各コネクタファイルは type を指定し、オプションで scopes のリストを指定します:

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events"
  ]
}

フィールド

フィールド	型	必須	説明
`type`	string	はい	インテグレーションタイプ (オプションを見るには `npx base44 connectors list-available` を実行)
`scopes`	string[]	いいえ	要求する OAuth スコープ (デフォルトは `[]`)

利用可能なコネクタタイプの発見

以下のコマンドを実行して、サポートされているコネクタタイプの最新リストを取得します。注意: stripe も有効なタイプですが、このコマンドからは返されません — サポート対象として扱います (下記の Stripe の例を参照)。

npx base44 connectors list-available

これにより、利用可能なすべてのインテグレーション、その表示名、説明、および必要な接続構成フィールドを含む JSON オブジェクトが返されます。出力例 (省略):

{
    "integrations": [
        {
            "integration_type": "googlecalendar",
            "display_name": "Google Calendar",
            "description": "Access and manage Google Calendar events",
            "connection_config_fields": []
        },
        {
            "integration_type": "slack",
            "display_name": "Slack User",
            "description": "Send messages and interact with Slack as yourself (user integration)",
            "connection_config_fields": []
        },
        {
            "integration_type": "share_point",
            "display_name": "SharePoint",
            "description": "Manage documents, lists, sites, and collaboration content in SharePoint",
            "connection_config_fields": [
                {
                    "name": "subdomain",
                    "display_name": "SharePoint Site",
                    "description": "The name of your SharePoint site (e.g., sites/mysite)",
                    "placeholder": "sites/mysite",
                    "required": true,
                    "validation_pattern": "^[a-zA-Z0-9/_-]+$",
                    "validation_error": "Please enter a valid SharePoint site path"
                }
            ]
        }
    ]
}

出力の integration_type 値をコネクタファイルの type フィールドに使用します。一部のコネクタには追加の connection_config_fields が必要です — 出力で詳細を確認してください。

Stripe (サンドボックス)

// base44/connectors/stripe.jsonc
{
  "type": "stripe",
  "scopes": []
}

注意: Stripe は OAuth ブラウザーフローを必要としません。このコネクタをプッシュすると、Base44 はサーバー側で自動的に Stripe サンドボックスアカウントをプロビジョニングします。プッシュ出力にサンドボックスを Stripe アカウントにリンクするためのクレーム URL が含まれる場合があります。

ルールと制約

タイプごとに 1 つのコネクタ: 同じタイプの複数のコネクタは持てません (例: 2 つの googlecalendar コネクタ)
タイプは有効である必要があります: type フィールドは有効なインテグレーションタイプである必要があります (利用可能なタイプを見るには npx base44 connectors list-available を実行)
スコープはプロバイダー固有: 各サービスには独自のスコープフォーマットがあります - プロバイダーのドキュメントを参照してください

次のステップ

コネクタファイルを作成したら、Base44 にプッシュします:

npx base44 connectors push

これにより、新しい各 OAuth コネクタをブラウザーで認可するよう促されます。Stripe は例外で、ブラウザーフローなしで自動的にプロビジョニングされます。詳細は connectors-push.md を参照してください。 Base44 から既存のコネクタをローカルファイルにプルするには:

npx base44 connectors pull

詳細は connectors-pull.md を参照してください。

このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版を参照してください。

Getting started

Building your app

Designing your app

Managing app data

Adding logic to your app

Selling on your app

Using on mobile

Domains

Securing your app

Measuring your app

Growing your app's reach

Superagents

Integrations

コネクタの作成

コネクタの作成

主要なコンセプト

ファイルの場所

スキーマ

フィールド

利用可能なコネクタタイプの発見

Stripe (サンドボックス)

ルールと制約

次のステップ

​コネクタの作成

​主要なコンセプト

​ファイルの場所

​スキーマ

​フィールド

​利用可能なコネクタタイプの発見

​Stripe (サンドボックス)

​ルールと制約

​次のステップ

コネクタの作成

主要なコンセプト

ファイルの場所

スキーマ

フィールド

利用可能なコネクタタイプの発見

Stripe (サンドボックス)

ルールと制約

次のステップ