> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 連携の使用

> Base44 のアプリ、ワークスペース、アカウントを外部ツールやサービスに接続します

## 連携について

[連携](https://base44.com/integrations) を使うと、Base44 を残りのスタックに接続し、すべての API 呼び出しを手作業で配線することなく、ワークフローを自動化したり、データを取り込んだり、外部サービスを呼び出したりできます。

連携は 3 つのレベルで行えます:

* **アプリレベル:** 単一のアプリ内の連携:
  * **Built-in 連携** (Invoke LLM や SendEmail など)。
  * **Connectors** (Notion、Slack、Google Workspace などのツールへの OAuth ベースの接続)。
  * **バックエンド関数による外部 API 呼び出し** (アプリごとの Secrets と関数を使用)。
* **ワークスペースレベル:** ワークスペース全体で一度管理する共有 API:
  * **カスタム OpenAPI 連携** (OpenAPI 仕様に基づき、ワークスペース内の任意のアプリが安全に呼び出せます)。
* **アカウントレベル:** Base44 アカウントに紐づく接続:
  * **MCP 接続** (一度設定すれば、Base44 AI チャットが構築中に外部ツールを使用できます。アプリのデプロイ済みコードを変更する必要はありません)。

***

## アプリレベルの連携

アプリレベルの連携は単一のアプリ内に存在します。Built-in 連携、コネクタ、そのアプリだけに配線するバックエンド対応の外部 API が含まれます。

### Built-in 連携

一部の連携は Base44 にプリインストールされており、すぐに利用できます。これらは有料プラン、追加のセットアップ、別の API キーを必要としません。これらのコア連携を使えば、追加の設定なしで、任意のアプリに AI、メッセージング、ファイル処理、高度なロジックを追加できます。

**Base44 の Built-in 連携には以下が含まれます:**

* **Invoke LLM:** 詳細なプロンプトを使用して、組み込みの言語モデルから AI レスポンスを生成。JSON スキーマ出力、コンテキスト追加用のファイル添付、画像解析、最新情報のための Web 検索をサポート。
* **SendEmail:** カスタマイズ可能な送信者名とリッチな HTML コンテンツで、Base44 アプリ内の人にメールを送信。
  <Note>
    SendEmail は外部メーリングリストへの送信やファイル添付の追加をサポートしていません。
  </Note>
* **UploadFile:** アプリにファイルをアップロードできるようにします。返されるファイル URL を他の連携やワークフローで使用します。
* **GenerateImage:** 詳細なテキストプロンプトから画像を作成。生成された画像の URL を返します。
* **ExtractDataFromUploadedFile:** JSON スキーマを使用して、アップロードされたファイル (CSV、PNG、JPG、JPEG、PDF) から構造化データを抽出。データを一括インポートするのに便利です。

<Tip>
  [Built-in 連携](/Integrations/built-in-integrations) について詳しく学びましょう。
</Tip>

### Connectors

Connectors は OAuth 対応の連携で、特定のアプリがサポートされているツールに接続できるようにします。AI チャットにサービスへの接続を依頼し、サインインして要求された権限を承認します。アプリは、許可した内容に基づいて、そのツールでデータを読み書きできます。

<Warning>
  アプリで Connectors を使用するには、[**Builder プラン**](https://base44.com/pricing) 以上が必要です。
</Warning>

**Connectors で構築できる例:**

* Notion データベースを同期して、アプリ内のナレッジビューに利用。
* Slack チャネルに更新を投稿。
* Salesforce や HubSpot のレコードを社内ダッシュボードに同期。
* アプリからファイルを Google Drive に保存。
* 新しい予約が入ったときに Google Calendar の時間をブロック。
* 新しいブログ記事が公開されたときに LinkedIn 投稿を公開。
* ダッシュボードに TikTok プロフィールの統計やフォロワー数を表示。

<Tip>
  [Connectors について詳しく学ぶ](/Integrations/Connectors)。
</Tip>

### バックエンド関数による外部 API 呼び出し

バックエンド関数を使用した外部連携により、特定のアプリがアプリごとの認証情報で Stripe、Twilio、Google API などのサードパーティサービスと直接通信できるようになります。これらの呼び出しは、独自のバックエンド関数と Secrets を介して配線されます。

<Frame caption="AI チャットを使用してアプリに連携を接続する">
  <img src="https://mintcdn.com/base44/dZ1qJi0krzKe0iew/images/resend.png?fit=max&auto=format&n=dZ1qJi0krzKe0iew&q=85&s=147297448e51613a3fd7b1117c24d753" alt="AI チャットを使用してアプリに連携を接続する" className="mx-auto" width="1111" height="835" data-path="images/resend.png" />
</Frame>

**次の場合にバックエンド関数を使用します:**

* 単一のアプリで使い切りの連携が必要な場合。
* そのアプリに密結合したカスタムロジックが必要な場合。
* サービスがまだワークスペースのカスタム OpenAPI 連携として設定されていない場合。

**バックエンド関数による外部連携の例:**

* メールプロバイダー経由で、アプリを使用する新しいユーザーにウェルカムメールを送信。
* 既存の CRM をアプリのデータベースと同期。
* 誰かがフォームを送信したときに Slack でチームにアラート。
* 自分のプロバイダーキーを使って AI ツールでコンテンツを生成。
* まだコネクタやカスタム OpenAPI 連携がないベンダー固有の API を呼び出し。

<Warning>
  **重要:** バックエンド関数を使用するには、[**Builder プラン**](https://base44.com/pricing) 以上が必要です。
</Warning>

AI チャットで連携をリクエストすると、Base44 が段階的にガイドし、必要に応じて認証情報や認可を求めます。その後、バックエンドとフロントエンドのロジックを自動的に接続するので、すぐに利用を開始できます。

認証情報はアプリのダッシュボードに **Secrets** として保存し、**Dashboard → Code → Functions** にある TypeScript 関数で使用します。

<Tip>
  各バックエンド関数には編集、表示、テストできるコードファイルがあります。また、**Dashboard → Code → Functions** から各関数のログを確認することもできます。
</Tip>

***

## ワークスペースレベルの連携

ワークスペースレベルの連携はワークスペースに存在し、セットアップや認証情報を繰り返さずに、多くのアプリで再利用できます。

### カスタム OpenAPI 連携

カスタム OpenAPI 連携により、OpenAPI 仕様から共有外部 API をワークスペースレベルで登録できます。仕様を一度インポートし、公開したい操作を選択すると、そのワークスペース内の任意のアプリが SDK を通じてそれらの操作を呼び出せるようになります。

AI ビルダーとフロントエンドコードは、`base44.integrations.custom` を通じてカスタム OpenAPI 連携を直接呼び出すことができ、認証情報は公開されません。呼び出しは Base44 バックエンドを介してプロキシされるため、シークレットがブラウザに渡ることはありません。

これは、チームが多くのアプリで利用する社内 API やパートナー API に最適です。

<Warning>
  **重要:**

  * カスタム OpenAPI 連携を作成または編集できるのは、**Builder プラン以上のワークスペースオーナーと管理者のみ** です。
  * ワークスペース内の誰でも、既存のカスタム OpenAPI 連携をアプリで利用できます。Free プランでも可能です。
</Warning>

<Tip>
  これらの API の設定について詳しくは [**カスタム API 連携の管理**](/documentation/integrations/using-custom-integrations) を参照してください。
</Tip>

***

## アカウントレベルの接続

アカウントレベルの接続は、Base44 アカウントごとに一度設定すれば、Base44 AI チャットを使用するどこでも利用できます。

### MCP 接続

MCP 接続を使うと、カスタム MCP サーバーを Base44 アカウントに接続でき、AI チャットが構築中に外部ツールやデータをコンテキストとして使用できます。これにより、アプリのデプロイ済みランタイムを変更することなく、コンテキストを認識するビルダーチャットを実現します。

<Warning>
  **重要:**

  * MCP 接続は **Builder プラン以上** で利用できます。
  * MCP サーバーは、**Account Settings → MCP Connections** でアカウントごとに一度設定します。
  * AI チャットは、プロンプトが必要とする場合 (たとえば、そのサーバーに言及したり、提供されるデータを要求したりした場合) にのみ MCP サーバーを呼び出します。すべてのメッセージで毎回すべての MCP サーバーに接続するわけではありません。
</Warning>

**MCP 接続でできることの例:**

* AI チャットに社内ドキュメント MCP を検索させ、機能に最も関連性の高いページを要約させる。
* GitHub MCP サーバーに接続して、特定のリポジトリのオープンな issue の要約を求める。
* Amplitude やカスタムメトリクスサービスなどの分析 MCP に接続し、変更の計画中に最近のプロダクトメトリクスを会話に取り込むようチャットに依頼する。

<Tip>
  MCP サーバーの追加と管理について詳しくは [**カスタム MCP のセットアップ**](/documentation/account-and-billing/setting-up-a-custom-mcp) を参照してください。
</Tip>

***

## API キーを取得する

一部の連携には API キーが必要です。これは Base44 と外部サービス間のプライベートなパスワードのような役割を果たします。API キーは所有権を証明し、接続のセキュリティを保ちます。Base44 はキーを公開せずにアプリが使用できるよう、安全に保存します。

<Warning>
  API キーを公開しないでください。パスワードと同じように扱ってください。
</Warning>

**API キーを取得するには:**

1. 外部サービス (たとえば OpenAI、Resend、Notion) にログインします。
2. **Developer**、**API**、または **Integrations** セクションを見つけます。
3. **Create API Key** または **Generate Token** をクリックしてコピーします。
4. Base44 に API キーを貼り付けます:
   * **AI チャットを使用:** プロンプトが表示されたら、AI チャットに API キーを入力します。
     <Frame caption="Base44 の AI チャットで API キーを追加">
       <img src="https://mintcdn.com/base44/_sloqzobDUv4viJs/images/chataiapi.png?fit=max&auto=format&n=_sloqzobDUv4viJs&q=85&s=c66214a04f7b320fc4c72d77963335ac" alt="Base44 の AI チャットで API キーを追加" title="Base44 の AI チャットで API キーを追加" className="mx-auto" style={{ width:"61%" }} width="1006" height="1234" data-path="images/chataiapi.png" />
     </Frame>
   * **手動でセットアップ:** API キーを **Secrets** に保存します。\
     a. アプリのエディタで **Dashboard** をクリックします。\
     b. **Secrets** をクリックします。\
     c. **Add Secret** をクリックします。
   <Frame caption="Base44 のアプリダッシュボードでシークレットを追加">
     <img src="https://mintcdn.com/base44/md0uEgmxEQCB9Nzh/images/apikeys.png?fit=max&auto=format&n=md0uEgmxEQCB9Nzh&q=85&s=38737506f2d314b714dcc48fbfea347c" alt="Base44 のアプリダッシュボードでシークレットを追加" className="mx-auto" width="1270" height="727" data-path="images/apikeys.png" />
   </Frame>

カスタム OpenAPI 連携もシークレットを使用しますが、これらは連携の作成または編集時にワークスペース管理者によって一度設定され、アプリごとの Secrets ではなく、暗号化されたワークスペースシークレットとして保存されます。

***

## FAQ

連携の使用について詳しく知るには、下の質問をクリックしてください。

<AccordionGroup>
  <Accordion title="カスタム OpenAPI 連携とアプリごとの外部 API の違いは何ですか?">
    カスタム OpenAPI 連携は、OpenAPI 仕様からワークスペースに一度設定すれば、`base44.integrations.custom.call()` を通じてそのワークスペース内のすべてのアプリで利用できます。認証情報は暗号化されたワークスペースシークレットとして保存され、アプリのコードに公開されることはなく、それらを使用するためにバックエンド関数は必要ありません。

    アプリごとの外部 API は、特定のアプリ内のバックエンド関数と Secrets を使用します。アプリ固有のロジックや、ワークスペース内のすべてのアプリで API を共有したくない場合に最適です。
  </Accordion>

  <Accordion title="公開前に連携をテストする方法は?">
    アプリを公開する前に連携をテストして、問題を早期にキャッチしましょう:

    1. プロバイダーが提供している場合は、サンドボックスやテストモードを使用します (たとえば Stripe のテストキー)。
    2. 単純な成功パスだけでなく、実際のフローやエッジケースを試します。
    3. 入力と出力が UI とプロバイダーのダッシュボードで期待通りに一致するか確認します。
    4. Base44 と外部サービスの両方で連携のクレジット使用量をモニタリングします。
    5. アプリをプレビューして、リリース前に読み込みの遅さ、API 呼び出しの失敗、データ欠落を発見します。
  </Accordion>

  <Accordion title="連携が動作しないのはなぜ?">
    問題が発生した場合は、次を確認してください:

    * ワークスペースが Builder プラン以上であること (バックエンド関数を使用するアプリごとの外部 API の場合)。
    * API キーが正しく、Secrets またはカスタム OpenAPI 連携に保存されていること (該当する場合)。
    * 外部サービスに十分な有効なクレジットがあること。
    * 本番フローをテストする際は、テストではなく本番の認証情報を使用していること。
    * API リクエストに正しいエンドポイント、ペイロード、パラメータが含まれていること。
    * サービスのレート制限に達していないこと。
  </Accordion>

  <Accordion title="バックエンド関数とアプリごとの外部 API は誰が使用できますか?">
    バックエンド関数とアプリごとの外部 API は、アプリを作成したワークスペースで Builder プラン以上が必要です。ワークスペースが Free または Starter プランの場合、バックエンド関数とそれに依存する連携は利用できません。

    ワークスペースのオーナーと管理者は、所有しているアプリでバックエンド関数を作成できます。Editor ロールを持つコラボレーターも、ワークスペースが Builder プラン以上であれば、アプリ内のバックエンド関数を編集および作成できます。
  </Accordion>

  <Accordion title="バックエンド関数を使用するときに 403 エラーが出るのはなぜ?">
    バックエンド関数を使用するときに 403 エラーが表示される場合、アプリやワークスペースでバックエンド関数が利用できないか、リクエストに権限がない可能性があります。

    一般的な原因と修正:

    * **プランの要件:** バックエンド関数は Builder プラン以上でのみ利用可能です。ワークスペースが Free または Starter プランの場合、それに依存するバックエンド呼び出しやアプリごとの連携は 403 で失敗する可能性があります。
    * **関数内の権限:** バックエンド関数が、ユーザーがサインインしていない、または正しいロールを持っていないという理由でリクエストを拒否している可能性があります。関数コードに追加したロールやアクセスチェックを確認してください。
    * **外部サービスの権限:** 403 は呼び出している外部 API から来ることもあります。API キーに適切なスコープがあり、リクエストが正しいエンドポイントとメソッドを使用していることを確認してください。
    * **解決しない場合:** [トラブルシューティング](/Community-and-support/Troubleshooting) の記事を参照するか、Base44 サポートに連絡してください。
  </Accordion>

  <Accordion title="API キーを再生成または更新する方法は?">
    再生成または更新が必要な API キーには 2 種類あります:

    * **サードパーティサービスのキー:** そのサービスの開発者ポータル (OpenAI、Resend、Notion など) でキーを再生成し、**Dashboard → Secrets** またはカスタム OpenAPI 連携の設定で更新します。
    * **Base44 アカウントの API キー:**
      1. アカウントの右上のプロフィールアイコンをクリックします。
      2. **Account settings** をクリックします。
      3. **API Key** の横にある **Regenerate** をクリックします。

    <Note>
      再生成すると、Base44 API キーはすべての Base44 アプリで自動的に更新されます。Base44 キーを別のサービスに追加している場合は、そちらでも更新してください。
    </Note>
  </Accordion>

  <Accordion title="プランをダウングレードすると連携はどうなりますか?">
    * Built-in 連携は引き続き利用できます。
    * Connectors、カスタム OpenAPI 連携、MCP 接続、バックエンド関数に依存するアプリごとの外部 API は、[**Builder プラン**](https://base44.com/pricing) 以上にアップグレードするまで動作しなくなる可能性があります。
  </Accordion>

  <Accordion title="1 つのアプリで複数の連携を使用できますか?">
    はい。プランと設定が許す限り、Built-in 連携、Connectors、カスタム OpenAPI 連携、アプリごとの外部 API を同じアプリで組み合わせて使用できます。
  </Accordion>

  <Accordion title="Base44 や AI が代わりに API キーを取得できないのはなぜ?">
    セキュリティ上の理由から、Stripe、OpenAI、Notion などの外部サービスは、Base44 を含むサードパーティに認証情報への自動アクセスを許可しません。代わりに、次の手順を実行する必要があります:

    1. サービスにログインします。
    2. API または開発者セクションに移動します。
    3. キーを生成します。
    4. Secret またはワークスペースヘッダーとして Base44 に貼り付けます。

    追加すると、アプリやカスタム OpenAPI 連携はそのキーをバックグラウンドで安全に、コードなしで使用できます。

    <Note>
      **これが重要な理由:** API キーはサービスのパスワードのような役割を果たします。プライベートに管理することで、データの安全性を保ち、自分が許可したアクセスのみを確保できます。
    </Note>
  </Accordion>

  <Accordion title="MCP 接続は他のアプリ連携と同じように動作しますか?">
    いいえ。MCP 接続は、構築中の Base44 AI チャット専用です。**Settings → MCP Connections** でアカウントレベルで設定し、プロンプトがその MCP サーバーを必要とする場合にのみ使用されます。デプロイ済みのアプリは、この設定ページを通じて MCP サーバーを呼び出しません。
  </Accordion>
</AccordionGroup>

<Tip>
  まだヘルプが必要ですか? [**Discord**](https://discord.com/invite/ThpYPZpVts) に参加して、Base44 チームとコミュニティからリアルタイムのサポートを受けてください。
</Tip>

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