Cursor로 디렉터리에 SaaS 출시하기

Cursor에 필요한 것

클론한 저장소를 워크스페이스로

구매 후 비공개 저장소를 Cursor에서 여세요. 에이전트는 워크스페이스에서 AGENTS.md와 플레이북을 읽고, 나는 에이전트가 작업하는 동안 product.json과 submissions.json을 에디터에 열어 둡니다.

Python 3.10+와 Node.js LTS

Python은 Cursor의 통합 터미널에서 워크스페이스 스크립트, record.py, 대시보드를 실행합니다. Node.js는 브라우저 서버용 npx를 제공합니다.

전역 ~/.cursor/mcp.json

Cursor는 모든 프로젝트용 ~/.cursor/mcp.json이나 한 프로젝트용 .cursor/mcp.json에서 MCP 서버를 읽습니다. 전역 파일을 쓰면 배포용 저장소를 받은 그대로 유지할 수 있습니다.

도구 승인은 켜 둔 채로

Cursor는 기본적으로 MCP 도구 호출마다 먼저 묻습니다. 양식 제출을 위해 그대로 두세요. authorizations.json이 그 위에 LaunchRepo의 제품 단위 규칙을 더합니다.

Cursor를 내 Chrome에 연결하기

Cursor의 에이전트는 내가 경로를 추가하기 전까지 로그인된 내 Chrome에 들어갈 방법이 없습니다. LaunchRepo가 지원하는 경로는 원격 디버깅을 통한 Chrome DevTools MCP입니다. Chrome 144 이상, chrome://inspect/#remote-debugging에서 켠 원격 디버깅, 그리고 서버의 --autoConnect가 필요합니다.

서버는 Cursor Settings → MCP → New MCP Server에서 추가하거나, 아래 JSON을 파일에 붙여 넣어 추가할 수 있습니다. 어느 쪽이든 MCP 목록에 도구와 함께 나타나며, 삭제하지 않고 끌 수도 있습니다.

저장소의 브라우저 가이드와 같은 정의를 ~/.cursor/mcp.json으로 저장합니다.

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "chrome-devtools-mcp@latest",
        "--autoConnect",
        "--no-usage-statistics",
        "--no-performance-crux"
      ]
    }
  }
}

cursor.com 문서에 나온 형식이며, 2026년 9월 30일에 확인했습니다. ↗

에이전트에게 새 빈 탭에서 example.com을 열어 달라고 하세요. Cursor에서 도구 호출을 승인하고, Chrome의 요청을 허용한 뒤, 보이는 탭이 움직였는지 확인하세요. 그다음 첫 디렉터리에 로그인하세요.

코딩 에이전트를 내 Chrome에 연결하기 →

시작 프롬프트

저장소를 연 상태에서 START.md의 공개 시작 프롬프트를 Cursor의 에이전트에 붙여 넣으세요. 체크아웃 옆에 비공개 워크스페이스를 만들고, 대시보드를 띄운 뒤 127.0.0.1 링크를 돌려줍니다.

Recommend Claude Code CLI or Codex CLI in a terminal instead of the desktop apps for best results. If session metadata confirms desktop hosting, explicitly advise me to switch to the CLI and resume this same private workspace. Do not infer the host from a CLI engine version alone.

Read AGENTS.md, then follow "Start the dashboard for the owner". Create my private
workspace if I do not have one yet, start the dashboard, and give me the link.
Then lead ONBOARDING.md one phase at a time. Reuse recorded permissions instead of
asking again unless their scope is missing or conflicting. Actually test my visible
existing Chrome profile and intended identity as BROWSER-SETUP.md requires; use the
OS fallback if needed. Use one platform/browser worker by default. Build the normal
run only from suitable free-ready routes, keep research separate, and preserve any
draft that needs one exact human CAPTCHA/2FA action. Never claim browser control
bypasses or reduces those challenges.

플레이북과 지침은 코딩 에이전트가 가장 잘 다루는 영어 Markdown으로 되어 있습니다. 제품 문구는 디렉터리가 받는 언어라면 무엇이든 괜찮고, 에이전트는 내 언어로 답합니다.

