アプリで Supabase のデータベース、認証、ファイルストレージ、またはバックエンド関数を使用したい場合は、Atoms プロジェクトを Supabase に接続します。

このガイドでは、Supabase アカウントとプロジェクトの準備、正しい組織の認可、プロジェクトの接続、接続が機能したことの確認、必要に応じた切断まで、全体の流れを順を追って説明します。

接続の仕組み

各 Supabase プロジェクトは organization に属しており、その中のプロジェクトに誰がアクセスして管理できるかを制御します。Supabase を Atoms に接続する際は、まず使用したい組織へのアクセスを Atoms に認可し、その後その組織から接続するプロジェクトを選択します。

各 Atoms プロジェクトは、一度に 1 つの Supabase プロジェクト に接続できます。ただし、同じ Supabase プロジェクトを複数の Atoms プロジェクトに接続することは可能です。

Supabase と Atoms クラウドは代替のバックエンドオプションです。 同じ Atoms プロジェクトに両方を同時に接続することはできません。

始める前に

Supabase を接続する前に、次の点を確認してください。

• そのプロジェクトを含む Atoms ワークスペースの所有者 であること。Supabase を認可、接続、または切断できるのはワークスペース所有者のみです。
• Supabase アカウントを持っている、またはセットアップ中に作成する準備ができていること。
• Supabase の組織を認可し、接続したいプロジェクトにアクセスする権限があること。
• エージェント が現在のタスクを完了しており、レースモード がオフになっていること。
• 使用中のブラウザで Atoms からのポップアップウィンドウが許可されていること。
• その Atoms プロジェクトが まだ Atoms クラウドに接続されていない こと。

この接続を初めて試す場合は、手順を学ぶ間はテスト用プロジェクトを使うことをおすすめします。

Supabase のパスワード、API キー、アクセストークン、その他の認証情報を Chat に貼り付けないでください。

Supabase を接続

Supabase コネクタを開く

1. 接続したいプロジェクトを開きます。
2. チャットパネル右上のプロジェクト名をクリックします。
3. 表示されるドロップダウンメニューで Connectors を選択します。
4. 利用可能なコネクタの一覧で Supabase を見つけ、connect をクリックします。

また、Settings → Connectors → Supabase を開いて Connect を選択することもできます。

Settings → Connectors を開き、Supabase の Connect を選択します。

Supabase で Atoms を認可する

すでに Organizations に使用したい Supabase の組織が表示されている場合は、すでに認可されています。そのまま Supabase プロジェクトを選択する に進めます。

1. Atoms により Supabase の認可ウィンドウが開きます。接続したい Supabase アカウントにサインインするか、必要に応じて新しいアカウントを作成します。
2. 正しい Supabase アカウントにサインインしていることを確認し、Atoms にアクセスを許可したい組織を選択します。
3. Atoms が要求する権限を確認します。すべての権限を見るには、Show detailed permissions を選択します。同意する場合は、Authorize Atoms を選択します。
4. Atoms に戻り、Connect success メッセージが表示されるまで待ちます。
5. Atoms で Connectors → Supabase を開き、組織が Organizations の下に表示されていることを確認します。

Atoms は、データベース、Secrets、Auth、Edge Functions、Environment、Projects、PostgREST、Storage への読み取りおよび書き込みアクセスを要求します。また、Organizations と Domains への読み取りアクセスも要求します。これらの権限により、Atoms はプロジェクトで使用される対応済みの Supabase サービスを接続および管理できます。

この認可は、選択した Supabase の組織に適用され、後で現在の Atoms プロジェクトに接続する Supabase プロジェクトのみに限定されるものではありません。Atoms は、接続された Supabase アカウント自体がアクセスできない組織やプロジェクトにはアクセスできず、Supabase の権限によって追加の制限が課される場合があります。

Atoms を認可する前に、組織と権限を確認します。

Supabase プロジェクトを選択する

1. Organizations の下で、認可した組織を展開します。
2. Projects の下で、接続したい有効な Supabase プロジェクトを見つけます。
3. 必要な組織が一覧にない場合は、New Organization を選択して認可します。これは新しい Supabase 組織を作成するものではなく、Supabase アカウント内にすでに存在する別の組織を認可できるようにするものです。
4. まだプロジェクトがない場合は、Create Project を選択して Supabase で作成します。プロジェクトが有効になって使用可能になるまで待ち、その後 Atoms に戻って Update を選択し、プロジェクト一覧を更新します。
5. 使用したいプロジェクトの横にある Connect を選択します。

認可済みの組織から Supabase プロジェクトを選択します。

プロジェクトを確認する

1. 確認ウィンドウで、Supabase Project の下に表示される組織とプロジェクトを確認します。
2. 必要に応じて、Supabase Dashboard または View Tables を使って、正しいプロジェクトを選択したことを確認します。
3. Connect を選択します。
4. Atoms はプロジェクト Chat に Supabase 接続項目を追加します。ページを開いたままにし、完了するまで待ってから、データベース、認証、ストレージ、またはバックエンド機能の構築をエージェントに依頼してください。

