3行でいうと

  • GitHub同期は、新しいプライベートリポジトリを作って、双方向に同期します。既存のリポジトリにはつなげない、と公式に書かれています。
  • LovableのGitHub Appが求める権限(Contents、Administration などのWrite)は、公式のページに表があります。GitHubの承認の画面で、原文と見比べてください。
  • 外し方は、プロジェクトからの切断、ワークスペースからのリンク解除、接続そのものの削除の3段で、公式に手順があります。切っても、GitHubのリポジトリは残ります。
  • Supabaseは、Lovable内蔵のバックエンドの代わりに、自分のSupabaseプロジェクトを使う連携です。まずSupabaseの組織を1回つなぎ(オーナー・管理者)、次にプロジェクトを選びます。外し方は More → Supabase の Disconnect です。

この記事は、公式の資料を2026年10月25日に読んでまとめたものです。この記事は、実際に使って確かめた記録ではありません。

画面の表記は変わります。公式ページの表記を使っているので、手元の画面と照らして読んでください。GitHubへのアプリの許可のように、外のシステムに権限を登録する操作は、登録の前に、公式ページの原文を見てください。「この記事の案」は、公式の手順ではなく、この記事で組んだ例です(動作は確かめていません)。

先に結論

前提:用語をそろえる

たとえ話:事務所から外への、いくつもの通路

Lovableの事務所から、図面の写しを置く倉庫(GitHub)、材料を置く資材置き場(Supabase)、取引先への電話(コネクタ)、パソコン上の道具(ローカルMCP)へ、それぞれ別の通路がつながるイメージです。通路ごとに、通せるものと、鍵の持ち主が違います。これは僕らのたとえで、公式の表現ではありません。

1. GitHubとコードを同期する

構造

公式の「GitHub」のページでは、2段になっています。

  1. ワークスペースの接続:GitHubのアカウントまたは組織に、Lovableの許可を与える。
  2. プロジェクトとリポジトリのリンク:Lovableの1プロジェクトを、1つのリポジトリにつなぐ。

手順1:ワークスペースの接続を作る(オーナーと管理者)

場所: Workspace settings → Git → GitHub → Add connection。または、まだつないでいないプロジェクトの Project settings → Git → GitHub → Add connection。すでに入っているインストールを再利用するときは、そのアカウントか組織の横の Connect。

github.com(全プラン)の場合:

  1. Add account を押す(Enterpriseは、3つの選択肢から github.com)。
  2. GitHubのポップアップで、アカウントか組織を選ぶ。
  3. All repositories か Only select repositories を選ぶ。
  4. Install & Authorize を押す。Lovableが、インストールを検知し、再利用できる接続として保存します。

GitHub Enterprise Cloud(データ居住地)とGitHub Enterprise Serverは、Enterpriseプランです。手順(インスタンスURLの入力、IP許可リストの追加、GitHub Appの作成など)は、公式のページに書かれています。Enterprise Serverのアプリの秘密鍵は、Lovable側で暗号化して保存され、手で扱う必要はない、とあります。この記事では、細部は写しません。

Lovable GitHub Appが求める権限(公式の記載)

項目 権限
Contents Write
Metadata Read
Pull requests Write
Workflows Write
Administration Write

購読するイベントは、push、pull_request、repository、delete です。GitHubの画面で承認するときは、この表を、公式ページの原文と見比べてください。

手順2:プロジェクトをリポジトリにつなぐ(ワークスペースかプロジェクトのオーナー・管理者)

  1. Project settings → Git → GitHub を開く。またはチャット欄の横の + → Project → GitHub。
  2. Accounts の下で、リポジトリを作りたい接続の横の Connect を押す。
  3. Lovableが新しいプライベートリポジトリを作り、双方向の同期を自動で始めます。

1つのプロジェクトは、1つのプロバイダーの1つのリポジトリにだけリンクできます。

手順3:同期の様子を見る

接続したプロジェクトのGitHub設定に、次が出ます。

ブランチ

