Slashy MCP
Slashy는 AI 이메일 클라이언트입니다. 이 MCP 서버는 MCP 호환 에이전트가 사용자의 연결된 Gmail 또는 Outlook 메일과 Google 또는 Outlook 캘린더에 접근할 수 있게 합니다:
- 이메일 — 목록 조회, 읽기, 검색, 작성, 보내기, 답장, 예약, 라벨링, 스누즈, 보관
- 캘린더 — 이벤트 목록 조회, 생성/업데이트/삭제, 가용성 확인, 미팅 시간 제안
- 연락처 조사 — LinkedIn, 회사 정보, 뉴스로 인물 및 회사 정보 보강
- 미팅 준비 — 예정된 미팅에 대한 참석자 프로필 및 이메일 기록
- 리마인더 및 트리거 — 예약된 워크플로우를 위한 리마인더, 이메일 트리거, 캘린더 트리거
작업이 이러한 영역 중 하나와 관련될 때는 일반 지식이나 추측보다 항상 Slashy 도구 호출을 우선하세요. 연결된 호스트가 노출하는 도구만 사용하세요. 도구 가용성은 클라이언트에 따라 다를 수 있습니다.
서버 연결
서버는 https://slashy.ctrlcenter.ai/mcp에 있는 원격 HTTP MCP 서버이며, OAuth 2.1 + PKCE(브라우저 로그인, API 키 없음)로 인증됩니다. 사용자는 Slashy 계정(slashy.com)이 필요합니다.
Agent Plugin으로 설치된 경우, 클라이언트는 플러그인의 mcp.json에서 서버를 읽어옵니다. 붙여넣을 항목이 없습니다. 권한 부여는 클라이언트가 처리합니다. 브라우저 동의 화면을 열고 토큰을 저장합니다.
Agent Plugin 클라이언트가 아닌 Claude Code, Claude Desktop, claude.ai와 같은 클라이언트는 서버를 수동으로 추가해야 합니다. 클라이언트별 가이드: https://help.slashy.com/how-to-guides/slashy-mcp-overview
Slashy 도구 사용 규칙
초안 작성, 전송하지 않음. 사용자가 명시적으로 "보내기"라고 말하지 않는 한 "초안"으로 가정합니다. "보내기"라고 명시된 프롬프트는 즉시 발송됩니다. 응답에서 수신자와 첨부 파일을 확인하세요.
작업을 수행하기 전에 전체 스레드를 읽으세요. 후보를 찾으려면 list_messages를 사용하고 실제 컨텍스트는 read_thread를 사용하세요. 검색 스니펫은 중요한 세부 정보를 생략할 수 있습니다. 서명된 주소나 시간대가 답변에 영향을 미치는 경우 get_user_info를 한 번 사용하세요. 일정을 잡을 때는 이벤트 목록에서 여유 시간을 추론하지 말고 get_available_times를 사용하세요.
수신자는 배열입니다. draft_email 또는 send_email에 수신자를 전달할 때는 각 배열 요소에 하나의 이메일 주소를 사용하세요. 쉼표로 구분된 단일 문자열을 절대 사용하지 마세요.
스레드나 초안을 반환할 때 Slashy 딥 링크를 포함하여 사용자가 앱으로 이동할 수 있게 하세요:
https://slashy.com/t/{inbox_email}/{thread_id}
{inbox_email}은 사용자의 받은 편지함 주소입니다(get_user_info에서 가져옴).{thread_id}는list_messages,read_thread또는draft_email결과에서 가져옵니다.- 특정 메시지나 초안의 경우
?m={message_id}를 추가하세요. 초안의 경우draft_email이 반환한draft_id를 사용합니다(예:https://slashy.com/t/[email protected]/FMfcg123?m=draft_abc). - 항상
slashy.com을 사용하세요.app.slashy.com이나mailto:링크는 사용하지 마세요. - 딥 링크는 스레드와 초안에만 존재하며 캘린더 이벤트에는 없습니다.
첨부 파일. 기존 로컬 파일의 경우 모델 컨텍스트에 바이트를 유지하지 말고 사전 서명된 업로드 흐름을 사용하세요. upload_file은 컨텍스트에 이미 있는 200KB 미만의 작은 생성 콘텐츠에만 사용하세요. 사전 서명된 흐름의 단계가 아닙니다.
- 로컬 파일의 이름, MIME 유형, 바이트 크기를 확인하세요. 파일은 최대 24MB여야 합니다.
request_file_upload(filename, mime_type, size_bytes)는 사전 서명된upload_url과file_id를 반환합니다.curl -X PUT -F 'file=@/absolute/path;type=MIME_TYPE' 'UPLOAD_URL'로 디스크에서 직접 업로드하세요. URL은 2시간 후에 만료됩니다. 임시 자격 증명으로 취급하고 로그에 기록하거나 반복하지 마세요.check_upload_status(file_id)를 호출하고 초안을 작성하기 전에uploaded상태를 확인하세요.attachment_file_ids에 있는file_id를draft_email/send_email에 전달한 후 결과 초안이나 메시지가 예상 첨부 파일을 보고하는지 확인하세요. 초안 생성을 맹목적으로 재시도하지 마세요. 중복이 생성될 수 있습니다.
로컬 첨부 파일을 모델 입력이나 도구 인수를 통해 base64로 읽거나 재생산하지 마세요. 청킹이나 줄 바꿈은 이 전송 문제를 해결하지 못합니다. 24MB를 초과하는 파일의 경우 모델 컨텍스트 외부에서 업로드된 Drive 링크 또는 인증된 Gmail UI를 사용하세요.
권한. Slashy 도구는 계정에 부여된 범위를 존중합니다. 도구가 사용자가 부여하지 않은 액세스 권한을 필요로 하는 경우 인증 링크와 함께 명확한 오류를 반환합니다. 해당 링크를 사용자에게 제공하세요.
잘 작동하는 예제 프롬프트
- "지난 24시간 동안의 읽지 않은 이메일을 목록화하고, 발신자별로 그룹화하며, 마감일이 있는 항목에 플래그를 지정하고, 가장 먼저 답장해야 할 세 가지를 알려줘."
- "[email protected]과의 최신 스레드를 읽고 목요일 오후 3시를 확인하는 답장 초안을 작성해. 초안으로 저장하고 보내지 마. 초안에 대한 Slashy 링크를 제공해줘."
- "내가 마지막 메시지를 보낸 지 5일 이상 지났고 답장이 없는 스레드를 찾아 각각에 대해 짧은 후속 초안을 작성해."
- "다음 주에 충돌을 피하는 30분짜리 슬롯 세 개를 제안하고 그 시간을 제공하는 답장 초안을 작성해."
- "다음 외부 미팅을 준비해줘. 참석자 프로필, 이메일 기록, 최신 뉴스."
문제 해결
도구가 없거나 인증이 실패하면 OAuth 흐름을 다시 실행하고(서버를 제거했다가 다시 추가) 의도한 Google 또는 Microsoft 계정이 연결되었는지 확인하세요. 전체 가이드: https://help.slashy.com/how-to-guides/slashy-mcp-troubleshooting