Cursor의 Slack 통합을 쓰면, Slack에서 @Cursor를 멘션하고 프롬프트를 붙여서 바로 Background Agents로 작업을 진행할 수 있어.

시작하기

설치

  1. Cursor integrations로 이동
  2. 여기서 Slack 옆의 _Connect_를 클릭하거나 이 링크에서 installation page로 이동
  3. 워크스페이스에 Slack용 Cursor 앱을 설치하라는 메시지가 뜰 거야
  4. Slack에 설치한 뒤 설정 마무리를 위해 Cursor로 다시 리디렉션돼
    1. GitHub 연결(아직 안 했다면)하고 기본 리포지토리 선택
    2. 사용량 기반 요금제 활성화
    3. 개인정보 보호 설정 확인
  5. @Cursor를 멘션해서 Slack에서 Background Agents 사용 시작

사용 방법

@Cursor를 멘션하고 프롬프트를 보내면 돼. 이 방식이 대부분의 사용 사례를 커버하지만, 아래 명령어로 에이전트를 더 세밀하게 커스터마이즈할 수도 있어. 예를 들어 대화 중에 @Cursor fix the login bug처럼 바로 멘션하거나, 특정 리포지토리를 겨냥해 @Cursor [repo=torvalds/linux] fix bug 같은 명령어를 쓸 수도 있어.

명령어

최신 명령어 목록은 @Cursor help로 확인해.
CommandDescription
@Cursor [prompt]Background Agent 시작. 기존 에이전트가 있는 스레드에서는 후속 지시 추가
@Cursor settings기본값과 채널 기본 리포지토리 설정
@Cursor [options] [prompt]고급 옵션 사용: branch, model, repo
@Cursor agent [prompt]스레드에 새 에이전트 강제 생성
@Cursor list my agents실행 중인 내 에이전트 표시

옵션

다음 옵션으로 Background Agent 동작을 커스터마이즈해:
OptionDescriptionExample
branch기준 브랜치 지정branch=main
modelAI 모델 선택model=o3
repo대상 리포지토리 지정repo=owner/repo
autopr자동 PR 생성 켜기/끄기autopr=false
구문 형식
옵션은 여러 방식으로 쓸 수 있어:
  1. 대괄호 형식 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. 인라인 형식 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
옵션 우선순위
옵션을 조합할 때:
  • 명시적 값이 기본값을 덮어써
  • 중복되면 나중 값이 이전 값을 덮어써
  • 인라인 옵션이 설정 모달의 기본값보다 우선이야
봇은 메시지 어디에서든 옵션을 파싱하니까 자연스럽게 명령을 작성할 수 있어.

스레드 컨텍스트 사용

Background Agents는 기존 스레드 대화의 컨텍스트를 이해하고 활용해. 팀이 이슈를 논의했고 그 대화를 바탕으로 에이전트가 해결책을 구현하길 원할 때 유용해.
S
Sarah2:30 PM
Hey team, we're getting reports that users can't log in after the latest deploy
M
Mike2:32 PM
I checked the logs - looks like the auth token validation is failing on line 247 of auth.js
A
Alex2:33 PM
Oh, I think it's because we changed the token format but didn't update the validation regex
S
Sarah2:35 PM
Yeah, the regex still expects the old format. We need to update it to handle both old and new formats for backwards compatibility
Y
You2:36 PM
@Cursor fix this
1
Background Agents는 호출 시 컨텍스트를 위해 스레드 전체를 읽고, 팀의 논의를 바탕으로 해결책을 이해하고 구현해.

강제 명령은 언제 쓸까

@Cursor agent가 언제 필요할까? 기존 에이전트가 있는 스레드에서는 @Cursor [prompt]가 후속 지시를 추가해(에이전트를 네가 소유한 경우에만 동작). 별도의 에이전트를 띄우려면 @Cursor agent [prompt]를 써. Add follow-up(컨텍스트 메뉴)은 언제 필요할까? 에이전트 응답의 컨텍스트 메뉴(⋯)에서 후속 지시를 추가해. 스레드에 여러 에이전트가 있고 어떤 에이전트에 후속 지시를 보낼지 지정해야 할 때 유용해.

상태 업데이트 및 핸드오프

Background Agent가 실행되면 먼저 Open in Cursor 옵션이 떠.
Background Agent가 완료되면 Slack으로 알림이 오고, GitHub에서 생성된 PR을 바로 볼 수 있어.

에이전트 관리