接続する前に、選択した Supabase プロジェクトを確認します。

接続が機能したことを確認する

1. Settings → Connectors → Supabase を開きます。
2. 正しい組織と Supabase プロジェクトが接続済みとして表示されていることを確認します。
3. Dashboard または Tables を選択し、Supabase で同じプロジェクトが開くことを確認します。

接続済みプロジェクトのパネルには、Manage Users、SQL Editor、Edge Functions、Manage Secrets へのリンクが含まれる場合もあります。使用する必要があるのは、構築中の機能に関連する領域だけです。

接続済みの Supabase プロジェクトとその管理リンクを確認します。

アプリがデータを保存できることをテストする

Supabase を接続しただけでは、アプリにデータベース機能は自動では追加されません。Chat で、必要な機能を構築し、接続済みの Supabase プロジェクトを使ってそのデータを保存するよう エージェント に依頼してください。エージェントが完了したら、一連の流れ全体をテストします。

1. Chat で、必要な機能、その機能が保存すべき情報、そしてユーザーがその情報を再びどこで見るべきかを説明します。接続済みの Supabase プロジェクトを使うよう エージェント に伝えてください。
2. エージェント が機能の構築を完了するまで待ちます。
3. App ビューアー で、ユーザーと同じようにその機能を使い、無害なテストデータを入力します。個人情報、機密情報、またはセンシティブな情報は使用しないでください。
4. App ビューアー を更新するか、その機能を再度開きます。保存した情報が残っており、正しい場所に表示されることを確認します。
5. Settings → Connectors → Supabase を開き、Tables を選択して、対応するレコードが正しいテーブルに表示されることを確認します。

その機能でユーザーが保存済み情報を編集または削除できる場合は、それらの操作もテストし、アプリと Supabase の両方で結果が正しいことを確認してください。Supabase で直接行った変更がアプリにすぐ反映されるかどうかは、アプリの構築方法によって異なります。

Supabase を切断する

現在の Atoms プロジェクトで接続済みの Supabase プロジェクトを使わなくなった場合は、Supabase を切断します。

1. Settings → Connectors → Supabase を開きます。
2. 正しい Atoms プロジェクトの接続を表示していることを確認します。
3. Disconnect Project を選択します。
4. Chat 内の Supabase 切断項目が完了するまで待ちます。
5. Connectors → Supabase を再度開き、プロジェクトが接続済みとして表示されなくなったことを確認します。

切断すると、現在の Atoms プロジェクトから接続が削除されます。これは Supabase プロジェクトやそのデータを削除するものではなく、Supabase の組織に対する認可も削除しません。

Atoms プロジェクト内で Supabase に依存している機能は、切断後に動作しなくなる可能性があります。アプリがすでに公開されている場合は、変更を反映させる前に公開済みバージョンを更新する必要があることがあります。切断後は、プロジェクトと公開中のアプリの両方をテストしてください。

ある Atoms プロジェクトから Supabase を切断しても、同じ Supabase プロジェクトに接続されている他の Atoms プロジェクトには影響しません。

FAQ

Supabase 接続が動作しなくなったのはなぜですか？

1. Supabase Dashboard を開き、影響を受けているプロジェクトのステータスを確認します。アクティビティの低いフリープランのプロジェクトは、7 日間の期間後に一時停止される場合があります。
2. 一時停止されている場合は、Resume project を選択し、Supabase が有効と表示するまで待ちます。
3. Atoms に戻り、プロジェクトの Connectors パネルを開いて、Supabase 接続を確認します。失敗した操作を 1 回再試行してください。
4. Supabase がすでに有効な場合は、Atoms または Supabase の正確なエラーを記録し、接続が切断済みまたは期限切れとして表示されていないか確認します。再接続は、そのステータスが必要であることを示している場合にのみ行ってください。

原因がわかり、既存データを保護するまでは、キーをローテーションしたり代替プロジェクトを作成したりしないでください。問題が続く場合は、Chat Link、時刻とタイムゾーン、接続ステータス、機密情報を除去したエラーのスクリーンショットを添えてサポートに連絡してください。

外部参照: Supabase — Project Pausing

一時停止された Supabase プロジェクトを再接続するにはどうすればよいですか？

1. 正しい Supabase の組織にサインインし、一時停止されたプロジェクトを開きます。
2. Resume project を選択し、そのステータスが有効になるまで待ちます。現在の Supabase の案内では、アクティビティの低いフリープランのプロジェクトは 7 日間の低アクティビティ期間後に一時停止される場合があります。
3. Atoms に戻ってプロジェクトの Connectors パネルを開きます。Supabase が接続されていることを確認し、影響を受けた操作を再試行します。
4. それでも Atoms でコネクタが切断済みまたは期限切れと表示される場合は、再接続して要求された認可を完了してください。

既存データが保護されるまでは、新しい Supabase プロジェクトを作成したり認証情報をローテーションしたりしないでください。再接続に失敗する場合は、Chat Link、Supabase プロジェクトのステータス、時刻とタイムゾーン、機密情報を除去したエラーのスクリーンショットをサポートに提供してください。

外部参照: Supabase — Project Pausing