클라우드 에이전트

클라우드 에이전트는 동일한 에이전트 기본 사항을 사용하지만, 로컬 머신 대신 클라우드의 격리된 VM에서 전체 개발 환경을 갖춘 상태로 실행됩니다. 개발 환경은 노트북의 설정과 비슷하며, 클론된 리포지토리, 설치된 의존성, 시크릿, 시작 명령어, 네트워크 액세스가 포함됩니다.

효과적인 개발 환경은 에이전트에 코드베이스와 조직에 대한 전체 컨텍스트를 제공하므로, 에이전트가 수행한 작업을 테스트하고 검증할 수 있습니다.

왜 클라우드 에이전트를 사용하나요?

원하는 만큼 에이전트를 병렬로 실행할 수 있으며, 로컬 머신을 인터넷에 연결해 둘 필요도 없습니다.

자체 가상 머신에 접근할 수 있으므로, 클라우드 에이전트는 변경된 소프트웨어를 구현하고 테스트하며 직접 상호작용할 수 있습니다. 또한 컴퓨터를 사용해 데스크톱과 브라우저를 제어할 수도 있습니다. 클라우드 에이전트는 MCP 서버를 지원하므로 데이터베이스, API, 서드파티 서비스와 같은 외부 도구 및 데이터 소스에 접근할 수 있습니다.

클라우드 에이전트는 멀티 리포지토리 환경에서도 실행할 수 있습니다. 작업이 서로 분리된 프런트엔드, 백엔드, 인프라 또는 공용 라이브러리 리포지토리에 걸쳐 있을 때 사용하세요. 에이전트는 전체 워크스페이스를 살펴보고, 관련 변경 사항을 함께 적용하고, 변경한 리포지토리에서 풀 리퀘스트를 열 수 있습니다.

접근 방법

저장소에서 Cloud Agent를 시작하려면 먼저 Cursor 계정 관리자가 해당 계정에 소스 제어를 연결해야 합니다. GitHub (Cloud and Enterprise Server), GitLab (Cloud and Self-Hosted), Bitbucket Cloud, 또는 Azure DevOps를 설정하세요.

어디서 작업하든 Cloud Agent를 실행할 수 있습니다:

Cursor for iOS: Cursor iOS app에서 Agent를 시작하고 관리하세요
Cursor Web: 모든 기기에서 cursor.com/agents로 Agent를 시작하고 관리하세요
Cursor Desktop: Agent 입력 아래 드롭다운에서 Cloud를 선택하세요
Slack: @cursor 명령을 사용해 Agent를 실행하세요
GitHub or Bitbucket: GitHub PR 또는 이슈, 또는 Bitbucket PR에 @cursor 댓글을 남겨 Agent를 실행하세요
Linear: @cursor 명령을 사용해 Agent를 실행하세요
API: API를 사용해 Agent를 실행하세요

Android에서는 Chrome에서 cursor.com/agents를 사용하고 Progressive Web App (PWA)용 Install App을 탭하세요. 네이티브 iPhone 및 iPad 앱과 더 많은 모바일 옵션은 Cursor for iOS에서 확인하세요.

Slack에서 Cursor 사용

Agent 실행과 알림 수신을 포함해 Slack 통합을 설정하고 사용하는 방법을 자세히 알아보세요.

동작 방식

저장소 공급자 연결

클라우드 에이전트는 GitHub, GitLab, Azure DevOps Services 또는 Bitbucket Cloud에서 리포지토리를 클론해 별도 브랜치에서 작업한 뒤, 인계를 위해 변경 사항을 리포지토리에 푸시합니다.

리포지토리와 모든 종속 리포지토리 또는 서브모듈에 대한 읽기/쓰기 권한이 필요합니다.

환경

Agent의 역량은 실행되는 환경에 따라 달라집니다. 코드를 작성할 수 있어도 테스트를 실행하거나, 서비스에 질의하거나, API에 접근할 수 없다면 작업을 완결할 수 없습니다.

