3行でいうと

  • Lovableには、公式のMCPサーバー(https://mcp.lovable.dev)があります。認証はOAuthだけで、APIキーは使えません。Claude、Claude Code、ChatGPT、Cursor、VS Code、Codex CLIなどからつなげます。
  • つなぐと、そのAIは、あなたのアカウントの権限で、実際にプロジェクトを作り、直し、公開し、データベースにSQLを流せます。create_project と send_message はクレジットを使います。
  • 設定の書き方は、公式のドキュメントとGitHubのREADMEで、クライアントによって違いがあります(表にまとめます)。
  • 外し方は、ドキュメントに「接続の取り消し」の方法が書かれていません。公式が書くのは、クライアント側の設定から消す方法と、Enterpriseでの無効化だけです。
  • SlackとChatGPTのアプリは、MCPとは別の入口です。LovableのAPI(キーはBusiness以上)も別にあります。

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

画面の表記は変わります。公式ページの表記を使っているので、手元の画面と照らして読んでください。設定ファイルの中身は、要約の形で取得した公式ページと、GitHubのREADMEから書き写しています。システムに接続の設定を登録する操作なので、登録の前に、公式ページの原文と見比べてください。「この記事の案」と書いた部分は、公式の手順ではなく、この記事で組んだ使い方の例です(動作は確かめていません)。

先に結論

前提:用語をそろえる

たとえ話:事務所の窓口に、別の会社の担当者が来る

Lovableを設計事務所だとします。MCPサーバーは窓口で、ほかの会社の担当者(ClaudeやChatGPT)が、あなたの名義で注文に来ます。担当者は、あなたの権限のまま、図面を書かせたり、できあがりを公開させたりできます。これは僕らのたとえで、公式の表現ではありません。

1. 始める前に

公式の「Lovable MCP server」の前提です。

  1. Lovableのアカウント(どのプランでもよい)。
  2. ワークスペースで、サードパーティのMCPクライアントのアクセスが有効なこと。FreeとProとBusinessでは既定でオン、Enterpriseでは既定でオフと書かれています。
  3. MCPクライアントがインストールされていること。

Enterpriseでは、管理者が Workspace settings → Security → Privacy & security の Third-party MCP clients を有効にします。

2. クライアントごとの設定

2-1. Claude(claude.ai、Claude Desktop)

公式のドキュメントの手順です。

  1. Claudeで + を押す。
  2. Connectors → Browse Connectors を開き、Lovable を探す。
  3. Connect を押し、求められたらLovableにログインする。

認証のあと、Lovableのツールが、入力欄のツールのメニューに出る、と書かれています。

2-2. Claude Code

公式のドキュメントのコマンドです。

claude mcp add --transport http lovable "https://mcp.lovable.dev"

別の方法として、ドキュメントはプラグインのインストールも書いています。スラッシュコマンドも付く、とあります。

/plugin install lovable@claude-plugins-official

2-3. Claude Desktop(設定ファイル)

設定ファイルの場所(公式の記載):

OS 場所
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Windows %APPDATA%\Claude\claude_desktop_config.json

公式の記載にもとづく形(キーと値は公式のとおり。波かっこの並びなど体裁は、原文で確かめてください):

{
  "mcpServers": {
    "lovable": {
      "type": "http",
      "url": "https://mcp.lovable.dev"
    }
  }
}

mcpServers がすでにあるときは、2つ目のブロックを貼らず、その中に "lovable" の項目を足す、と書かれています。保存後、Claude Desktopを再起動します。

2-4. ChatGPT

公式のドキュメントでは、ChatGPTに次のURLを追加します。

https://mcp.lovable.dev

追加すると、ChatGPTがOAuthの認証を求めます。ChatGPTの中で、どの画面からURLを追加するかは、読んだLovableのページには書かれていません。ChatGPT側の公式の手順を見てください。READMEは「クライアントIDは不要」と書いています。

2-5. Cursor

Cursorには、Lovableのプラグインがあり、案内つきの設定と、スラッシュコマンド(/lovable-new、/lovable-iterate、/lovable-db、/lovable-deploy)を提供する、と書かれています。手動で設定する場合の、公式の記載にもとづく形です(キーと値は、ドキュメントとREADMEの両方で同じことを確かめました。体裁は原文で確かめてください)。置き場所は、全体用の ~/.cursor/mcp.json、またはプロジェクト直下の .cursor/mcp.json です。

{
  "mcpServers": {
    "lovable": {
      "type": "http",
      "url": "https://mcp.lovable.dev",
      "auth": {
        "CLIENT_ID": "6d465f583e1e4ce5801b1616f735670c"
      }
    }
  }
}

保存後、Cursorのウィンドウを再読み込みします。mcpServers がすでにあるときは、その中に足します。

2-6. VS Code

ドキュメントの記載にもとづく形は、次です(キーと値は公式のとおり。体裁は原文で確かめてください)。VS CodeのMCP設定、またはMCPの設定ファイルに書きます。VS Codeは、ブラウザでOAuthの認証を求める、とあります。

{
  "servers": {
    "lovable": {
      "type": "http",
      "url": "https://mcp.lovable.dev"
    }
  }
}

READMEのVS Codeの例には、"auth": { "CLIENT_ID": "…" } の項目が付いています(Cursorの例と同じ値)。ドキュメントとREADMEで書き方が違うので、どちらかに決めず、両方を併記します。つながらないときの確認点は、下の「うまくいかないとき」を見てください。

2-7. Windsurf

READMEに、Windsurfの mcp_config.json に、Cursorと同じ形の設定を書く、とあります。ドキュメントのページには、Windsurfの記載がありません。

2-8. Codex CLI

READMEのコマンドです。

codex mcp add lovable --url https://mcp.lovable.dev
codex mcp login lovable

2-9. そのほかのクライアント

2-10. ドキュメントとREADMEの違い(早見)

クライアント ドキュメント(docs.lovable.dev) README(GitHub)
ChatGPT URLを追加 URLを追加。クライアントIDは不要
Claude、Claude Code コネクタ、claude mcp add claude mcp add(Claude Desktopは設定ファイル)
Cursor auth.CLIENT_ID あり 同じ。Windsurfも同じ形
VS Code auth なしの例 auth.CLIENT_ID ありの例
Codex CLI 読んだ範囲では記載なし codex mcp add と codex mcp login

READMEの認証の節は、ClaudeとClaude CodeとChatGPTはURLだけでよく、ほかのクライアントは公開のクライアントIDも渡す、と書いています。認証は OAuth 2.1 で、認可サーバーは https://mcp.lovable.dev/.well-known/oauth-protected-resource のメタデータから見つけます。クライアントは、トークンを Authorization: Bearer <token> で送ります。READMEは、トランスポートを Streamable HTTP と書き、ライセンスを Apache License 2.0 と書いています。

3. 使えるツール(公式のドキュメント)

区分 ツール 内容
本人とワークスペース get_me、list_workspaces、get_workspace プロフィール、ワークスペース、プランとクレジット残高、メンバー数、設定
プロジェクト list_projects、get_project、create_project、deploy_project、remix_project、set_project_visibility、set_folder_visibility、move_projects_to_folder、list_template_projects、list_design_systems 検索、取得、作成、公開、複製、編集の見え方の設定、フォルダ、テンプレート
エージェント send_message、get_message、list_messages プロジェクトのエージェントにメッセージを送り、返事を待つ。plan_mode、files、wait=false(あとで確かめる)に対応
Knowledge、Skills get_workspace_knowledge、set_workspace_knowledge、get_project_knowledge、set_project_knowledge、list_workspace_skills、get_workspace_skill、create_workspace_skill など 読み書き。set_ は全部置き換え。Skillの作成、更新、削除は、管理者とオーナーだけ
コードの確認 get_diff、list_files、read_file、list_edits 差分、ファイル一覧、1ファイルの読み取り、編集履歴
データベース get_database_status、enable_database、query_database 組み込みのデータベースが対象。Supabaseにつないだプロジェクトは、Supabase側で管理
コネクタ list_connectors、list_connections、list_custom_connectors、list_available_connectors、add_connector、remove_connector 一覧、削除。add_connector は、LovableのダッシュボードのURLを返すだけで、プログラムからは追加されない
分析 get_project_analytics、get_project_analytics_trend 公開したプロジェクトの訪問の履歴とリアルタイム
ファイル get_file_upload_url メッセージ添付用の署名つきURL
クライアント別 render_project_widget、import-claude-design-from-url 進み具合のウィジェット(ChatGPTなど)、Claudeのデザインの取り込み(Claudeのクライアントだけ)

4. 渡るデータと、権限

何が渡るか

権限

特に注意(公式の記載)

5. 外し方(公式に書かれている範囲)

公式のドキュメントには、クライアントのアクセスを取り消す方法の記載が見つかりません。書かれているのは次のとおりです。

方法 内容
クライアントの設定から消す クライアントのコネクタまたはMCPの設定から、Lovableの項目を消す。つなぎ直すと、OAuthがもう一度走る
Enterpriseでの無効化 Privacy & security の Third-party MCP clients を無効にする
remove_connector ワークスペースのMCPコネクタを消す。これは「Lovableが読む外のコネクタ」の削除で、クライアントのアクセスの取り消しではない

取り消しの手順として、サポートへの連絡が書かれているかは、確認できていません。サポートへの連絡が出てくるのは、ホスト型のクライアントで、コールバックの承認が通らないときです(提供元からLovableのサポートに連絡してもらうか、自分で連絡する、と書かれています)。6節の Manage access のショートカットは、Third-party MCP clients の設定へのものです。

6. 管理の画面

7. うまくいかないとき

症状 公式の資料から読める確認点
ツールが出ない tools/list で確かめる。OAuthの接続は、クライアントのLovableの項目を消して、入れ直す。設定ファイルの場合は、JSONが正しいか、既存の mcpServers の中に項目があるかを確かめ、クライアントを再起動
401、トークンの期限切れ クライアントのログインの手順をやり直す(README)
OAuthが終わらない、ぐるぐる回る クライアントが auth.CLIENT_ID を渡しているか確かめる(README)
"Transport not supported" クライアントが Streamable HTTP に対応している必要がある(README)
ワークスペースが見つからない、workspace_id がない list_workspaces を先に呼ぶ。create_project が WAITING を返すときは、複数のワークスペースが該当するので、workspace_id を付けて呼び直す
プロジェクトが見つからない ワークスペースIDを付けて list_projects
データベースがない enable_database を呼び、30〜60秒待って、もう一度
対応していないPostgreSQLの拡張 query_database は、対応しない CREATE EXTENSION を断る。その文を外して、ふつうのSQLで
SQLの結果が空 先に information_schema.tables で、テーブルがあるか確かめる
公開が断られる(security_critical_findings) プロジェクトのSecurityビューで、finding_refs の指摘を直すか、意図して無視してから、もう一度公開
ログインを何度も求められる(SSO) セッションが切れると、サーバーは 401 と invalid_token を返す。MCPに合うクライアントは、OAuthを自動でやり直す

8. この記事の案:AI同士の組み合わせ

以下は、公式のツール一覧から、この記事で組んだ使い方の例です(動作は確かめていません)。

案A:Claude Codeで、プロジェクトの下見をする(クレジットを使わない範囲)

  1. 2-2 のコマンドで接続し、ブラウザでログインする。
  2. Claude Codeに、次を頼む。

text 【この記事の例】 Lovableのワークスペースを一覧し、"古本屋" で始まる名前のプロジェクトを探してください。 見つかったら、ファイルの一覧と、トップページのファイルの中身を読んで、構成を説明してください。 何も変更しないでください。 3. 使われるのは list_workspaces、list_projects、list_files、read_file などで、公式の記載では、create_project と send_message 以外は無料です。

案B:Claude Codeから、Lovableのエージェントに変更を頼む

  1. 公式の手順で接続する。
  2. 変更の依頼を send_message で送る。plan_mode を使うと、計画だけを書かせることができる、とツールの説明にあります。
  3. クレジットを使い、実際のプロジェクトが変わります。公開(deploy_project)は、頼む前に、Website access の設定を確かめます。

案C:ChatGPTで下書きし、Lovableに渡す

後述の「ChatGPTのアプリ」と、MCPの2通りがあります。MCPなら、ChatGPTで create_project を使うと、会話の文脈から、最初のプロジェクトを作らせる形になります。続きの編集は、MCPなら send_message でも頼めます。

9. ChatGPTのLovableアプリ(@Lovable)

MCPとは別の入口です。公式の「Lovable ChatGPT app」の流れです。

  1. chatgpt.com にログインし、作りたいもの(目的、対象、主な画面、主な機能)を書く。
  2. @Lovable を呼んで、作るよう頼む(公式の例は「@Lovable Turn this into a real working website.」の趣旨)。
  3. 初回は、ChatGPTが、Lovableのアプリへの接続を求める。会話の文脈を使って、ビルドを始めるため、と書かれています。
  4. 最初のプロジェクトが、会話から作られる。続きの編集、カスタマイズ、公開は、Lovableで行います。

  5. クレジット:相談と @Lovable の呼び出しでは、使いません。Lovableにプロンプトを送り、ビルドが始まってから、使われます。

  6. 制限:初期のリリースでは、ChatGPTの中で続きを編集することはできません。
  7. ページに書かれていないこと:ChatGPTの設定でアプリを追加・有効にする方法、OAuthの画面、使用量の上限、接続の外し方。ChatGPT側とLovableの資料で確かめてください。

10. Slackで @Lovable を使う

設定(公式の「Chat with Lovable in Slack」)

誰が: Lovable側は、ワークスペースのオーナーか管理者。Slack側は、Slackの管理者、またはアプリのインストールが許された人。

方法1:Lovableから

  1. Lovableで Workspace settings → Slack(または Account settings → Devices & apps の Slack のカードの Set up)を開く。
  2. Lovableが、Slackで何にアクセスし、返事がどこに出るかの、確認の欄にチェックを入れる。
  3. Connect Slack を押し、Slackの窓で許可する。
  4. 求められる権限を承認する。Slackの管理者の承認が、先に要ることもあります。
  5. Connected Slack workspaces に、自分のSlackのワークスペースが出ることを確かめる。

方法2:Slack Marketplaceから

  1. Lovableの掲載ページで Add to Slack を押し、Slackのワークスペースに許可する。
  2. Lovableから届くダイレクトメッセージを開く。リンクは7日間有効で、アプリを入れ直すと新しいリンクが届きます。
  3. ログインまたは登録し、つなぐLovableのワークスペースを選ぶ(そのオーナーか管理者であること)。

つなぎ終えるまで、LovableはSlackで応答しません。Lovableの1ワークスペースにつなげるSlackのワークスペースは1つで、その逆も同じです。

使い方

求める権限(Slackのスコープ、公式の表)

区分 目的
メッセージとメンション(app_mentions:read、*:history) 依頼を見つけ、そのやりとりを読む
チャンネルと人(channels:read、users:read、users:read.email など) チャンネルの一覧、名前の表示、メールによる照合
送信(chat:write、chat:write.public、im:write、assistant:write) スレッド、DM、アシスタントの画面への返信
ファイル(files:read、files:write) 添付の読み取り、生成したファイルのアップロード
リアクションと絵文字(reactions:read、reactions:write、emoji:read) 読み取りと追加
ピンとブックマーク(pins:read、bookmarks:read) 必要なときの参照
公開の検索(search:read.public) 必要なときに、公開チャンネルを検索
リンクのプレビュー(links:read、links:write) lovable.app のリンクのプレビュー

読めるもの、読めないもの

プランとクレジット

外し方

  1. オーナーか管理者が、Workspace settings → Slack を開く。
  2. Connected Slack workspaces で、該当のSlackの隣の Disconnect を押し、Disconnect Slack workspace で確定する。
  3. または、Slackのアプリ管理の設定から、Lovableのアプリを消す。

どちらも、Lovableが、インストールのデータを消す、と書かれています。Lovableのプロジェクトは影響を受けません。

再認可

2026年8月24日より前につないだワークスペースでは、リアクション、メッセージ検索、ピン、ブックマーク、カスタム絵文字、ファイルのアップロードが動かないことがある、と書かれています。オーナーか管理者が、Slackを切って、つなぎ直し、新しい権限を承認します。

11. Lovable API(Business以上のAPIキー)

MCPとは別の、REST APIです。公式の「Lovable API」と「API keys」から。

項目 公式の記載
できること プロジェクトの一覧、取得、設定の更新、削除。公開と取り下げ、公開の状態、公開の設定。1時間有効の、ビルド済みプレビューの埋め込みURL。ワークスペース、メンバー、グループ。分析。セキュリティのスキャンと洞察
費用 API単体の料金はなし。現在のエンドポイントは、AIのビルド用クレジットを使わない
APIキー BusinessまたはEnterpriseで、オーナーか管理者。場所は Workspace settings → API keys & OAuth → Workspace access tokens → New API key
OAuthクライアント どのプランでも、オーナーと管理者が登録できる。場所は Workspace settings → API keys & OAuth → OAuth clients。機密性の高い範囲はBusiness以上

APIキーを作る(公式の手順)

  1. Name:あとで分かる名前をつける。
  2. Credit limit(任意):そのキーが、暦月ごとに使えるAIのビルド用クレジットの上限。毎月1日のUTC 0時に戻る。
  3. Expiration:7、30、60、90、180日、1年、または Never。
  4. Access:Projects と Workspace のそれぞれに、None、Read、Read & write。少なくとも1つは付ける。プリセットは Read only と Full access。
  5. IP allowlist(任意):IPアドレスまたはCIDRの範囲を、CSVで入れる。
  6. Create API key を押し、値をコピーする。秘密の値は、一度しか表示されません。

使い方(公式の例)

リクエストごとに、Lovable-API-Key と Lovable-Version のヘッダーを付けます。

curl https://api.lovable.dev/v1/workspaces \
  -H "Lovable-API-Key: lov_YOUR_KEY" \
  -H "Lovable-Version: 2026-09-11" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json"

成功すると、キーのワークスペースが返る、と書かれています。lov_YOUR_KEY は、自分のキーに置き換えます。

管理と注意

気をつけること

出典