macOS 파워 유저와 개발자, 테크니컬 리더에게 Raycast는 단순한 앱 실행기(Launcher)를 넘어 일상 업무의 중추적인 커맨드 센터로 자리 잡았습니다. 하지만 대다수의 사용자는 여전히 Raycast AI를 독립된 텍스트 챗봇처럼 사용하고 있습니다. AI로부터 코드나 분석 결과를 얻더라도 GitHub, Linear, Notion, 터미널, Finder를 수동으로 오가며 작업을 처리해야 하는 병목이 발생하기 때문입니다.
Raycast는 이러한 단절을 AI Tools(공식 매뉴얼에서는 AI Extensions로도 지칭)를 통해 해결합니다. AI Chat과 Quick AI에 네이티브 함수 호출(Function Calling) 체계를 결합하여, Claude 3.5 Sonnet 및 GPT-4o 같은 첨단 대규모 언어 모델이 로컬 시스템 도구와 서드파티 SaaS 확장 프로그램을 스스로 탐색하고 실행할 수 있도록 지원합니다.
본 가이드에서는 툴 지원 확장 프로그램 설치부터 @ 멘션을 활용한 다중 도구 연계, 권한 및 자동 검토(Auto-review) 보안 규칙 설정, 확장 프로그램별 커스텀 지침(Custom Instructions) 튜닝, 그리고 자체 MCP(Model Context Protocol) 서버 연동에 이르기까지 Mac을 통합 데스크톱 에이전트 허브로 탈바꿈하는 실무 절차를 단계별로 살펴봅니다.
1. 사전 준비 및 아키텍처 이해
AI Tools를 구성하기 전에 필요한 시스템 요구 사항과 기본 개념을 먼저 점검해야 합니다.
- Raycast Pro 구독 필요: AI Tools 및 AI Chat의 온전한 기능은 Raycast Pro 구독자에게만 제공됩니다. Pro 플랜을 통해 첨단 프론티어 모델, 확장된 컨텍스트 윈도우, 도구 호출 실행 엔진을 이용할 수 있습니다.
- 도구 호출 지원 모델 선택: 모든 대형 언어 모델이 원활한 도구 호출을 지원하는 것은 아닙니다. Raycast Settings → AI → Models 또는 AI Chat 대화창에서 도구 호출과 복합 추론에 최적화된 모델(예: Claude 3.5 Sonnet, GPT-4o)이 활성화되어 있는지 확인하십시오.
- 일반 확장 프로그램 명령과 AI Tools의 차이: 일반적인 Raycast 명령은 검색창에서 사용자가 직접 조작하는 GUI 화면(목록, 상세 뷰 등)을 엽니다. 반면 AI Tools는 사용자에게 화면을 띄우지 않고 백그라운드에서 AI 모델이 직접 인자를 전달하여 실행하는 보이지 않는 함수 인터페이스입니다.
2. 도구 지원 확장 프로그램 탐색 및 설치
Raycast는 시스템에 기본 내장된 로컬 도구들과 함께, 공식 Raycast Store를 통해 다양한 외부 SaaS 확장 프로그램을 제공합니다.
기본 내장 시스템 AI 도구
다음 도구들은 추가 설정 없이 macOS 환경에서 즉시 호출할 수 있습니다:
@finder: macOS Finder 파일 및 디렉터리 검색, 내용 확인 및 파일 관리.@file-search: 시스템 인덱스를 활용한 초고속 로컬 파일 탐색.@terminal: 쉘 스크립트 및 명령어를 대화창에서 직접 실행하고 출력 결과 평가.@clipboard: 클립보드 히스토리 검색, 특정 항목 읽기 및 내용 교체.@browser: 현재 웹 브라우저 활성 탭의 DOM 콘텐츠 읽기 및 요약(무료 Raycast Browser Companion 플러그인 필요).@screen-awareness: 최상단 활성 윈도우 정보, 선택한 텍스트 및 화면 스크린샷 캡처.@calendar: 예정된 캘린더 미팅 일정 및 비어 있는 시간대 확인.@raycast-notes: Raycast 내장 메모장 검색, 작성 및 추가.
Raycast Store에서 서드파티 AI 확장 프로그램 설치하기
GitHub, Linear, Jira, Notion 등의 클라우드 도구를 AI와 연동하려면 다음 단계를 진행합니다:
- Raycast 단축키(예:
⌥ Space또는⌘ Space)를 눌러 루트 검색창을 엽니다. Store를 입력하고 Enter 키를 누릅니다.- 상단 내비게이션 바에서
⌘ P를 눌러 카테고리 필터 메뉴를 엽니다. - AI Extensions 카테고리를 선택합니다. AI Tools를 구현한 확장 프로그램만 선별되어 표시됩니다.
- 연동할 확장 프로그램(예: GitHub, Linear, Notion, Todoist, Spotify)을 선택하고 Enter 키를 눌러 설치합니다.
- 계정 인증을 완료합니다. 설치 후 안내에 따라 웹 브라우저 OAuth 로그인을 진행하거나, 확장 프로그램 설정에서 개인 액세스 토큰(PAT / API Key)을 입력합니다.
3. AI Chat에서 도구 호출 및 다중 도구 연계
확장 프로그램이 설치되면 도구가 전역 컨텍스트에 등록되어 AI Chat(AI Chat 명령 실행 또는 Quick AI에서 ⌘ J 입력)에서 바로 사용할 수 있습니다.
@ 멘션 문법
AI Chat 입력창에서 @를 입력하면 Mac에 설치된 사용 가능한 모든 AI 도구 및 확장 프로그램 목록이 드롭다운으로 표시됩니다. 목록에서 선택하거나 식별자를 직접 입력합니다:
@github 나에게 리뷰가 할당된 오픈된 Pull Request를 조회하고, 머지를 막고 있는 주요 피드백을 요약해 줘.
@linear Platform 팀에 우선순위 High로 "Webhook 수신 속도 제한 구현" 티켓을 생성하고 현재 활성 Cycle에 배정해 줘.
@browser 브라우저에 열려 있는 API 공식 문서 페이지를 분석해서 이번 버전의 주요 Breaking Changes를 정리해 줘.
Enter 키를 누르면 AI 모델이 필요한 매개변수를 판단하여 백그라운드에서 확장 프로그램의 도구를 호출합니다. 채팅창에는 실행 상태 카드가 표시되며, 전달된 입력값과 반환된 응답 데이터를 투명하게 확인할 수 있습니다.
단일 프롬프트에서 여러 도구 체이닝(Chaining)
개발자와 고급 사용자가 가장 유용하게 활용할 수 있는 패턴은 서로 다른 서비스를 하나의 프롬프트로 엮어 자동화하는 것입니다:
@calendar @linear 오늘 오후에 1시간 이상 비어 있는 시간이 있는지 확인하고, 비어 있다면 현재 스프린트에서 내가 처리해야 할 미완료 Linear 티켓 목록을 가져와 줘.
@terminal @github 현재 작업 디렉터리의 git status를 확인하고, 최근 커밋 내역을 바탕으로 GitHub에 올릴 표준 PR 설명 초안을 작성해 줘.
이 요청을 받으면 모델은 단계별 계획(Step-by-step)을 세웁니다. 먼저 캘린더나 로컬 Git 상태를 확인해 중간 정보를 수집하고, 그 컨텍스트를 활용해 Linear 티켓을 조회하거나 PR 본문을 완성합니다. 사용자가 일일이 창을 오가며 복사해 넣을 필요가 없습니다.
4. 권한 제어, 자동 검토 규칙 및 보안 설정
AI Tools는 쉘 명령을 실행하거나 로컬 파일을 수정하고 클라우드 데이터베이스를 변경할 수 있는 막강한 권한을 가지므로 적절한 보안 경계를 구성해야 합니다.
전역 권한 레벨 설정
Settings → AI → Tools로 이동하여 시스템 전역 보안 정책을 설정합니다:
| 권한 모드 | 동작 방식 | 권장 사용자 환경 |
|---|---|---|
| Ask | 읽기 전용 작업이나 사전 승인되지 않은 모든 도구 호출 시 대화를 멈추고 팝업으로 사용자 승인을 요청합니다. | 고보안 환경; 엄격한 규정이 요구되는 업무용 기기 |
| Auto (Pro 기본값) | 안전성을 자동 평가합니다. 안전한 조회나 로컬 작업은 자동 실행하고, 파괴적 변경이나 비밀 정보 접근 시 승인을 요구합니다. | 개발자 및 파워 유저; 일상적인 개발 환경; 편의성과 안전성의 균형 |
| Always Allow | 확인 창을 띄우지 않고 모든 도구 호출을 즉시 자동으로 실행합니다. | 독립된 샌드박스 테스트 환경; 고도로 통제된 자동화 워크플로 |
Auto 모드의 판단 기준
Raycast의 Auto 엔진은 명확한 보안 규칙에 따라 동작합니다:
- 승인 없이 자동 실행: 읽기 전용 데이터 조회(티켓 목록 조회, 캘린더 확인, 파일 검색), 대화창에 지정된 작업 디렉터리 내부의 파일 수정, 안전한 일상 개발 명령어(
git status,git log,npm test등). - 반드시 일시 중지 후 사용자 승인 요청: 파괴적 작업(파일 삭제, 데이터베이스 레코드 삭제, 티켓 일괄 닫기), 시스템 환경을 변경하는 쉘 스크립트, 민감한 자격 증명 파일 접근 시도(
.env파일, SSH 개인 키id_rsa, 클라우드 액세스 키 등).
Settings → AI → Tools의 Auto-review Rules 메뉴에서 특정 동작을 "Allow automatically" 또는 "Ask first"로 연결하는 자연어 규칙을 추가하여 미세 조정할 수도 있습니다.
승인 대화상자 인터랙션 및 단축키
도구 승인이 필요할 때 AI Chat은 실행을 멈추고 카드 형태의 안내를 띄웁니다:
Return키: 이번만 허용(Allow). 현재 호출만 실행합니다.⌘ Return키: 항상 허용(Always Allow). 해당 도구가 Globally Allowed Tools 목록에 등록되어 다음부터는 확인 없이 실행됩니다.Esc키: 거부(Deny). AI에게 거부 사실이 전달되며 도구 호출 없이 대화가 이어집니다.@terminal을 통한 명령어 실행 시에는 Show Command를 클릭하여 실행될 쉘 스크립트 전문을 사전에 검토할 수 있습니다.
대화별 개별 권한 재정의
특정 테스트나 대화 세션에서만 전역 설정과 다른 권한 정책을 쓰고 싶다면 전역 설정을 바꿀 필요가 없습니다. AI Chat 우측 설정 사이드바의 Permissions 항목(또는 ⌘ K 입력 후 Change Permissions… 선택)에서 해당 세션만 Inherited, Ask, Auto, Always Allow로 즉시 전환할 수 있습니다.
5. 확장 프로그램별 커스텀 지침(Custom Instructions)으로 동작 최적화
Linear나 GitHub을 사용할 때 대규모 언어 모델은 사용자가 속한 팀의 조직 구조나 업무 규칙을 알지 못합니다. Raycast에서는 각 확장 프로그램별로 고유한 지침을 등록할 수 있습니다:
- Raycast Settings → Extensions로 이동합니다.
- 좌측 목록에서 대상 확장 프로그램(예: Linear 또는 Calendar)을 선택합니다.
- 우측 화면에서 일반 명령들과 함께 나열된 Ask 도구를 찾습니다.
- 해당 도구를 펼치고 Custom Instructions 텍스트 입력 칸을 확인합니다.
- 모델이 해당 확장 프로그램의 도구를 호출할 때 반드시 지켜야 할 업무 규칙을 작성합니다.
실무 추천 지침 예시
Linear 지침 예시:
모든 티켓 검색과 생성 작업은 "Platform Engineering" 팀을 기본값으로 지정하십시오. 티켓 생성 시 별도의 우선순위가 언급되지 않으면 "Medium"으로 설정하고, 현재 진행 중인 Active Cycle에 연결하십시오.
Calendar 지침 예시:
오전 10:00 이전이나 오후 17:30 이후에는 미팅 일정을 잡거나 제안하지 마십시오. 연속된 일정 사이에는 최소 15분의 버퍼 시간을 반드시 유지하십시오.
GitHub 지침 예시:
Pull Request를 조회할 때는 "octocorp-dev" 조직 산하의 레포지토리만 대상으로 하십시오. 리뷰 대기 목록을 생성할 때는 dependabot이 자동 생성한 종속성 업데이트 PR은 제외하십시오.
지침을 저장해 두면 채팅창에서 @linear나 @calendar를 부를 때마다 해당 규칙이 모델의 시스템 컨텍스트에 자동 주입되어 매번 동일한 제약 조건을 반복 입력할 필요가 없습니다.
6. 고급 확장: Model Context Protocol (MCP) 서버 연동
공식 스토어 확장 프로그램이 지원하지 않는 내부 데이터베이스, 프라이빗 마이크로서비스, 사내 인프라 도구가 있다면 Model Context Protocol (MCP) 서버를 Raycast AI에 연동할 수 있습니다.
- Raycast 검색창에서 Install MCP Server 명령을 실행합니다(또는 Manage MCP Servers → Install New Server 선택).
- 서버 연결 정보를 구성합니다:
- Name & Icon: 채팅에서
@로 호출할 이름과 아이콘 설정. - Transport: 로컬 프로세스는 Standard Input/Output (stdio), 원격 엔드포인트는 HTTP 선택.
- Command & Arguments: 로컬 CLI 도구의 실행 파일 경로 및 인자(예:
npx -y @modelcontextprotocol/server-postgres또는 로컬 Python 스크립트). - Environment: 데이터베이스 접속 문자열이나 내부 API 인증 토큰을 환경 변수로 주입.
- Name & Icon: 채팅에서
⌘ Return으로 저장합니다. Raycast가 백그라운드에서 프로세스를 구동하고 JSON-RPC를 통해 도구 목록을 즉시 동기화합니다.
연동된 MCP 도구는 일반 확장 프로그램과 완전히 동일하게 작동합니다. 채팅창에서 @postgres 지난주 신규 가입자 수를 집계해 줘와 같이 호출할 수 있으며 동일한 권한 제어가 적용됩니다.
7. 파워 유저를 위한 생산성 권장 사항
- 전역 전용 단축키 지정:
Settings → Extensions → AI → AI Chat에서 전용 단축키(예:⌥ C또는⌃ Space)를 매핑하여 어떤 작업 공간에서도 즉시 도구 대화창을 호출하십시오. - 화면 인식과 선택 텍스트 결합: IDE나 터미널에서 에러 로그를 드래그한 상태로 Quick AI를 열고
@github 선택한 에러 메시지와 일치하는 해결된 이슈 찾아줘를 입력하면 화면 전환 없이 문제를 추적할 수 있습니다. - 허용된 도구 목록 정기 검토:
Settings → AI → Tools → See Allow List를 주기적으로 확인하십시오. 확장 프로그램이 업데이트되었거나 보안 요구 사항이 변경되었을 때는 Reset All을 눌러 표준 승인 상태로 재설정하는 것이 안전합니다.
Raycast AI Tools를 올바르게 구성하면 로컬 Finder와 터미널 환경, 클라우드 협업 도구가 키보드 하나로 긴밀하게 결합되어 강력한 데스크톱 에이전트 워크스페이스가 완성됩니다.