> ## 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.

# アプリユーザー向けコネクタの設定

> アプリを使用する各ユーザーが Google、Slack、Notion などのサービスに自分のアカウントを接続できるようにします。

アプリユーザーコネクタを追加して、アプリを使用する各人が Google、Slack、Notion などのサードパーティサービスに自分のアカウントを接続できるようにします。

アプリユーザーコネクタはワークスペースレベルで追加され、そのワークスペース内のアプリ全体で使用できます。ワークスペース設定から、または特定のアプリの AI チャットから直接追加できます。

<Frame caption="アプリユーザー向けのコネクタ">
  <img src="https://mintcdn.com/base44/aoL04bxk9hJFdHsJ/images/connectors-workspace.png?fit=max&auto=format&n=aoL04bxk9hJFdHsJ&q=85&s=9e8d57590d25676141b8e4bf07111128" alt="アプリユーザー向けに利用可能なコネクタ" className="mx-auto" style={{ width:"85%" }} width="772" height="612" data-path="images/connectors-workspace.png" />
</Frame>

<Columns cols={3}>
  <Card title="スケジューリングアプリ" icon="calendar">
    各人が自分の Google カレンダーを接続して、空き時間を確認したりイベントを作成したりできるようにします。
  </Card>

  <Card title="セールスアプリ" icon="handshake">
    各営業担当者が自分の HubSpot アカウントを接続して、連絡先や案件を管理できるようにします。
  </Card>

  <Card title="コンテンツプランニングアプリ" icon="notebook">
    各チームメンバーが自分の Notion アカウントを接続して、ページやタスクを同期できるようにします。
  </Card>
</Columns>