실행 중인 모든 에이전트를 보려면 @Cursor list my agents를 실행해. 아무 에이전트 메시지에서 점 세 개(⋯)를 눌러 컨텍스트 메뉴로 Background Agent를 관리할 수 있어.
사용 가능한 옵션:
  • Add follow-up: 기존 에이전트에 추가 지시사항을 덧붙여
  • Delete: Background Agent를 중지하고 보관해
  • View request ID: 트러블슈팅용 고유 request ID를 확인해 (지원에 문의할 때 포함해 줘)
  • Give feedback: 에이전트 성능에 대해 피드백을 남겨

구성

Dashboard → Background Agents에서 기본 설정과 프라이버시 옵션을 관리해.

설정

기본 모델

@Cursor [model=...]로 모델을 명시하지 않았을 때 사용돼. 사용 가능한 옵션은 settings에서 확인해.

기본 리포지토리

리포지토리를 지정하지 않았을 때 사용돼. 다음 형식을 사용해:
  • https://github.com/org/repository
  • org/repository
존재하지 않는 리포지토리를 참조하면 권한이 없는 것처럼 보여. Background Agent 시작에 실패할 때 표시되는 오류 메시지에 이렇게 나타나.

기준 브랜치

Background Agent가 시작할 때 사용하는 브랜치야. 비워두면 리포지토리의 기본 브랜치(보통 main)를 사용해.

채널 설정

@Cursor settings로 채널 단위 기본 설정을 구성해. 이 설정은 팀 단위로 적용되고, 해당 채널에서 너의 개인 기본값을 덮어써. 특히 유용한 경우:
  • 채널마다 다른 리포지토리에서 작업할 때
  • 팀 전체가 일관된 설정을 원할 때
  • 매번 명령에 리포지토리를 지정하고 싶지 않을 때
채널 설정을 구성하려면:
  1. 원하는 채널에서 @Cursor settings를 실행해
  2. 그 채널의 기본 리포지토리를 설정해
  3. 그 채널에서 Background Agents를 사용하는 모든 팀 멤버가 이 기본값을 사용해
채널 설정은 개인 기본값보다 우선하지만, @Cursor [repo=...] [prompt] 같은 명시적 옵션으로 덮어쓸 수 있어.

프라이버시

Background Agents는 Privacy Mode를 지원해. Privacy Mode에 대해 더 알아보거나 privacy settings를 관리해.
Privacy Mode(레거시)는 지원되지 않아. Background Agents는 실행 중에 임시 코드 저장이 필요해.

에이전트 요약 표시

에이전트 요약과 diff 이미지를 표시해. 파일 경로나 코드 스니펫이 포함될 수 있어. 켜기/끄기 가능해.

외부 채널에서 에이전트 요약 표시

다른 워크스페이스와의 Slack Connect 또는 게스트 등 외부 멤버가 있는 채널에서, 에이전트 요약을 표시할지 선택해.

권한

Cursor는 Background Agents가 워크스페이스에서 동작하도록 다음 Slack 권한을 요청해:
PermissionDescription
app_mentions:read@멘션을 감지해 Background Agents를 시작하고 요청에 응답해
channels:history후속 지시를 추가할 때 컨텍스트를 위해 스레드의 이전 메시지를 읽어
channels:join초대받거나 요청되면 공개 채널에 자동으로 참여해
channels:read답글과 업데이트를 올리기 위해 채널 메타데이터(ID와 이름)에 접근해
chat:write에이전트가 작업을 마치면 상태 업데이트, 완료 알림, PR 링크를 보내
files:read추가 컨텍스트를 위해 공유 파일(로그, 스크린샷, 코드 샘플)을 내려받아
files:write빠른 검토를 위해 에이전트 변경 사항의 시각 요약을 업로드해
groups:history멀티턴 대화 컨텍스트를 위해 비공개 채널의 이전 메시지를 읽어
groups:read응답 게시와 대화 흐름 유지를 위해 비공개 채널 메타데이터에 접근해
im:history이어지는 대화의 컨텍스트를 위해 다이렉트 메시지 기록에 접근해
im:read참여자를 식별하고 올바른 스레딩을 유지하기 위해 DM 메타데이터를 읽어
im:write비공개 알림이나 개별 커뮤니케이션을 위해 다이렉트 메시지를 시작해
mpim:history다수 참여자 대화를 위해 그룹 DM 기록에 접근해
mpim:read참여자를 지정하고 제대로 전달되도록 그룹 DM 메타데이터를 읽어
reactions:read사용자 피드백과 상태 신호를 위해 이모지 반응을 확인해
reactions:write상태 표시를 위해 이모지 반응을 추가해 — ⏳ 실행 중, ✅ 완료, ❌ 실패
team:read설치를 구분하고 설정을 적용하기 위해 워크스페이스 정보를 식별해
users:read권한 부여와 보안 액세스를 위해 Slack 사용자와 Cursor 계정을 매칭해