Mac에서 Raycast에 MCP 서버를 추가하는 방법
요약: Raycast AI는 MCP 도구를 호출할 수 있습니다. LMCP는 Mail, 캘린더, 메시지, 파일, Teams 등을 위한 201+개의 로컬 도구를 제공합니다. 이미 사용하는 런처에서 Mac 위에서 직접 실행됩니다.
Raycast AI에게 이메일 계정을 나열하거나 읽지 않은 이메일을 요약해 달라고 요청하세요. 도구는 Mac에서 로컬로 실행됩니다.
평균 4.7점 (5점 만점) · 평가 수: 39모든 리뷰 보기 →
“calander and reminders”
Shawn E.“Sort, clean up inbox. Text people reminders for payments using imessage”
Adi H.“Claude Zugriff auf Mails /Kalender gewähren”
TB
LMCP가 Raycast을(를) 설정하는 방법 — Mac: 앱 자체의 MCP 설정에서 · Windows: 앱 자체의 MCP 설정에서
LMCP는 기기에서 로컬 도구를 실행합니다. 클라우드 AI 제공업체와 연결된 서비스는 요청한 데이터를 받을 수 있으며, 해당 서비스의 약관이 적용됩니다.
Raycast에 MCP 서버를 추가하는 이유
Raycast는 Mac 고급 사용자가 늘 사용하는 런처입니다. 키 한 번으로 검색하고, 전환하고, 계산할 수 있습니다. Raycast AI는 같은 창에 채팅 모델을 제공하지만, 기본 상태에서 모델은 대화만 할 수 있습니다. 받은 편지함, 캘린더, 파일은 볼 수 없습니다.
MCP(Model Context Protocol)가 이 간극을 메웁니다. MCP 서버는 “내 이메일 검색”, “오늘의 일정 나열”, “그 PDF 찾기” 같은 실제 작업을 AI가 호출할 수 있는 도구로 제공합니다. Raycast에 서버를 추가하면 Quick AI는 챗봇을 넘어 Mac을 조작하는 비서가 됩니다.
문제는 대부분의 MCP 서버가 앱 하나만 지원하므로, 유용한 구성을 만들려면 서버 다섯 개나 여섯 개를 설치하고 유지해야 한다는 점입니다. LMCP는 반대 방식을 택합니다. 서명된 설치 프로그램 하나, 서버 하나, 약 24개 앱 영역에 걸친 201+개 도구를 제공합니다. 같은 설치로 Claude Desktop, Cursor, VS Code에도 연결되므로 Raycast만을 위한 별도 구성이 필요하지 않습니다.
준비 사항
- macOS 13(Ventura) 이상 — Apple Silicon 또는 Intel
- Raycast Pro를 사용하는 Raycast — 사용자 지정 MCP 서버는 AI(Pro) 기능입니다
- Node.js — Raycast는 stdio를 통해
npx로 LMCP를 실행합니다 - LMCP — 약 30초면 설치됩니다(다음 단계)
연결할 앱의 API 키, OAuth 토큰이나 계정은 필요하지 않습니다. LMCP는 macOS의 네이티브 API를 통해 Mail.app, 캘린더, 메시지 등과 통신하므로, Mac에 이미 설정된 항목을 AI가 그대로 사용합니다.
1단계: Mac에 LMCP 설치하기
앱을 다운로드 (macOS 13 이상)하고 설치 프로그램을 실행하세요. 어느 방법을 사용하든 메뉴 막대에 LMCP가 나타나고, Claude Desktop과 Cursor 같은 데스크톱 클라이언트가 자동으로 설정됩니다.
터미널로 설치
curl -fsSL 'https://local-mcp.com/install?ref=guide-raycast-mac' | bash처음 사용할 때 macOS가 LMCP의 각 앱(Mail, 캘린더 등) 접근을 허용할지 묻습니다. “허용”을 클릭하세요. 앱별 동의가 보안 모델의 핵심이며, 승인하기 전에는 어떤 항목에도 접근할 수 없습니다.
2단계: Raycast에 LMCP 추가하기
- Raycast를 열고 Manage MCP Servers 명령을 실행합니다.
- Cmd + N을 눌러 서버를 추가한 다음, 아래 JSON을 붙여넣습니다.
{
"command": "npx",
"args": ["-y", "local-mcp@latest"]
}양식을 제출하세요. Raycast는 npx를 사용해 stdio로 서버를 실행하므로 Node.js가 설치되어 있어야 합니다. @latest 태그는 Raycast가 항상 최신 릴리스를 시작한다는 뜻이므로, 수동으로 업데이트할 항목이 없습니다.
3단계: 직접 사용해 보기
Raycast AI(Quick AI 또는 AI Chat)를 열고 요청하세요.
내 이메일 계정을 나열해 줘Raycast가 Mac에서 도구를 호출하고, 런처를 벗어나지 않은 채 결과를 보여 줍니다. 이어서 사람들이 실제로 사용하는 프롬프트를 시도해 보세요.
- “읽지 않은 이메일을 요약해 줘” — 런처 창에서 받은 편지함을 분류합니다.
- “오늘 내 캘린더에 어떤 일정이 있어?” — Calendar.app을 직접 읽습니다.
- “다운로드 폴더에서 3분기 계약에 관한 PDF를 찾아 줘” — 실제 파일을 검색합니다.
- “Ana에게 10분 늦는다고 메시지를 보내 줘” — iMessage 초안을 작성하고 보내기 전에 보여 줍니다.
- “오늘 아침 Teams에서 내가 놓친 내용이 뭐야?” — 채널과 채팅의 최근 내용을 정리합니다.
상태를 변경하는 도구를 승인하기 전에 해당 플랫폼에서 현재 요구하는 미리보기와 확인 절차를 검토하세요. 이러한 보호 장치는 도구와 AI 클라이언트마다 다릅니다.
LMCP로 Raycast AI가 할 수 있는 일
서버 하나로 201+개 도구를 사용할 수 있습니다. 런처에서 가장 많이 사용하는 영역은 다음과 같습니다.
- Mail — 메시지 목록 조회, 읽기, 검색, 보내기, 답장, 이동, 첨부 파일 저장(Mail.app에 있는 모든 계정: Gmail, iCloud, Outlook, Exchange, IMAP)
- 캘린더 — 여러 캘린더의 일정 조회, 일정 생성, 수정 및 삭제
- 메시지 — iMessage 대화 읽기와 검색, 메시지 보내기
- 파일 및 Finder — 파일과 폴더 검색, 목록 조회, 읽기 및 쓰기
- 메모 및 미리 알림 — 메모 생성과 검색, 미리 알림 목록 관리
- 연락처 — 사람, 전화번호 및 주소 조회
- Microsoft 365 — Outlook 메일과 캘린더, Teams 채널과 채팅, OneDrive 파일
- Office 문서 — Excel, Word 및 PowerPoint 파일 읽기와 생성, PDF 읽기
- WhatsApp 및 Slack — 연결된 경우 읽기, 검색 및 보내기
모든 도구가 같은 세션에서 실행되므로 Raycast AI가 도구를 연이어 사용할 수 있습니다. 이메일을 읽고, 캘린더의 일정 충돌을 확인하고, 답장 초안을 작성합니다. 프롬프트 하나로 앱 세 개를 사용하며 창을 전환할 필요가 없습니다.
어떤 계정과 앱을 사용할 수 있나요?
LMCP는 서비스에 연결하는 것이 아니라 Mac에 있는 앱에 연결하고, 그 앱에 이미 등록된 모든 계정을 그대로 사용합니다.
- 이메일 — Mail.app에 설정된 모든 계정: Gmail, iCloud, Outlook.com, Exchange / Microsoft 365 또는 모든 IMAP 제공업체. 여러 계정을 동시에 사용할 수 있으며, “회사 이메일로 보내 줘”처럼 사용할 계정을 지정할 수 있습니다.
- 캘린더 — 구독 및 공유 캘린더를 포함해 Calendar.app에 표시되는 모든 캘린더.
- 메시지 — 이 Mac에서 로그인한 계정의 iMessage 대화.
- Microsoft 365 — Outlook, Teams 및 OneDrive는 기존 회사 계정으로 연결합니다.
Mac에서 볼 수 있다면 Raycast AI도 접근할 수 있습니다. 앱 자체가 연동 수단이므로 별도의 “지원 제공업체” 목록을 확인할 필요가 없습니다.
서버 하나와 단일 앱 서버 여러 개 비교
Raycast에서 사용할 MCP 서버를 검색하면 Apple Mail 서버, 캘린더 서버, 파일 시스템 서버 등 완성도 높은 단일 목적 프로젝트가 많이 나옵니다. 이들도 잘 작동하며, 직접 구성을 조립하는 것을 즐긴다면 좋은 선택입니다. 솔직하게 비교하면 다음과 같습니다.
| 선택지 | 지원 범위 | 설정 및 유지 관리 | 다른 AI 클라이언트에서도 사용 가능 |
|---|---|---|---|
| LMCP(Local MCP) | Mail, 캘린더, 메시지, 파일, Teams, Office — 서버 하나에 201+개 도구 | 서명된 설치 프로그램, 자동 업데이트, Raycast 항목 하나 | 예 — Claude Desktop, Cursor, VS Code와 클라우드 릴레이를 통한 ChatGPT 및 Claude.ai |
| 단일 앱 오픈 소스 서버 | 각각 앱 하나 — Mail 서버, 캘린더 서버, 파일 서버 등 | 서버마다 Python 또는 Node 설정, 각각의 Raycast 항목, 수동 업데이트 | 클라이언트별로 각 서버를 따로 설정 |
| MCP 없는 Raycast | Raycast AI가 모델만으로 답변 — 앱이나 파일에 접근 불가 | 설정할 것 없음 | — |
정리하면, 앱 하나를 위한 최소한의 구성을 직접 수정하며 쓰고 싶다면 단일 목적 서버를 선택하세요. 한 번의 2분 설치로 Raycast AI가 Mac 전체를 사용할 수 있게 하고, 같은 서버를 다른 모든 MCP 클라이언트에도 연결해 두고 싶다면 LMCP를 선택하세요.
로컬 도구와 데이터의 경계
- LMCP는 컴퓨터의 로컬 서버로 실행되며, Raycast가 stdio를 통해 시작합니다
- macOS 네이티브 API로 앱을 읽으며, 스크래핑이나 클라우드 동기화를 하지 않습니다
- 도구 결과는 Mac에서 현재 진행 중인 AI 대화로 전달됩니다. 클라우드 기반 AI 제공업체는 자체 데이터 처리 약관에 따라 요청한 결과를 받습니다
- 어떤 도구든 앱에 접근하려면 먼저 해당 앱에 대한 명시적인 macOS 권한 승인이 필요합니다
API 키와 OAuth가 없다는 것은 유출될 수 있는 타사 토큰도 없다는 뜻입니다. 이메일, 일정 및 파일은 원래 있던 곳, 즉 컴퓨터의 앱 안에 그대로 남습니다.
런처에서 MCP 도구를 최대한 활용하기
런처에서는 짧은 프롬프트가 편리하지만, 프롬프트가 짧으면 모델이 기억에 의존해 답해야 할지 도구를 호출해야 할지 판단하기 어려울 때가 있습니다. 다음 세 가지 습관이 차이를 만듭니다.
- 내 데이터를 명시하세요. “내 캘린더를 확인해 줘”, “내 이메일을 검색해 줘”라고 하면 답이 모델의 일반 지식이 아니라 Mac에 있다는 신호가 됩니다.
- 하나의 프롬프트로 작업을 연결하세요. 서버 하나에 201+개 도구가 있는 이유는 요청 하나가 여러 앱에 걸칠 수 있기 때문입니다. “청구서 이메일을 찾아서 첨부 파일을 데스크탑에 저장하고, 금요일에 결제하도록 미리 알림을 추가해 줘.” 도구 세 개를 키 한 번으로 사용합니다.
- 미리보기를 활용하세요. 보내기, 이동, 삭제 작업은 무엇이 일어날지 정확히 보여 줍니다. 내용이 맞으면 빠르게 승인해도 되지만, 반드시 읽어 보세요. 이 미리보기가 런처 속도로 진행되는 작업을 안전하게 만드는 안전망입니다.
문제 해결
“Manage MCP Servers” 명령이 없습니다
사용자 지정 MCP 서버는 Raycast Pro가 필요한 Raycast AI 기능입니다. Raycast Settings에서 업그레이드한 뒤 명령을 다시 검색하세요. Pro 없이 사용해 보고 싶다면 Claude Desktop 같은 클라이언트에서도 LMCP가 작동합니다.
서버가 시작되지 않습니다
흔한 원인은 두 가지입니다. LMCP 앱이 실행되지 않았거나(메뉴 막대 아이콘을 확인하고, 없으면 응용 프로그램에서 실행하세요), npx가 Raycast가 사용하는 PATH에 없는 경우입니다. nodejs.org에서 Node.js를 설치하면 표준 위치에 설치됩니다. 설치한 뒤 서버 항목을 제거하고 다시 추가하세요.
알아차리기 어려운 경우도 있습니다. nvm으로 설치한 Node는 셸 프로필에 설정되지만, Raycast 같은 GUI 앱은 이 프로필을 읽지 않습니다. 그래서 터미널에서는 npx가 작동해도 Raycast에서는 실패할 수 있습니다. 확실한 해결 방법은 공식 설치 프로그램이나 Homebrew로 Node를 시스템 전체에 설치하는 것입니다.
AI가 도구를 사용하지 않고 답변합니다
“내 이메일 계정을 나열해 줘”, “오늘 내 캘린더에 어떤 일정이 있어?”처럼 내 데이터가 분명히 필요한 질문을 하세요. 모델이 여전히 기억에 의존해 답한다면 Manage MCP Servers에서 LMCP 항목이 실행 중으로 표시되는지 확인하고 새 AI 채팅을 시작하세요.
도구에서 권한 거부 오류가 발생합니다
macOS는 각 앱에 명시적인 접근 권한을 요구합니다. 시스템 설정 > 개인정보 보호 및 보안 > 자동화로 이동해 LMCP가 해당 도구에 필요한 앱(Mail, 캘린더, 메시지 등)에 접근할 수 있는지 확인하세요. 일반적으로 각 앱을 처음 호출하면 권한 요청이 표시됩니다. 이를 닫았다면 여기에서 수정할 수 있습니다.
실제 활용 워크플로
Quick AI에 바로 붙여넣을 수 있는 프롬프트입니다.
Mail을 열지 않고 받은 편지함 분류하기
읽지 않은 이메일을 요약하고, 긴급한 항목에 깃발을 표시하고, 오늘 답장이 필요한 이메일을 각각 한 줄짜리 답장 제안과 함께 나열해 줘.
런처가 아침 메일 분류 도구가 됩니다. 창 하나를 열기도 전에 내용을 읽고, 우선순위를 정하고, 답장 초안까지 준비합니다.
키 한 번으로 회의 준비하기
30분 뒤 Sarah와 회의가 있어. 최근 이메일 대화 세 개, 그녀의 프로젝트를 언급하는 메모, 그 프로젝트와 관련된 내 미완료 미리 알림을 찾아서 한 페이지짜리 브리핑을 만들어 줘.
이메일, 메모, 미리 알림을 한 번에 조회해 브리핑으로 요약합니다. 단일 목적 서버로는 할 수 없는 앱 간 연속 작업입니다.
파일을 찾아 보내기
내 다운로드 폴더에서 이름에 “invoice”가 들어간 가장 최근 PDF를 찾아, 짧은 설명을 덧붙여 accounting@example.com으로 이메일을 보내 줘.
프롬프트 하나로 파일 검색과 이메일 작성을 처리합니다. 무엇이든 보내기 전에 LMCP가 발신 메시지를 보여 주고 확인을 받습니다.
한 주를 마무리하는 요약
이번 주 이메일과 Teams 메시지를 살펴보고, 프로젝트별로 묶어서 결정된 사항과 아직 내 처리를 기다리는 사항을 짧게 요약해 줘. “Week review”라는 제목의 메모로 저장해 줘.
한 주 동안 흩어져 있던 대화를 메모 하나로 압축합니다. 잃어버리기 쉬운 채팅 창이 아니라 실제 메모가 보관되는 곳에 생성됩니다.
LMCP로 또 무엇을 할 수 있나요?
같은 설치로 사용하는 모든 MCP 클라이언트에 연결할 수 있습니다. Claude로 Apple Mail 사용하기, OAuth 없이 캘린더 사용하기, API 키 없이 Microsoft Teams 사용하기 또는 전체 가이드 목록에서 201+개 도구로 접근할 수 있는 모든 항목을 확인하세요.
자주 묻는 질문
Raycast에 MCP 서버를 어떻게 추가하나요?
Raycast에서 Manage MCP Servers 명령을 실행하고 Cmd+N을 누른 다음 { "command": "npx", "args": ["-y","local-mcp@latest"] }를 붙여넣으세요. 사용자 지정 MCP 서버에는 Raycast Pro가 필요합니다.
MCP 서버를 사용하려면 Raycast Pro가 필요한가요?
네. 사용자 지정 MCP 서버는 Raycast AI(Pro) 기능입니다. LMCP는 로컬에서 실행됩니다. 같은 설치로 Claude Desktop, Cursor, VS Code 같은 클라이언트에서도 사용할 수 있습니다.
LMCP로 Raycast AI가 무엇을 할 수 있나요?
LMCP는 Raycast AI에 201+개의 로컬 Mac 도구를 제공합니다. Mail, 캘린더, 연락처, iMessage, 메모, 미리 알림, 파일, Microsoft Teams, OneDrive, Office 문서 등을 모두 Mac에서 실행하며, 하나의 프롬프트로 연이어 사용할 수 있습니다.
API 키나 앱 암호가 필요한가요?
아니요. LMCP는 macOS 네이티브 API를 통해 앱에 접근하므로, Mac에 이미 설정된 모든 Mail 계정, 캘린더, 채팅을 키나 OAuth, 암호 없이 사용할 수 있습니다. macOS가 앱마다 명시적인 권한 승인을 요청합니다.
내 데이터가 클라우드로 전송되나요?
LMCP는 로컬 도구를 실행하고 요청한 결과를 AI 클라이언트에 반환합니다. Raycast의 모델이 이 결과를 처리합니다. 클라우드 기반 모델이라면 해당 제공업체가 자체 데이터 처리 약관에 따라 그 내용을 받습니다.
바로 사용할 수 있는 레시피
같은 도구를 사용하는 복사 및 붙여넣기용 워크플로입니다.
관련 가이드
댓글
댓글은 게시 전에 검토됩니다.