<Card title="始める前に" type="tip">
  Base44 でコネクタを追加する前に、接続したいサービスの開発者プラットフォームで OAuth アプリを作成してください。[コネクタ詳細の準備](#preparing-connector-details) を参照してください。
</Card>

<Note>
  アプリユーザーコネクタを追加するには、[**Builder プラン**](/Account-and-billing/Billing-and-plans) 以上が必要です。
</Note>

***

## コネクタ詳細の準備

Base44 でコネクタを追加する前に、接続したいサービスが必要とする詳細を準備します。これは通常、そのサービスの開発者プラットフォームで OAuth アプリまたはプロジェクトを作成し、Base44 のリダイレクト URI を追加し、必要な詳細を Base44 にコピーすることを意味します。

正確なセットアップはサービスによって異なります。たとえば、Google は [Google Cloud](https://cloud.google.com/) を使用し、Slack は [Slack API Applications](https://api.slack.com/apps) を使用し、LinkedIn は [LinkedIn developer portal](https://developer.linkedin.com/) を使用します。

<Card title="セットアップの概要" icon="key">
  1. **Base44 のリダイレクト URI を準備する:** ライブアプリ、カスタムドメイン、またはプレビューのコールバック URL を使用します。以下のフォーマットを参照してください。
  2. **OAuth アプリを作成する:** これはサードパーティサービスの開発者プラットフォームで行います。
  3. **リダイレクト URI を追加する:** Base44 のリダイレクト URI を OAuth アプリ設定に貼り付けます。
  4. **コネクタ詳細を準備する:** **Client ID** と **Client Secret** をコピーし、アプリが必要とする **scopes** を選択します。
  5. **Base44 でコネクタを追加する:** コネクタセットアップフォームに詳細を貼り付けます。
</Card>

<Card title="リダイレクト URI フォーマット" icon="link">
  * **Live app URL:** `https://your-live-app-domain.base44.app/api/external-auth/callback`
  * **Custom domain:** `https://your-custom-domain.com/api/external-auth/callback`
  * **Preview URL:** `https://preview--your-live-app-domain.base44.app/api/external-auth/callback`
</Card>

<Note>
  * 一部のサービスでは、リダイレクト URI を **callback URL** または **authorized redirect URI** と呼びます。
  * リダイレクト URI は表示されたとおりに正確に入力してください。
  * プレビューでコネクタをテストしたい場合は、プレビューリダイレクト URI を追加してください。
  * 一部のサービスでは **Client Secret** は 1 回だけ表示されます。ページを閉じる前にコピーしてください。
</Note>

<Warning>
  Client Secret はパスワードと同じように扱ってください。他の人と共有しないでください。安全なコネクタセットアップフローの一部として特に求められたときだけ、AI チャットにコピーしてください。
</Warning>

***

## Base44 でコネクタを追加する

OAuth アプリの詳細を取得したら、ワークスペース設定から、または特定のアプリの AI チャットから、コネクタを追加します。

### ワークスペースからコネクタを追加する

ワークスペース設定からコネクタを追加し、必要な詳細を入力します。

**ワークスペースからコネクタを追加するには:**

1. プロフィールアイコンをクリックします。
2. **Account settings** をクリックします。
3. **Connectors** をクリックします。
4. **Connectors For App Users** の下で、**Add Connector** をクリックします。
5. 追加したいコネクタをクリックします。
6. 以下を入力します:
   * **Connector name:** このコネクタを識別するための短い名前を入力します（例: `Google Calendar scheduling`）。
   * **Client ID:** 接続されたサービスで作成した OAuth アプリの Client ID を入力します。
   * **Client Secret:** 同じ OAuth アプリの Client Secret を入力します。
   * **Scopes:** アプリが必要とするスコープを、各スコープを別の行に入力します。
7. **Add Connector** をクリックします。

<Frame caption="ワークスペース設定からコネクタ詳細を入力する">
  <img src="https://mintcdn.com/base44/424DHhFiJUmaJkN2/images/add-linkedin-connection-workspace.png?fit=max&auto=format&n=424DHhFiJUmaJkN2&q=85&s=4054a1ce38fbaa9aa9f1ec893e9eca5c" alt="コネクタ名、Client ID、Client Secret、scopes のフィールドを表示する LinkedIn 接続追加ウィンドウ。" className="mx-auto" style={{ width:"85%" }} width="723" height="565" data-path="images/add-linkedin-connection-workspace.png" />
</Frame>

### AI チャットを使用してコネクタを追加する

コネクタを使用したいアプリの AI チャットから始めることもできます。

**AI チャットからコネクタを追加するには:**

1. コネクタを使用したいアプリを開きます。
2. AI チャットに、各人が自分のアカウントを接続する機能を追加するよう依頼します。
3. コネクタがすでにワークスペースで設定されている場合、AI チャットはアプリ内で直接使用できます。
4. コネクタがまだ設定されていない場合、**Connector name**、**Client ID**、**Client Secret**、**Scopes** などのコネクタ詳細を入力します。
5. **Connect** をクリックします。

<Frame caption="AI チャットからコネクタ詳細を入力する">
  <img src="https://mintcdn.com/base44/424DHhFiJUmaJkN2/images/linkedin-ai-chat-connector.png?fit=max&auto=format&n=424DHhFiJUmaJkN2&q=85&s=419ef0219e24ae24c37ac8b725bedea7" alt="コネクタ名、Client ID、Client Secret、scopes などのコネクタ詳細を求める AI チャット。" className="mx-auto" style={{ width:"70%" }} width="506" height="750" data-path="images/linkedin-ai-chat-connector.png" />
</Frame>

***

## アプリでコネクタを使用する

コネクタがセットアップされたら、それを使用したいアプリの AI チャットに、そのコネクタで機能を構築するよう促します。

<Frame caption="アプリでユーザーコネクタを使用する">
  <img src="https://mintcdn.com/base44/LwNvwxCAifgZrGCe/images/linkedin-app-users.png?fit=max&auto=format&n=LwNvwxCAifgZrGCe&q=85&s=651cb6d5383d824537311263fbc8409d" alt="LinkedIn 接続セクションと Connect LinkedIn ボタンを表示するアプリの設定ページ。" className="mx-auto" style={{ width:"90%" }} width="1045" height="465" data-path="images/linkedin-app-users.png" />
</Frame>

***

## アプリユーザー向けコネクタの管理

**Connectors** タブからいつでもコネクタを更新または削除できます。変更はワークスペース内のすべてのアプリに適用されます。

### アプリユーザーコネクタの編集

名前、Client ID、Client Secret、scopes を更新するには、アプリユーザーコネクタを編集します。

<Note>
  scopes を変更した場合、すでにアカウントを接続している人は、アプリ内から再度アカウントを接続し、更新された権限を承認する必要があります。
</Note>

**アプリユーザーコネクタを編集するには:**

1. プロフィールアイコンをクリックします。
2. **Account settings** をクリックします。
3. **Connectors** をクリックします。
4. **Connectors For App Users** の下で、コネクタにマウスを乗せ、**View** をクリックします。
5. 接続名にマウスを乗せ、**Edit** をクリックします。
6. フィールドを更新します。
7. **Save Changes** をクリックします。

### アプリユーザーコネクタの認証情報のローテーション

接続されたサービスが OAuth アプリの認証情報の更新を求めた場合、またはアプリユーザーコネクタで使用される Client Secret を置き換える必要がある場合は、認証情報をローテーションします。

<Note>
  * 既存の接続は、アクセストークンの有効期限が切れるまで引き続き機能します。接続されたサービスで以前の Client Secret を取り消すと、接続の更新が必要になったときに、アプリ内から再度アカウントを接続するよう促される場合があります。
  * 正確な認証情報のローテーション手順は、接続されたサービスによって異なります。一部のサービスでは、これを Client Secret のローテーション、再生成、または取り消しと呼びます。
</Note>

**アプリユーザーコネクタの認証情報をローテーションするには:**

1. Google、Slack、Notion、または他の接続されたサービスなど、関連するサービスの開発者アカウントに移動します。
2. Base44 コネクタ用に作成した OAuth アプリを見つけます。
3. OAuth またはアプリ設定を開きます。
4. OAuth アプリの新しい Client Secret を取り消す、ローテーションする、または生成します。
5. Base44 で、プロフィールアイコンをクリックします。
6. **Account settings** をクリックします。
7. **Connectors** をクリックします。
8. **Connectors For App Users** の下で、コネクタにマウスを乗せ、**View** をクリックします。
9. 接続名にマウスを乗せ、**Edit** をクリックします。
10. **Client Secret** フィールドを更新します。
11. **Save Changes** をクリックします。

<Tip>
  ローテーションが必要な各アプリユーザーコネクタに対してこのプロセスを繰り返します。
</Tip>

### アプリユーザーコネクタの削除

ワークスペース内のアプリ全体で利用可能にしたくないアプリユーザーコネクタを削除します。

<Warning>
  コネクタを削除すると、それを使用していたすべての人のアプリから削除されます。これは元に戻せません。
</Warning>

**アプリユーザーコネクタを削除するには:**

1. プロフィールアイコンをクリックします。
2. **Account settings** をクリックします。
3. **Connectors** をクリックします。
4. **Connectors For App Users** の下で、コネクタにマウスを乗せ、**View** をクリックします。
5. 接続名にマウスを乗せ、**Edit** をクリックします。
6. **Delete Connector** をクリックします。
7. 確認するために再度 **Delete Connector** をクリックします。

<Frame caption="アプリユーザー向けコネクタの管理">
  <img src="https://mintcdn.com/base44/YeTsY1JNKYiNbSsU/images/editing-user-connectors.png?fit=max&auto=format&n=YeTsY1JNKYiNbSsU&q=85&s=b2b69d9ea45a22cd188436a0068a4176" alt="コネクタ名、Client ID、Client Secret、scopes、変更の保存またはコネクタの削除オプションを表示する Edit connector ウィンドウ。" className="mx-auto" style={{ width:"85%" }} width="639" height="510" data-path="images/editing-user-connectors.png" />
</Frame>

***

## トラブルシューティング

アプリユーザーコネクタのセットアップに関するトラブルシューティングを行うには、以下のトピックをクリックしてください。

<AccordionGroup>
  <Accordion title="リダイレクト URI 不一致">
    これは通常、接続されたサービスのリダイレクト URI が Base44 コールバック URL と正確に一致しないことを意味します。

    **リダイレクト URI 不一致を修正するには:**

    1. 接続されたサービスで OAuth アプリを開きます。
    2. リダイレクト URI、コールバック URL、または承認済みリダイレクト URI 設定に移動します。
    3. URL が Base44 コールバック URL と正確に一致しているか確認します。
    4. アプリがカスタムドメインを使用しているか確認します。
    5. プレビューでテストしているか確認します。
    6. 正しいライブ、プレビュー、またはカスタムドメインのコールバック URL を追加します。
    7. OAuth アプリ設定を保存します。
    8. アプリから再度接続を試みます。
  </Accordion>

  <Accordion title="プレビュー接続が機能しない">
    これは通常、接続されたサービスからプレビューリダイレクト URI が欠落していることを意味します。

    **プレビュー接続の問題を修正するには:**

    1. 接続されたサービスで OAuth アプリを開きます。
    2. リダイレクト URI、コールバック URL、または承認済みリダイレクト URI 設定に移動します。
    3. アプリのプレビューリダイレクト URI を追加します。
    4. OAuth アプリ設定を保存します。
    5. アプリのプレビューを開きます。
    6. アプリを使用する人としてサインインします。
    7. 再度接続を試みます。
  </Accordion>

  <Accordion title="無効な Client ID または Client Secret">
    これは通常、Client ID または Client Secret が欠落しているか、不正確であるか、間違った OAuth アプリからコピーされたことを意味します。

    **無効な Client ID または Client Secret を修正するには:**

    1. 接続されたサービスで OAuth アプリを開きます。
    2. **Client ID** を再度コピーします。
    3. **Client Secret** を再度コピーします。
    4. Base44 に戻ります。
    5. コネクタを編集します。
    6. 更新された値を貼り付けます。
    7. **Save Changes** をクリックします。
  </Accordion>

  <Accordion title="欠落または不正確なスコープ">
    これは通常、アプリが欠落、利用不可、または間違ったフォーマットで書かれた権限をリクエストしたことを意味します。

    **スコープエラーを修正するには:**

    1. 接続されたサービスの OAuth ドキュメントを確認します。
    2. アプリが必要とするスコープを確認します。
    3. サービスのドキュメントに表示されているとおりに正確にスコープをコピーします。
    4. Base44 で各スコープを別の行に追加します。
    5. コネクタを保存します。
    6. すでに接続している人に、アプリ内から再度アカウントを接続し、更新された権限を承認するよう依頼します。
  </Accordion>

  <Accordion title="OAuth アプリがまだテストモードにある">
    一部のサービスは、公開または検証するまで新しい OAuth アプリをテストモードに保ちます。テストユーザーとして追加されていない限り、人々は接続できない場合があります。

    **テストモードの問題を修正するには:**

    1. 接続されたサービスで OAuth アプリを開きます。
    2. アプリがテスト、開発、または未公開モードにあるかどうかを確認します。
    3. サービスが必要とする場合はテストユーザーを追加します。
    4. 必要に応じて OAuth アプリを公開または検証します。
    5. アプリから再度接続を試みます。
  </Accordion>
</AccordionGroup>

***

## よくある質問

<AccordionGroup>
  <Accordion title="ユーザーコネクタと共有コネクタの違いは何ですか?">
    ユーザーコネクタを使用すると、各人が自分のアカウントを接続できます。共有コネクタは、アプリ内の全員に対して 1 つのアカウントを使用します。
  </Accordion>

  <Accordion title="なぜ接続されたサービスで OAuth アプリを作成する必要があるのですか?">
    接続されたサービスは、どのアプリがアクセスをリクエストしているか知る必要があります。OAuth アプリは、接続に必要な Client ID、Client Secret、scopes、リダイレクト URI 設定を提供します。
  </Accordion>

  <Accordion title="Client ID と Client Secret はどこで見つけることができますか?">
    接続されたサービスで作成した OAuth アプリまたは開発者アプリで見つけることができます。正確な場所はサービスによって異なります。
  </Accordion>

  <Accordion title="scopes とは何ですか?">
    scopes は権限です。誰かがアカウントを接続した後にアプリが何にアクセスできるかを、接続されたサービスに伝えます。
  </Accordion>

  <Accordion title="どのリダイレクト URI を使用すべきですか?">
    接続したい環境のリダイレクト URI を使用します。ライブアプリの場合は、ライブアプリのコールバック URL を使用します。プレビューテストの場合は、プレビューコールバック URL を追加します。カスタムドメインの場合は、カスタムドメインのコールバック URL を追加します。
  </Accordion>

  <Accordion title="プレビューリダイレクト URI を追加する必要がありますか?">
    はい、プレビューでコネクタをテストしたい場合は。プレビューとライブアプリは異なるリダイレクト URI を使用します。
  </Accordion>

  <Accordion title="コネクタがすでにワークスペースで設定されている場合はどうなりますか?">
    コネクタがすでにワークスペースで設定されている場合、AI チャットはコネクタ詳細を再度入力するよう求めることなく、アプリで直接使用できます。
  </Accordion>

  <Accordion title="AI チャットがコネクタタイプの選択を求めるのはなぜですか?">
    一部のツールは 2 つの方法で接続できるため、AI チャットは追加したいタイプを確認する場合があります。

    * **Shared:** アプリ内の全員に対して 1 つのアカウントで機能を動かしたい場合は、これを選択します。
    * **Per-user:** 各人が自分のアカウントを接続する必要がある場合は、これを選択します。
  </Accordion>

  <Accordion title="同じタイプの複数のコネクタを追加できますか?">
    はい。さまざまな用途に対して、異なるスコープを持つ複数のコネクタを追加できます。
  </Accordion>

  <Accordion title="コネクタの scopes を変更するとどうなりますか?">
    すでにアカウントを接続している人は、アプリ内から再度アカウントを接続し、更新された権限を承認する必要があります。
  </Accordion>

  <Accordion title="コネクタの Client Secret をローテーションするとどうなりますか?">
    Base44 で Client Secret を更新しても、すでにアカウントを接続している人が自動的に切断されることはありません。接続されたサービスで以前の Client Secret を取り消すと、接続の更新が必要になったときに、アプリ内から再度アカウントを接続するよう促される場合があります。
  </Accordion>

  <Accordion title="誰かの接続されたアカウントが切断された場合はどうなりますか?">
    アプリ内から再度アカウントを接続する必要があります。接続オプションは、設定ページ、オンボーディングフロー、アカウントページ、またはコネクタを使用する機能など、アプリがそのコネクタをサポートするように構築された場所に表示されます。
  </Accordion>

  <Accordion title="人々はアカウントを切断できますか?">
    はい。人々はアプリ内からいつでも切断できます。
  </Accordion>

  <Accordion title="アプリユーザートークンは安全に保存されますか?">
    はい。Base44 は機密の認証情報とアクセストークンを暗号化し、自動的なトークンの更新を処理します。
  </Accordion>
</AccordionGroup>

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