Cursor와 동일한 런타임, 하네스, 모델을 사용해 에이전트를 만들 수 있도록 Cursor SDK를 소개합니다.

Cursor 데스크톱 앱, CLI, 웹 앱에서 실행되는 에이전트를 이제 몇 줄의 TypeScript만으로 사용할 수 있습니다. 어떤 프런티어 모델이든 사용해 로컬 머신에서 실행하거나, Cursor 클라우드의 전용 VM에서 실행할 수 있습니다.

코딩 에이전트는 개별 개발자를 위한 대화형 도구에서 조직을 위한 프로그래밍 방식의 인프라로 진화하고 있습니다. Cursor SDK를 사용하면 전체 에이전트 스택을 직접 만들고 유지하는 부담 없이 에이전트를 배포할 수 있습니다. 많은 팀이 이미 CI/CD 파이프라인에서 에이전트를 직접 호출하고, 엔드 투 엔드 워크플로우를 위한 자동화를 구축하며, 핵심 제품에 에이전트를 통합하고 있습니다.

Cursor SDK는 이제 모든 사용자가 공개 베타로 사용할 수 있습니다. 시작하려면 npm install @cursor/sdk를 실행하세요.

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

#에이전트를 프로덕션에 빠르게 배포하기

데이터에 안전하게 접근하며 실행되는 빠르고 안정적이며 성능 좋은 코딩 에이전트를 만들려면 상당한 엔지니어링 노력이 필요합니다. 보안 샌드박싱, 안정적인 상태 및 세션 관리, 환경 설정, 컨텍스트 관리가 모두 필요합니다. 또한 새 모델이 출시되면 이를 활용하기 위해 팀이 에이전트 루프를 다시 손봐야 하는 경우도 많습니다.

Cursor SDK는 이런 복잡성을 없애 주므로, 유용한 에이전트를 만드는 데 집중할 수 있습니다.

프로덕션용 클라우드 인프라 사용

SDK에서 시작된 클라우드 세션은 클라우드 Agent에 사용하는 것과 동일한 최적화된 런타임에서 실행됩니다. 각 에이전트에는 강력한 샌드박싱, repo 복제본, 그리고 완전히 구성된 개발 환경이 포함된 전용 VM이 제공됩니다.

노트북이 절전 모드로 들어가거나 네트워크가 끊겨도 에이전트는 계속 실행됩니다. 대화를 스트리밍하고 나중에 다시 연결할 수 있습니다. 에이전트가 작업을 마치면 PR을 열거나, 브랜치를 푸시하거나, 데모와 스크린샷을 첨부할 수 있습니다.

// 클라우드 에이전트를 시작하여 작업을 실행합니다...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...나중에 어디서든 다시 확인하세요:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

SDK는 업데이트된 클라우드 Agent API를 사용하며, 이를 통해 클라우드 에이전트 실행 내역이 Cursor의 에이전트 창과 웹 앱에 표시됩니다. 작업을 코드로 시작한 다음 Cursor로 이동해 진행 상황을 살펴보거나 작업을 이어서 진행할 수 있습니다.

다른 런타임이 필요하다면, 동일한 SDK로 셀프 호스팅 워커에서 에이전트를 실행해 코드와 도구 실행을 네트워크 내부에 유지할 수 있고, 빠른 반복 작업을 위해 로컬 머신에서 실행할 수도 있습니다.

Cursor의 전체 하네스 활용

SDK를 통해 시작한 에이전트는 Cursor의 데스크톱 앱, CLI, 웹 앱 전반을 구동하는 동일한 하네스의 이점을 누릴 수 있습니다:

