Supabase 連携

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

接続の仕組み

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

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

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

開始前に

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

• プロジェクトを含む Atoms ワークスペースの オーナー であること。Supabase の認可、接続、切断を行えるのはワークスペースオーナーのみです。
• Supabase アカウントを持っている、またはセットアップ中に作成する準備ができていること。
• 認可する Supabase organization と、接続したいプロジェクトにアクセスする権限があること。
• エージェント が現在のタスクを完了しており、レースモード がオフになっていること。
• ブラウザで 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 organization がすでに表示されている場合は、すでに認可されています。そのまま Supabase プロジェクトを選択する に進めます。

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

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

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

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

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

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

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

プロジェクトを確認する

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

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

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

1. Settings → Connectors → Supabase を開きます。
2. 正しい organization と 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 organization の認可も削除しません。

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

1 つの 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、時刻とタイムゾーン、接続ステータス、および機密情報を除去したエラーのスクリーンショットを添えてサポートに連絡してください。

External reference: Supabase — Project Pausing

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

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

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

External reference: Supabase — Project Pausing