何が同期されるか

外し方

うまくいかないとき

症状 公式の確認点
アプリが停止、アンインストール、リポジトリへのアクセスを失った プロジェクトのGitHub設定で Reconnect を押し、GitHub側でアクセスを直す。公式の表は、停止ならGitHubで停止を解除、アンインストールなら再インストールして各プロジェクトを再接続(新しいリポジトリが作られる)、アクセス喪失ならGitHubのインストールの設定でアクセスを戻す、と分けて書いています
GitHubのコミットがLovableに出ない 同期するのは今のブランチだけ。コミットのあるブランチに切り替える。または同期中のブランチに新しいコミット(空でもよい)をpushする。Reconnect と Re-check は、欠けたコミットを取り込まない
同期中のブランチを消した Lovableが自動で lovable-fallback ブランチへ切り替える
pushが拒否された Lovableが lovable-sync ブランチへpushする。いつもの手順で見直して、マージする
大きなファイル GitHubは100 MBを超えるファイルを拒否する。設定に「Your project contains files that exceed the maximum file size limit (100 MB)」と出る。一覧のファイルを消して、同期の再試行を待つ

制限(公式の記載)

この記事の案:GitHubを経由して、別のAIでコードを触る

公式は、GitHubのリポジトリを、HTTPS、SSH、GitHub CLIでクローンできると書いています。そのうえで、今のブランチへのpushはLovableへ戻る、と書いています。この2つを合わせると、ローカルのCursorやClaude Codeなど、別のツールで、クローンしたコードを編集して、同期中のブランチにpushする、という使い方ができるはずです(これは、僕らの見立てで、公式の手順ではありません)。そのとき、公式が書く次の注意があります(03)。同期したブランチでは、強制push、リベース、スカッシュをしないこと。

2. 自分のSupabaseにつなぐ

構造

Lovable内蔵のバックエンドの代わりに、自分のSupabaseプロジェクトを、アプリのバックエンドにします。全プランで使えます。

手順1:Supabaseの組織をつなぐ(ワークスペースのオーナー・管理者、組織ごとに1回)

次のどれかから始めます。

Supabaseの窓が開き、ログインして、選んだ組織にLovableを許可します。組織が Linked Supabase organizations に出ます。ワークスペースの全メンバーが使え、各自のSupabaseアカウントは要らない、と書かれています。

手順2:プロジェクトをSupabaseのプロジェクトにつなぐ(編集権限のある人)

Lovableに、Supabaseのプロジェクトを作らせる場合

次の3つがすべて必要、と書かれています:ワークスペースで組み込みのバックエンドが無効、Supabaseの組織がつながっている、プロジェクトにまだバックエンドがない。Buildモードで、バックエンドを足すよう頼み、承認のカードで、Supabaseの組織と地域を選んで Create project を押します。地域はあとで変えられません。Lovableは、自分が作ったSupabaseのプロジェクトを、失敗のあとでも、消しません。

権限(公式)

誰 できること
オーナー・管理者 組織のリンクと再接続
エディター リンク済みの組織のプロジェクトを接続
ビューアー 接続できない

Lovableは、スキーマのマイグレーション、データの挿入・変更、ストレージのバケットの作成・変更の前に、承認を求めます。読み取りだけのデバッグは、何も変えません。

渡るデータと、できること

外し方

  1. More → Supabase を開く。
  2. Disconnect を押す。
  3. Disconnect Supabase のダイアログで確定する。

Lovableは、エッジ関数のデプロイと、スキーマの読み取りをやめます。コードとSupabaseのプロジェクトは変わらず、あとでつなぎ直せます。

制限と、うまくいかないとき

症状 公式の確認点
「Supabase connection issue」 プロジェクトの削除や、アクセスの変更の可能性。Disconnect または Manage organizations
Connect が押せない プロジェクトの一時停止、準備中の可能性。Supabaseで状態を確かめる
Add Organization が押せない ワークスペースのオーナーか管理者に、リンクを頼む

気をつけること

出典