Model Context Protocol을 사용해 AI 에이전트와 개발자 도구를 Lovable에 연결합니다. 앱을 프로그래밍 방식으로 빌드, 반복, 배포합니다.
Lovable MCP 서버
Model Context Protocol을 사용해 AI 에이전트와 개발자 도구를 Lovable에 연결합니다. 앱을 프로그래밍 방식으로 빌드, 반복, 배포합니다.
Lovable MCP 서버란?
Lovable은 자체를 https://mcp.lovable.dev에서 Model Context Protocol (MCP) 서버로 노출합니다. 이를 통해 지원되는 AI 클라이언트가 자연어로 Lovable 프로젝트를 관리할 수 있습니다.
연결되면 AI 에이전트가 프로젝트를 만들고, Lovable에 메시지를 보내고, 코드를 검사하고, 앱을 배포하는 등 이미 작업 중인 클라이언트를 떠나지 않고 모든 작업을 할 수 있습니다.
이는 Lovable 에이전트가 도구에 연결되도록 하는 채팅 커넥터(MCP 서버)와 다릅니다. Lovable MCP 서버는 외부 에이전트가 Lovable에 연결되게 합니다.
MCP란 무엇인가
MCP(Model Context Protocol)는 AI 에이전트가 외부 도구를 발견하고 호출할 수 있게 하는 오픈 표준입니다. 에이전트가 MCP 서버에 연결되면 어떤 도구를 사용할 수 있는지 보고 언제 사용할지 결정할 수 있습니다. Lovable의 MCP 서버는 Lovable을 그러한 도구 중 하나로 만듭니다: 찾을 수 있고, 호출 가능하고, 구성 가능합니다.
지원되는 AI 클라이언트
Lovable MCP 서버의 OAuth 흐름은 현재 다음 클라이언트로 제한됩니다:
- ChatGPT
- Claude (macOS와 Windows의 Claude Desktop, claude.ai)
- Claude Code
- Cursor
- VS Code
현재 다른 MCP 클라이언트는 OAuth 흐름을 완료할 수 없습니다. 이 페이지의 나머지에서는 이러한 지원되는 앱을 "클라이언트" 또는 "사용자의 클라이언트"로 지칭합니다.
흐름
- 에이전트가 Lovable MCP 서버에 연결됩니다
- 에이전트가 빌드할 내용에 대한 설명과 함께 도구(예:
create_project)를 호출합니다 - Lovable이 프로젝트를 빌드하고 미리보기 URL을 반환합니다.
- 미리보기를 열고, 빌드된 내용을 검토하고, 더 많은 메시지를 보내 계속 반복할 수 있습니다
- 사용자가 다듬을수록 에이전트가 계속 빌드하며 기능을 추가하고, 이슈를 수정하고, 디자인을 변경합니다
- 만족하면
deploy_project로 게시합니다. 또는 그렇지 않습니다 — 게시는 항상 선택 사항입니다.
누구를 위한 것인가
- AI 클라이언트나 에디터를 떠나지 않고 Lovable 프로젝트를 스핀업하고 반복하고 싶은 ChatGPT, Claude Code, Cursor, 또는 VS Code를 사용하는 개발자
- Lovable을 더 큰 에이전트 흐름의 한 단계로 원하는 팀: 콘텐츠 생성, UI 스캐폴딩, 배포, URL 핸드오프
Lovable MCP 서버를 사용하는 이유
- 에이전트 기반 개발: 클라이언트가 자연어를 사용해 Lovable 프로젝트를 스캐폴딩하고 반복하도록 합니다.
- 코드 검사: 프로젝트 파일을 읽고, 변경 사항을 diff하고, 편집 기록을 프로그래밍 방식으로 탐색합니다.
- 도구 간 워크플로: 단일 에이전트 세션에서 Lovable을 다른 MCP 연결 도구와 결합합니다.
일반적인 사용 사례
| 시나리오 | 에이전트에 대한 프롬프트 예시 | 결과 |
|---|---|---|
| 새 앱 스캐폴딩 | Create a Lovable project called 'Feedback Hub' with a form for collecting user feedback | 프로젝트가 생성되고 첫 빌드가 완료됨 |
| 기존 프로젝트 반복 | Add a dark mode toggle to my project [ID] | 에이전트가 메시지를 보내고 Lovable이 완료하기를 기다림 |
| 최근 변경 사항 검토 | Show me what changed in the last three edits to my project | 최근 커밋의 통합 diff |
| 앱 배포 | Deploy my project [ID] and give me the live URL | 프로젝트가 게시됨; 라이브 URL 반환 |
| 코드베이스 검사 | List all files in my project and read the main App.tsx | 파일 트리와 파일 콘텐츠 반환 |
| 여러 variant 비교 | Build 3 versions of a landing page for [product], each with a different layout and visual style. Deploy all three and give me the live URLs. | 비교를 위해 라이브 URL이 있는 세 개의 배포된 프로젝트 |
사전 준비 사항
- Pro 또는 Business 플랜의 Lovable 계정
- 설치된 지원되는 AI 클라이언트 중 하나
연결하기 전에
Lovable MCP 서버에 클라이언트를 연결하면 사용자와 동일한 계정 액세스를 갖습니다. 연결 전에 알아야 할 몇 가지 사항:
- 범위는 한 프로젝트가 아닌 전체 계정입니다. 연결한 모든 클라이언트는 Lovable에서 액세스할 수 있는 모든 프로젝트를 나열, 읽기, 편집할 수 있습니다.
- 호출은 계정에서 라이브로 실행됩니다. 도구 호출은 실제 크레딧을 사용하고 실제 프로젝트를 편집합니다.
deploy_project는 앱을 배포하고 라이브 URL을 반환합니다. Free와 Pro 플랜에서는 링크를 가진 누구나 앱에 접근할 수 있습니다. Business와 Enterprise 플랜에서는 웹사이트 액세스가 워크스페이스 기본값을 따릅니다. 내부 게시가 구성된 경우 URL이 워크스페이스 멤버로만 제한될 수 있습니다.query_database는 전체 데이터베이스 권한으로 SQL을 실행합니다. 읽기, 쓰기, 스키마 변경.
연결 방법
Lovable MCP 서버는 인증을 위해 OAuth를 사용합니다. 처음 연결할 때 클라이언트가 Lovable 계정으로 인증하기 위해 브라우저 창을 엽니다.
아래에서 클라이언트를 선택하세요.
사용 가능한 도구
Lovable MCP 서버는 다음 도구를 노출합니다. 모든 도구 호출은 사용된 OAuth 토큰에 대한 워크스페이스 범위입니다.
프로젝트 및 워크스페이스
| 도구 | 설명 |
|---|---|
get_me | 인증된 사용자의 프로필과 워크스페이스 가져오기 |
list_workspaces | 사용자가 속한 모든 워크스페이스 목록 |
get_workspace | 특정 워크스페이스의 세부 정보 가져오기 |
list_projects | 필터링과 전문 검색으로 워크스페이스의 프로젝트 검색 및 목록 |
get_project | 에디터 URL, 미리보기 URL, 스크린샷을 포함한 프로젝트 세부 정보 가져오기 |
create_project | 새 프로젝트 생성, 선택적으로 에이전트에 대한 초기 메시지 포함 |
deploy_project | 프로젝트 게시 및 라이브 URL 가져오기 |
remix_project | 기존 프로젝트를 워크스페이스로 복사. 소스 프로젝트는 워크스페이스에서 접근 가능해야 합니다(자체 워크스페이스 프로젝트, 템플릿, 라이브러리 프로젝트, 또는 공개 리믹스가 활성화된 프로젝트). |
set_project_visibility | 에디터의 프로젝트에 접근할 수 있는 사람 설정: private(Workspace, 모든 워크스페이스 멤버, 기본값) 또는 draft(Restricted, 생성자만, Business 또는 Enterprise 필요). 게시된 앱을 방문할 수 있는 사람이 아닌 에디터 접근만 제어. |
set_folder_visibility | 폴더를 개인 또는 워크스페이스 가시성으로 설정 |
list_template_projects | 사용 가능한 프로젝트 템플릿 목록 |
list_library_projects | 워크스페이스에 사용 가능한 디자인 시스템 라이브러리 프로젝트 목록 |
에이전트 상호 작용
| 도구 | 설명 |
|---|---|
send_message | 프로젝트의 AI 에이전트에게 채팅 메시지를 보내고 응답을 기다림. plan_mode(빌드 전 논의)와 files 첨부를 지원. wait=false를 전달하면 즉시 반환되고 대신 get_message로 폴링. |
get_message | wait=false로 send_message 후 메시지 완료 상태 폴링 |
코드 검사
| 도구 | 설명 |
|---|---|
get_diff | 메시지 또는 커밋 SHA에서 통합 diff 가져오기 |
list_files | 특정 git ref에서 프로젝트의 모든 파일 목록 |
read_file | 특정 git ref에서 단일 파일의 콘텐츠 읽기 |
list_edits | 페이지네이션과 함께 프로젝트의 편집 기록 목록 |
지식
| 도구 | 설명 |
|---|---|
get_workspace_knowledge | 워크스페이스의 커스텀 AI 지침 가져오기 |
set_workspace_knowledge | 워크스페이스의 커스텀 AI 지침 설정 |
get_project_knowledge | 프로젝트의 커스텀 AI 지침 가져오기 |
set_project_knowledge | 프로젝트의 커스텀 AI 지침 설정 |
Cloud 데이터베이스
| 도구 | 설명 |
|---|---|
get_database_status | Lovable Cloud가 프로젝트에 활성화되어 있는지 확인 |
enable_database | Lovable 프로젝트에서 Lovable Cloud 활성화(30-60초 소요) |
query_database | Lovable Cloud 프로젝트에서 SQL 쿼리 실행 |
get_database_connection_info | Lovable Cloud 프로젝트의 연결 문자열과 API URL 가져오기 |
연결된 MCP 서버
| 도구 | 설명 |
|---|---|
list_mcp_servers | 워크스페이스에 연결된 모든 MCP 서버 목록 |
list_mcp_catalog | 추가 가능한 추천 MCP 서버 템플릿 탐색 |
list_connectors | 사용 가능한 커넥터 통합 목록(standard, seamless, MCP) |
list_connections | 워크스페이스의 인증된 커넥터 계정 목록 |
add_mcp_server | 워크스페이스에 MCP 서버(카탈로그 또는 커스텀) 추가 |
remove_mcp_server | 워크스페이스에서 MCP 서버 제거 |
분석
| 도구 | 설명 |
|---|---|
get_project_analytics | 게시된 프로젝트의 과거 분석 가져오기: 방문자, 페이지뷰, bounce rate, 세션 기간, 페이지/소스/장치/국가별 분석. start_date와 end_date(RFC 3339) 필요. |
get_project_analytics_trend | 게시된 프로젝트의 실시간 방문자 수와 5분 트렌드 가져오기 |
파일 업로드
| 도구 | 설명 |
|---|---|
get_file_upload_url | 메시지 첨부로 사용할 파일을 업로드할 presigned URL 가져오기 |
스킬
스킬은 AI 클라이언트에게 Lovable MCP 서버를 효과적으로 사용하는 방법을 알려주는 재사용 가능한 지침 파일입니다: 트리거 시점, 도구 호출 순서, 따를 패턴. 클라이언트에 한 번 추가하면 추가 프롬프팅 없이 Lovable을 구동하는 방법을 알게 됩니다.