• 지능형 컨텍스트 관리: 코드베이스 인덱싱, 시맨틱 검색, instant grep을 통해 에이전트가 더 빠르고 효율적으로 올바른 결과에 도달할 수 있습니다.
• MCP 서버: 에이전트는 .cursor/mcp.json 구성 파일이나 호출 시 인라인으로 전달된 설정을 통해 stdio 또는 HTTP로 외부 도구와 데이터 소스에 연결할 수 있습니다.
• 스킬: 에이전트는 리포지토리의 .cursor/skills/ 디렉터리에서 스킬을 자동으로 불러옵니다.
• 훅: .cursor/hooks.json 파일로 클라우드, 셀프 호스팅, 로컬 전반에서 에이전트 루프를 관찰하고 제어하며 확장할 수 있습니다.
• 하위 에이전트: 메인 에이전트는 Agent 도구를 통해 각자 고유한 프롬프트와 모델을 가진 이름 있는 하위 에이전트에 하위 작업을 위임합니다.

어떤 모델이든 활용

Cursor SDK를 사용하면 Cursor에서 지원하는 모든 모델에 접근할 수 있습니다. 필드 하나만 바꾸면 원하는 요금과 성능의 균형에 맞춰 현재 작업에 가장 적합한 모델로 에이전트를 라우팅할 수 있습니다.

또한 Composer 2는 범용 모델보다 훨씬 낮은 비용으로 프런티어급 성능을 제공하는 특화된 코딩 모델로, 대부분의 코딩 에이전트 작업에서 지능과 효율성의 최적 조합을 제공합니다.

#개발자들이 만들고 있는 것

팀들은 Cursor SDK를 사용해 맞춤형 에이전트를 더 빠르게 배포하고 있습니다. 예를 들어, CI/CD에서 직접 실행되어 변경 사항을 요약하고, CI 실패의 근본 원인을 파악하며, 수정 사항을 반영해 PR을 업데이트하는 프로그래밍 방식의 에이전트가 있습니다. 또 다른 팀들은 GTM 팀이 코드를 작성하지 않고도 제품 데이터를 조회할 수 있게 해주는 내부 애플리케이션 같은 맞춤형 에이전트 플랫폼을 만들고 있습니다.

일부 고객은 Cursor를 고객 대면 제품에 직접 내장하기도 합니다. 이제 최종 사용자는 호스트 애플리케이션을 벗어나지 않고도 에이전트 경험을 누릴 수 있습니다.

Cursor SDK를 기반으로 개발 중인 고객들의 이야기를 직접 확인해 보세요:

#샘플 프로젝트로 시작하기

자체 사용 사례에 맞게 포크하고 확장할 수 있는 몇 가지 스타터 프로젝트를 공개 GitHub repo에 추가했습니다:

• 빠른 시작: 로컬 에이전트를 만들고 프롬프트 하나를 보낸 뒤 응답을 스트리밍하는 간단한 Node.js 예시입니다.
• 프로토타이핑 도구: 에이전트를 실행해 새 프로젝트의 골격을 만들고, 샌드박스된 클라우드 환경에서 아이디어를 빠르게 발전시킬 수 있는 웹 앱입니다.
• Kanban board: 엔지니어가 카드를 드래그하면 에이전트가 자동으로 작업을 이어받아 PR을 열고, 결과를 첨부 파일로 다시 올리는 에이전트 기반 칸반 도구입니다.
• 코딩 에이전트 CLI: 터미널에서 Cursor 에이전트를 실행할 수 있는 가벼운 명령줄 인터페이스입니다.

#다음 단계

Cursor SDK는 모든 사용자가 사용할 수 있으며, 표준 토큰 기반 사용량 요금에 따라 과금됩니다.

저희는 Cursor SDK에 대한 투자를 계속하고 있으며, 팀이 더 많은 언어, 워크플로우, 배포 방식에서 프로그래밍 방식의 에이전트를 더 쉽게 만들 수 있도록 하는 데 중점을 두고 있습니다.

자세한 내용은 문서에서 확인하세요. 또한 Cursor SDK 플러그인을 사용해 Cursor에서 개발을 시작할 수도 있습니다.