Cursor의 Slack 통합 기능을 사용하면 @Cursor를 멘션하고 프롬프트를 입력해서 Slack에서 바로 백그라운드 에이전트로 작업할 수 있어.

시작하기

설치

  1. Cursor integrations로 이동
  2. Slack 옆의 _Connect_를 클릭하거나 설치 페이지로 바로 이동
  3. 워크스페이스에 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를 실행해.
명령어설명
@Cursor [prompt]Background Agent를 시작해. 기존 에이전트가 있는 스레드에서는 후속 지시사항을 추가해
@Cursor settings기본값과 채널의 기본 저장소를 설정해
@Cursor [options] [prompt]고급 옵션 사용: branch, model, repo
@Cursor agent [prompt]스레드에서 새 에이전트를 강제로 생성해
@Cursor list my agents실행 중인 에이전트들을 보여줘

옵션

이 옵션들로 Background Agent 동작을 커스터마이징해:
옵션설명예시
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 Agent는 기존 스레드 토론의 컨텍스트를 이해하고 활용해. 팀이 이슈를 논의하고 그 대화를 바탕으로 에이전트가 솔루션을 구현하길 원할 때 유용해.
S
Sarah2:30 PM
팀, 최신 배포 후에 사용자들이 로그인할 수 없다는 신고가 들어오고 있어
M
Mike2:32 PM
로그를 확인해봤는데 - auth.js의 247번째 줄에서 인증 토큰 검증이 실패하는 것 같아
A
Alex2:33 PM
아, 토큰 형식을 변경했는데 검증 정규식을 업데이트하지 않아서 그런 것 같아
S
Sarah2:35 PM
맞아, 정규식이 아직 이전 형식을 기대하고 있어. 하위 호환성을 위해 이전 형식과 새 형식을 모두 처리하도록 업데이트해야 해
Y
You2:36 PM
@Cursor fix this
1
Background Agent는 호출될 때 전체 스레드를 읽어서 컨텍스트를 파악하고, 팀의 토론을 바탕으로 솔루션을 이해하고 구현해.

강제 명령어를 사용해야 하는 경우

언제 @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를 관리할 수 있어.
사용 가능한 옵션:
  • 후속 작업 추가: 기존 에이전트에 추가 지시사항 입력
  • 삭제: Background Agent 중지 및 아카이브
  • 요청 ID 보기: 문제 해결용 고유 요청 ID 확인 (지원팀 문의 시 포함 필요)
  • 피드백 제공: 에이전트 성능에 대한 피드백 제공

설정

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

설정

기본 모델

@Cursor [model=...]로 모델을 명시적으로 지정하지 않을 때 사용돼. 사용 가능한 옵션은 설정을 확인해.

기본 리포지토리

리포지토리를 지정하지 않을 때 사용돼. 다음 형식을 사용해:
  • 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 Mode (Legacy)는 지원되지 않아. Background Agents는 실행 중에 임시 코드 저장이 필요해.

에이전트 요약 표시

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

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

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

권한

Cursor는 Background Agents가 너의 워크스페이스에서 작동하기 위해 다음 Slack 권한을 요청해:
권한설명
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 계정과 매칭