Cursor Agent는 내장 Browser로 페이지를 열고 클릭하며 화면과 로그를 읽을 수 있습니다. 주소와 뷰포트, 실패 조건을 알려줍니다. 수정 후에는 같은 동작을 반복하고 표시되는 결과를 확인합니다.
실험에서 Cursor Agent CLI 2026.09.10-fd3934a가 연습 양식 코드를 수정했고 Tabbit이 별도로 검증했습니다. 설치된 Cursor Desktop은 3.28.7입니다. CLI 기록에는 도구 탐색, 읽기, 편집이 있으며 IDE Browser 호출은 없습니다. Browser 단계는 공식 문서를 따릅니다.
브라우저 경로 고르기
개발 작업 공간에서 접근할 수 있는 페이지에는 내장 Browser를 사용할 수 있습니다. 공식 문서는 내장 패널 또는 별도 화면과 작업 공간별 상태 분리를 설명합니다. 외부 MCP가 설치되어 있다면 어떤 도구가 호출됐는지 작업 로그에서 확인합니다.
IDE 명령 팔레트에서 Browser를 열고 채팅에 @browser를 지정합니다. 승인하기 전에 사이트와 동작을 확인합니다.
| 경로 | 세션 | 먼저 확인할 내용 |
|---|---|---|
| Cursor Browser | 작업 공간 상태 | Agent |
| External MCP | 커넥터 설정 | MCP |
Cursor Browser Docs · UI 테스트 · 자동화 에이전트
정확한 개발 주소 열기
포트와 경로까지 포함한 URL을 제공합니다. 개발 서버가 여러 개라면 실제로 열린 제목과 주소를 요청합니다. 합성 데이터를 사용합니다. 로그인이 필요하면 승인된 테스트 세션을 먼저 확인합니다.
재현 가능한 문제 전달하기
화면 폭, 문제가 있는 요소와 실제 결과를 기록합니다. 배송비 양식이라면 뷰포트와 문서 스크롤 폭을 비교하고 버튼이 패널 바깥으로 나오는지 확인합니다. 콘솔 오류는 재현에 필요한 동작과 함께 해당 내용만 첨부합니다.
@browser 지정 주소를 열고 제목, 스크롤 폭, 버튼이 패널을 벗어나는지 알려주세요. 넘친다면 양식 CSS만 고치고 같은 폭에서 새로고침한 뒤 한 번 눌러 상태를 반환하세요.
변경 범위 좁히기
영향을 받는 컴포넌트만 수정하도록 요청합니다. 데스크톱 가로 배치와 입력 필드, 레이블, 결과 동작을 유지합니다. 화면 캡처로 위치를 공유하고 폭과 클릭 뒤 상태를 따로 확인합니다.
수정 뒤 같은 조건으로 검증하기
같은 URL과 좁은 폭에서 새로고침합니다. 양식이 들어오는지 확인하고 Check estimate를 한 번 눌러 결과를 읽습니다. 데스크톱 폭에서도 가로 배치가 유지되는지 확인합니다.
Cursor는 520 px 이하에서 줄바꿈을 허용하고 입력란 최소 폭을 없앴습니다. 측정된 354 CSS px 뷰포트에서 스크롤 폭이 510 px에서 354 px로 바뀌었습니다. 한 번 클릭하자 Estimate ID: DEMO-D01이 표시됐습니다. 909 CSS px에서는 가로 배치가 유지됐습니다.
| 조건 | 측정 결과 |
|---|---|
| 수정 전 | 354 px → 510 px |
| 수정 후 | 354 px → 354 px |
| 데스크톱 확인 | 입력란과 버튼이 같은 줄 |
수정한 연습 페이지 열기 · 첫 브라우저 작업 체크리스트
Browser 도구가 보이지 않을 때
브라우저 자동화 설정을 확인하고 내장 Browser를 지정합니다. 탭을 직접 여는 것과 Agent의 도구 호출은 별도로 기록합니다. 현재 세션에 도구가 없다면 제한 사항과 실제 검증 도구를 남깁니다.
한 사용자는 설정에서 내장 브라우저를 찾았습니다. 다른 사용자는 탭을 열었지만 Agent 세션에 도구가 없다고 보고했습니다. 작업 로그에서 두 상황을 구분합니다. Reddit 1 · Reddit 2 · Cursor Forum
자주 묻는 질문
Cursor Agent가 웹 버튼을 누를 수 있나요?
공식 Browser는 승인된 세션에서 이동, 클릭, 입력, 화면 캡처를 지원합니다.
로컬 서버 주소는 어떻게 전달하나요?
접근 가능한 URL을 알려주고 선택한 세션에서 제목과 주소를 확인합니다.
브라우저 로그인 상태가 남나요?
공식 문서에 따르면 작업 공간별로 브라우저 상태가 유지됩니다.
반응형 레이아웃 문제는 어떻게 알려주나요?
화면 폭, 요소, 동작, 실제 결과와 기대 결과를 기록합니다.
탭을 열면 Browser를 호출한 증거인가요?
작업 로그에서 실제 도구와 읽은 페이지 상태를 확인합니다.
수정 뒤에는 무엇을 확인하나요?
같은 입력과 동작으로 재현하고 유지해야 하는 다른 폭도 점검합니다.