클라우드 에이전트를 위한 개발 환경을 설정하지 않는 것은 엔지니어에게 컴퓨터를 주지 않는 것과 같습니다. 그래서 환경 설정은 클라우드 에이전트의 효과를 높이는 가장 중요한 단계입니다. 이를 통해 클라우드 에이전트는 엔지니어처럼 코드를 작성하고, 작업을 테스트하고 검증하며, 소프트웨어를 배포할 수 있습니다.

.cursor/environment.json에서 Agent 주도 설정, 저장된 스냅샷 또는 Dockerfile을 사용해 환경을 구성할 수 있습니다. 시작하려면 Cloud Agent 설정을 참조하세요. 빌드는 백그라운드에서 각 환경을 준비하므로 에이전트는 리포지토리와 의존성이 준비된 상태로 시작합니다.

클라우드 에이전트 대시보드에는 Agent가 사용한 환경과 빌드, 환경 세부 정보 및 버전 기록이 표시됩니다. Agent 페이지에서는 페이지 상단의 저장소 이름에 마우스를 올려 해당 실행에 사용된 환경을 확인할 수 있습니다. 구성에 대한 자세한 내용은 Cloud Agent 설정을 참조하세요.

런타임 및 환경 제어

Cursor는 모든 Cloud Agent의 VM 프로비저닝, 격리, 스냅샷, 실행, 산출물 및 용량을 관리합니다. 시크릿을 추가하고, 아웃바운드 도메인을 제한하고, Tailscale 또는 유사한 클라이언트로 비공개 네트워크에 연결하고, 지원되는 소스 제어 경로에 비공개 연결을 사용할 수 있습니다.

환경 및 네트워크 제어의 전체 항목은 Cloud Agent 보안 및 네트워크에서 확인하세요. 자체 호스팅 여부를 검토 중이라면 대부분의 팀이 Cursor Cloud로 시작하는 이유를 확인하세요.

모델

클라우드 에이전트는 엄선된 모델 세트를 사용합니다. 지원되는 모델의 컨텍스트 윈도우 크기를 선택할 수 있습니다.

MCP 지원

클라우드 에이전트는 팀에 설정된 MCP (Model Context Protocol) 서버를 사용할 수 있습니다. cursor.com/agents의 MCP 드롭다운에서 MCP 서버를 추가하고 관리하세요.

HTTP와 stdio 전송 방식을 모두 지원합니다. OAuth가 필요한 MCP 서버에서는 OAuth도 지원합니다. 설정에 대한 자세한 내용은 Cloud Agent 기능을 참조하세요.

클라우드 에이전트에는 대화 기록, 실행 이벤트, 환경 세부 정보, 설정 로그를 포함한 실행 진단을 위한 기본 제공 Cursor Cloud MCP도 포함되어 있습니다.

훅 지원

클라우드 에이전트는 저장소의 .cursor/hooks.json에 있는 명령 기반 훅을 실행합니다. 엔터프라이즈 요금제에서는 팀 훅과 엔터프라이즈 관리 훅도 실행합니다.

이렇게 하면 작업이 클라우드에서 실행될 때도 포매터, 감사 스크립트, 정책 검사가 계속 적용됩니다. 지원되는 훅에는 도구 및 파일 훅(preToolUse, beforeShellExecution, afterFileEdit)과 수명 주기 훅(beforeSubmitPrompt, subagentStart / subagentStop, preCompact, afterAgentResponse / afterAgentThought, stop)이 포함됩니다.

읽기 전용 환경에서 진행되는 초기 탐색 턴 동안에는 훅이 실행되지 않으며, 클라우드 에이전트가 쓰기 가능한 환경을 갖추면 실행되기 시작합니다. 일부 훅은 IDE 전용(Tab 훅, workspaceOpen)입니다. ~/.cursor/hooks.json의 사용자 수준 훅도 클라우드 VM은 로컬 홈 디렉터리에 접근할 수 없기 때문에 사용할 수 없습니다.