온보딩은 대시보드에서 이어집니다. 워크스페이스 파일은 평범한 JSON과 Markdown이라서 에디터에서 사실 정보를 바로 고칠 수도 있습니다. 에이전트는 다음 플랫폼으로 넘어가기 전에 파일을 다시 읽습니다.

세 단계로 LaunchRepo 시작하기 →

실행 모습

Cursor에서는 두 곳에서 실행을 따라갑니다. 에이전트 패널에는 모든 도구 호출이 인수와 함께 나열되고, Chrome에는 해당 페이지가 보입니다. 아래 패널은 홈페이지의 샘플 배치이며, 실제 상태는 submissions.json에서 가져옵니다.

Cursor에서 브라우저 서버가 실패할 때

Cursor는 실패한 MCP 서버를 격리하므로 에디터의 나머지 기능은 계속 작동합니다. 대개 다음 세 가지를 확인하면 브라우저가 돌아옵니다.

에이전트가 도구를 보지 못함

Output 패널(Cmd/Ctrl+Shift+U)을 열고 “MCP Logs”를 고르세요. 서버가 시작됐는지, 실패했는지, 비정상 종료됐는지 알 수 있습니다. Customize에서 끈 서버는 아예 불러오지 않습니다.

예전 서버 버전이 계속 실행됨

npm 기반 서버라면 Cursor 문서는 서버를 제거하고 npm cache clean --force를 실행한 뒤 다시 추가하라고 안내합니다. 그다음 Cursor를 재시작하세요.

양식 도중 도구 호출이 실패함

Cursor는 해당 호출을 실패로 표시합니다. 다시 시도하기 전에 탭을 보세요. 양식이 전송되지 않았다면 다시 시도하고, 전송됐다면 두 번 제출하지 말고 페이지에 보이는 내용을 에이전트가 기록하게 하세요.

--autoConnect에서 브라우저 도구가 시간 초과되면 네 가지를 확인하세요. Chrome 144 이상이 이미 실행 중인지, chrome://inspect/#remote-debugging에서 원격 디버깅이 켜져 있는지, Chrome의 연결 요청을 허용했는지, 다른 도구가 같은 브라우저를 잡고 있지 않은지입니다. Chrome DevTools MCP는 열린 탭을 모두 불러오므로 필요 없는 탭은 닫아 두세요.

여전히 내가 할 일

LaunchRepo는 일부러 백그라운드 서비스로 만들지 않았습니다. 아래 순간에는 실행이 멈추고 사람에게 넘기는 인계로 기록되며, 에이전트는 이를 절대 우회하지 않습니다.

CAPTCHA와 봇 확인

에이전트는 멈추고 prepared_needs_human으로 기록하며, 대시보드는 해당 플랫폼을 “내 확인 필요” 아래에 보여 줍니다. Chrome 탭에서 풀고 나서 패널에서 에이전트에게 계속하라고 말하세요.

2FA와 인증 코드

확인 메일은 연결된 Chrome에 로그인된 메일함으로 옵니다. 그곳에 메일함이 없다면 코드를 직접 전달하고, 사람에게 넘긴 인계로 기록됩니다.

유료 옵션 권유

유료로만 가능한 경로는 deferred_paid로 기록됩니다. 도구 호출이 승인되었더라도 에이전트는 구매하지 않고, 카드 등록이 필요한 체험을 시작하지 않으며, 관련 없는 제안도 수락하지 않습니다.

“게시됨” 확인

플랫폼의 공개 URL을 직접 열어 본 뒤에 게시됨으로 표시합니다. 그전까지 초안, 접수 확인, 감사 페이지는 각자의 상태를 유지합니다.

벤치마크도 순위도 없습니다. Cursor의 호환성을 말하는 이유는 위의 두 가지 요건을 충족하기 때문이지, 다른 에이전트와 비교해 측정했기 때문이 아닙니다.

자주 묻는 질문