메인 콘텐츠로 건너뛰기
Cursor의 Slack 연동을 쓰면, @Cursor를 멘션하고 프롬프트를 적어서 Background Agents로 Slack에서 바로 작업을 처리할 수 있어.

시작하기

설치

  1. Cursor integrations로 이동
  2. Slack 옆의 _Connect_를 클릭하거나 여기에서 installation page로 이동
  3. 워크스페이스에 Slack용 Cursor 앱을 설치하라는 안내가 표시돼
  4. Slack에 설치한 뒤, 설정을 마무리하려고 Cursor로 돌아가게 돼
    1. GitHub 연결(아직 안 했다면)하고 기본 리포지토리 선택
    2. 사용량 기반 과금 켜기
    3. 개인정보 설정 확인
  5. Slack에서 @Cursor를 멘션해서 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. Bracket 형식 @Cursor [branch=dev, model=o3, repo=owner/repo, autopr=false] Fix the login bug
  2. Inline 형식 @Cursor branch=dev model=o3 repo=owner/repo autopr=false Fix the login bug
옵션 우선순위
옵션을 조합할 때:
  • 명시적 값이 기본값보다 우선이야
  • 나중 값이 중복되면 이전 값을 덮어써
  • Inline 옵션이 설정 모달의 기본값보다 우선이야
봇은 메시지 어디에 있든 옵션을 파싱하니까, 자연스럽게 명령을 작성해도 돼.

스레드 컨텍스트 사용

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: 문제 해결용 고유 요청 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 이미지를 표시해. 파일 경로나 코드 스니펫이 포함될 수 있어. On/Off로 전환할 수 있어.

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

다른 워크스페이스와의 Slack Connect나 Guests 같은 외부 구성원이 있는 채널에서는, 외부 채널에 에이전트 요약을 표시할지 선택해.

권한

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비공개 알림이나 1:1 커뮤니케이션을 위해 다이렉트 메시지를 시작
mpim:history다자간 대화를 위해 그룹 DM 기록에 접근
mpim:read참가자를 지정하고 정확한 전달을 위해 그룹 DM 메타데이터를 읽음
reactions:read사용자 피드백과 상태 신호를 위해 이모지 리액션을 확인
reactions:write상태 표시용 이모지 리액션 추가 - ⏳ 실행 중, ✅ 완료, ❌ 실패
team:read설치를 분리하고 설정을 적용하려고 워크스페이스 세부 정보를 식별
users:read권한 부여와 보안 접근을 위해 Slack 사용자와 Cursor 계정을 매칭
I