전체 지원 매트릭스와 자세한 내용은 훅: 클라우드 에이전트 지원을 참조하세요.

산출물 및 원격 데스크톱 제어

클라우드 에이전트는 변경 사항을 보여 주는 산출물과 함께 바로 머지할 수 있는 PR을 생성합니다. 또한 Agent의 원격 데스크톱을 제어해 수정된 소프트웨어를 직접 사용할 수도 있습니다.

산출물: Agent는 스크린샷, 동영상, 로그를 생성하므로 무엇이 변경되었는지와 Agent가 작업을 어떻게 검증했는지 정확히 확인할 수 있습니다.
원격 데스크톱 제어: Agent의 데스크톱 제어를 넘겨받아, 브랜치를 로컬에 체크아웃하지 않고도 전체 개발 환경에서 직접 소프트웨어를 테스트할 수 있습니다. Agent가 계속 작업하도록 하려면 다시 제어권을 넘겨주면 됩니다.

산출물, 컴퓨터 사용, 원격 데스크톱 제어에 대한 자세한 내용은 Cloud Agent 기능을 참고하세요.

팀과 Agent 공유하기

Agent URL을 팀원에게 보내면, 팀원이 실행을 열어 대화, 코드 변경 사항, 그리고 Agent가 생성한 산출물을 볼 수 있습니다.

Agent는 해당 Agent가 시작된 Cursor 팀의 멤버에게 표시됩니다. Cursor는 각 사용자의 저장소 접근 권한도 확인합니다. 팀원의 Agent를 열려면 통합에서 자신의 소스 제어 계정을 연결하고, Agent가 작업한 저장소에 접근할 수 있는지 확인하세요. 팀 멤버십만으로는 접근 권한이 부여되지 않습니다.

보기는 읽기 전용입니다. 팀원이 후속 메시지를 보내 작업을 계속할 수 있게 하려면 팀 관리자가 팀 후속 작업을 활성화할 수 있습니다.

결제

클라우드 에이전트는 선택한 모델의 API 요금으로 청구됩니다. 컨텍스트 윈도우 크기를 선택할 수 있으며, 더 큰 컨텍스트 윈도우는 토큰 사용량과 비용을 늘릴 수 있습니다. 처음 사용할 때 지출 한도를 설정하라는 안내가 표시됩니다.

문제 해결

로그인되어 있고 GitHub, GitLab, Azure DevOps 또는 Bitbucket 계정을 연결했는지 확인하세요.
필요한 저장소 권한이 있는지 확인하세요.
유료 Cursor 요금제여야 합니다.

cursor.com/dashboard/cloud-agents에 시크릿을 추가했는지 확인하세요.
시크릿은 워크스페이스/팀 범위로 적용되므로 올바른 계정을 사용하고 있는지 확인하세요.
새 시크릿을 추가한 후 Cloud Agent를 다시 시작해 보세요.

보이지 않으면 필요한 권한이 있는지 확인하세요.

스냅샷은 기본 환경 구성(설치된 패키지, 시스템 의존성 등)을 저장합니다. 스냅샷 생성 시 .env.local 파일을 포함하면 함께 저장됩니다. 하지만 환경 변수를 관리하려면 Cursor 설정의 시크릿 탭을 사용하는 것이 권장됩니다.

해당 팀원은 나와 같은 Cursor 팀에 속해 있어야 합니다.
Integrations에서 자신의 소스 제어 계정을 연결하고, Agent가 작업한 저장소에 접근할 수 있어야 합니다.
자세한 내용은 팀과 Agent 공유하기를 참조하세요.

워크스페이스 관리자가 Cursor Slack 앱을 설치했는지, 그리고 필요한 권한이 있는지 검증하세요.

명칭 이력

클라우드 에이전트는 이전에는 Background Agents로 불렸습니다.