# royal-ms365-mcp

로얄앤컴퍼니 사내 MCP 서버.  
MS365 Graph API(이메일·캘린더·Teams·SharePoint·OneDrive)를 Claude Code에서 직접 사용할 수 있게 연결합니다.

> 소요 시간: 약 10분 | 대상: 일반 직원

---

## 목차

- [1. 사전 확인](#1-사전-확인)
- [2. 설치 경로 제한](#2-설치-경로-제한)
- [3. 프로젝트 파일 내려받기](#3-프로젝트-파일-내려받기)
- [4. 패키지 설치](#4-패키지-설치)
- [5. Claude Code 연결](#5-claude-code-연결)
- [6. 첫 실행 및 MS365 로그인](#6-첫-실행-및-ms365-로그인)
- [7. 보안 주의사항 — 토큰 캐시 파일 관리](#7-보안-주의사항--토큰-캐시-파일-관리)
- [8. 프롬프트 모음](#프롬프트-모음)

---

## 1. 사전 확인

| 항목 | 확인 방법 | 필요 버전 |
|------|-----------|-----------|
| Python | `python --version` | 3.11 이상 |
| Claude Code | `claude --version` | 최신 |

Python이 없으면 [python.org](https://python.org)에서 설치 (설치 시 **"Add to PATH"** 체크).

---

## 2. 설치 경로 제한

경로에 **한글·공백 불가** (Python 가상환경 경로 파싱 오류)

```
✅ C:\royal-ms365-mcp\
✅ D:\tools\royal-ms365-mcp\
✅ C:\Users\kjr\royal-ms365-mcp\
❌ C:\내 문서\royal-ms365-mcp\      ← 한글 포함 불가
❌ D:\My Documents\royal-ms365-mcp\ ← 공백 포함 불가
```

---

## 3. 프로젝트 파일 내려받기

관리자(정보관리팀)로부터 받은 **`royal-ms365-mcp.zip`** 파일을 설치할 위치에 압축 해제합니다.

### 압축 해제 방법

**방법 — 탐색기**

1. `royal-ms365-mcp.zip` 파일을 설치할 위치로 복사합니다.
2. 파일을 마우스 오른쪽 버튼으로 클릭 → **"모두 압축 풀기"** 선택
3. 압축 풀기 경로를 확인합니다.  
   예: `C:\` 에서 압축을 풀면 → `C:\royal-ms365-mcp\` 폴더가 생성됩니다.
4. **"압축 풀기"** 버튼을 클릭합니다.

---

## 4. 패키지 설치

운영체제에 맞는 스크립트를 실행합니다.

**Windows — PowerShell**

> ⚠ **반드시 PowerShell에서 실행하세요.** 명령 프롬프트(CMD)에서는 실행되지 않습니다.  
> 시작 메뉴에서 **"Windows PowerShell"** 을 검색해 열거나, **Win + X** 단축키를 누른 후 **터미널(또는 Windows PowerShell)**을 실행하세요.

```powershell
cd {설치경로(royal-ms365-mcp)}
.\setup.ps1
```

> 실행 오류 시: `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 입력 후 재시도

**Mac / Linux — 터미널**

```bash
cd {설치경로(royal-ms365-mcp)}
bash setup.sh
```

> **개발자 (HTTP 모드 포함)**: `.\setup.ps1 -Dev` 또는 `bash setup.sh --dev`

설치가 완료되면 화면에 **Claude Code MCP 등록 안내**가 자동으로 출력됩니다.

---

## 5. Claude Code 연결

`setup.ps1` 실행이 끝나면 화면 하단에 아래와 같은 명령어가 출력됩니다.  
`TENANT_ID`·`CLIENT_ID` 값을 채워 그대로 복사·실행하세요.  
값은 **관리자(정보관리팀)에게 문의**하여 받습니다.

```powershell
claude mcp add --scope user royal-ms365-mcp `
  "{설치경로}\.venv\Scripts\python.exe" "{설치경로}\server.py" `
  --env "MCP_SERVER_NAME=royal-ms365-mcp" `
  --env "TENANT_ID=테넌트ID" `
  --env "CLIENT_ID=클라이언트ID" `
  --env "MS365_AUTO_AUTH=false"
```

> `--scope user`는 모든 프로젝트에서 공용으로 사용하는 설정입니다.  
> 스크립트가 출력한 실제 경로(`{설치경로}` 부분이 자동으로 채워진 값)를 사용하면 편리합니다.

실행 후 **Claude Code를 완전히 종료하고 다시 실행**해야 설정이 적용됩니다.

---

## 6. 첫 실행 및 MS365 로그인

Claude Code를 실행한 뒤 채팅창에 입력합니다.

```
ms365 로그인해줘
```

아래와 같이 코드와 URL이 반환됩니다.

```
verification_uri: https://microsoft.com/devicelogin
user_code: XXXX-XXXX
```

1. 브라우저에서 `https://microsoft.com/devicelogin` 접속
2. 코드(`XXXX-XXXX`) 입력
3. 본인 `@iroyal.kr` 계정으로 로그인
4. **최초 로그인 시** "앱 권한 동의" 화면이 표시되면 **수락**을 클릭합니다.  
   (이메일·캘린더·Teams·SharePoint 접근 권한 동의 — 이후 로그인 시에는 표시되지 않음)

로그인 완료 후 이메일·캘린더·Teams·SharePoint 기능을 사용할 수 있습니다.

---

## 7. 보안 주의사항 — 토큰 캐시 파일 관리

MS365 로그인 완료 후 인증 토큰은 **로컬 파일(`token_cache.bin`)에 암호화되어 저장**됩니다.  
이 파일에는 계정 접근 권한이 담겨 있으므로 아래 사항을 반드시 준수하세요.

> **절대 Git 저장소에 커밋·공유하지 마세요.**  
> 토큰 캐시 파일이 외부에 유출되면 본인 계정(이메일·캘린더·Teams 등)이 무단으로 접근될 수 있습니다.

| 항목 | 내용 |
|------|------|
| 캐시 파일 위치 | `~/.royal-ms365-mcp/token_cache.bin` (사용자 홈 디렉터리) |
| `.gitignore` 확인 | `token_cache*` 패턴이 `.gitignore`에 포함되어 있는지 반드시 확인 |
| PC 공유·양도 시 | `ms365 로그아웃해줘` 실행 후 인계 (캐시 파일 자동 삭제됨) |
| 토큰 만료·초기화 | `ms365 로그아웃해줘` 후 `ms365 로그인해줘`로 재인증 |
| 보안 사고 발생 시 | 즉시 관리자(정보관리팀)에게 연락 |

> `ms365 로그아웃해줘` 실행 시 토큰 캐시 파일도 자동으로 삭제됩니다.

---

## 8. 자주 발생하는 문제

| 증상 | 해결 |
|------|------|
| `python` 명령 없음 | [python.org](https://www.python.org/)에서 Python 3.11 이상 설치 (설치 시 **"Add Python to PATH"** 체크 필수), 설치 후 PowerShell 재시작 |
| `python` 입력 시 Microsoft Store가 열림 | Python이 설치되지 않은 상태. [python.org](https://www.python.org/)에서 Python 3.11 이상 설치 (설치 시 **"Add Python to PATH"** 체크 필수), 설치 후 PowerShell 재시작 |
| `.\setup.ps1` 가 CMD에서 실행 안 됨 | 명령 프롬프트(CMD) 대신 **PowerShell**에서 실행해야 합니다. 시작 메뉴에서 "Windows PowerShell" 검색 또는 **Win + X** 단축키로 실행 |
| `.\setup.ps1` 실행 오류 (권한) | `Set-ExecutionPolicy -Scope CurrentUser RemoteSigned` 실행 후 재시도 |
| `.env` 파일이 안 보임 | 탐색기 → 보기 → **숨긴 항목** 체크 후 확인 |
| `.env`가 `.env.txt`로 저장됨 | 메모장 저장 시 파일 형식을 "모든 파일(\*.\*)"으로 변경 후 재저장 |
| Claude Code에 MCP 도구가 안 보임 | `claude mcp list`로 등록 확인 후 Claude Code **재시작** |
| 로그인 후 권한 오류 | 관리자에게 Azure AD 권한 동의 요청 |
| 토큰 만료 (기본 1시간, Azure AD 정책에 따라 다름) | 다시 `ms365 로그인해줘` 요청 |

---

## 9. 프롬프트 모음

> 로얄앤컴퍼니 MS365 MCP 전체 기능(40종) 활용 예시  
> Claude 채팅창에 그대로 입력하거나 업무 상황에 맞게 수정하여 사용하세요.

### 목차

1. [시작하기 — 로그인·상태 확인](#시작하기--로그인상태-확인)
2. [이메일 — 검색·읽기](#이메일--검색읽기)
3. [이메일 — 발송](#이메일--발송)
4. [이메일 — 분류·정리](#이메일--분류정리)
5. [이메일 — 답장·전달](#이메일--답장전달)
6. [캘린더 — 조회·검색](#캘린더--조회검색)
7. [캘린더 — 일정 관리](#캘린더--일정-관리)
8. [Teams — 메시지 발송](#teams--메시지-발송)
9. [Teams — 채널·대화 조회](#teams--채널대화-조회)
10. [SharePoint·OneDrive — 파일 검색·읽기](#sharepointonedrive--파일-검색읽기)
11. [SharePoint·OneDrive — 파일 관리](#sharepointonedrive--파일-관리)
12. [복합 프롬프트 — 업무 흐름 한 번에](#복합-프롬프트--업무-흐름-한-번에)

---

### 시작하기 — 로그인·상태 확인

MS365 도구를 처음 사용할 때 또는 오류가 날 때 로그인을 먼저 진행합니다.  
로그인하면 URL과 코드가 나오며, 브라우저에서 `@iroyal.kr` 계정으로 인증하면 됩니다.

#### 로그인

```
ms365 로그인해줘.
```

```
MS365 접속해줘. 이메일 도구 쓰려고.
```

#### 로그아웃

```
ms365 로그아웃해줘.
```

```
MS365 연결 끊어줘. 오늘 작업 끝났어.
```

#### 연결 상태 확인

```
지금 MS365 로그인 상태야?
```

```
MS365 연결 되어 있는지 확인해줘.
```

---

### 이메일 — 검색·읽기

#### 이메일 검색

받은 메일함에서 거래처명, 키워드, 발신자, 날짜 조건으로 메일을 찾습니다.  
찾은 메일의 ID를 이용해 답장·전달·이동 등 후속 작업을 이어서 할 수 있습니다.


```
OO건설에서 온 메일 찾아줘.
```

```
오늘 받은 메일 중에 "납기" 키워드 들어간 거 찾아줘.
```

```
이번 주 안읽은 메일 목록 보여줘.
```

```
purchase@oobuild.co.kr 에서 지난 일주일간 보낸 메일 찾아줘.
```

```
제목에 "발주서" 들어간 메일 최근 10개 찾아줘.
```

#### 메일·파일 내용 읽기

특정 메일이나 SharePoint·OneDrive 파일의 내용을 텍스트로 읽어옵니다.  
파일은 PDF·Word·Excel·PPT 모두 지원합니다.

```
방금 찾은 OO건설 발주 메일 내용 읽어줘.
```

```
SharePoint에 올린 RB-7000 사양서 내용 읽어줘.
```

```
OneDrive /영업자료/거래처현황.xlsx 내용 보여줘.
```

#### 첨부파일 읽기

메일에 첨부된 파일(PDF, Word, Excel 등)을 다운로드 없이 내용을 바로 확인합니다.

```
OO유통 발주 메일에 첨부된 파일 읽어줘.
```

```
아까 받은 품질 검사 성적서 메일의 첨부 PDF 내용 보여줘.
```

```
거래처에서 보낸 클레임 접수서 첨부파일 읽어줘.
```

---

### 이메일 — 발송

지정한 수신자에게 새 이메일을 발송합니다.  
여러 명에게 동일한 내용을 보낼 때도 수신자를 나열하면 됩니다.

```
purchase@oobuild.co.kr 로 메일 보내줘.
제목: RB-7000 비데 출시 안내
내용: 안녕하세요. 당사 신제품 스마트 비데 RB-7000이 출시되었습니다.
      카탈로그는 별도 링크로 전달드리겠습니다. 문의사항은 언제든지 연락 주세요.
```

```
영업팀 이철수 과장(lee@iroyal.kr)에게 메일 보내줘.
제목: OO건설 수주 확정 건
내용: 오늘 수주 확정됐어. 납기 7/15, 수량 500개. 생산 일정 조율 부탁해.
```

```
아래 거래처 담당자들에게 동일한 내용으로 메일 보내줘.
수신: a@aa.co.kr, b@bb.co.kr, c@cc.co.kr
제목: 하절기 납기 조정 안내
내용: 7~8월 성수기 물량 증가로 납기가 일부 조정될 수 있습니다.
      주요 발주 건은 사전에 협의 부탁드립니다.
```

---

### 이메일 — 분류·정리

#### 범주(카테고리) 지정

메일에 색깔 태그(범주)를 붙여서 종류별로 구분합니다.  
예: 수주완료·긴급처리·처리대기·클레임 등 업무 성격에 맞게 분류하면  
받은편지함에서 한눈에 업무 우선순위를 파악할 수 있습니다.

**범주만 지정**

```
OO건설 클레임 메일에 "긴급처리" 범주 달아줘.
```

```
오늘 받은 수주 확정 메일들에 "수주완료" 범주 달아줘.
```

```
아직 처리 안 된 발주 메일 전부 "처리대기" 범주로 표시해줘.
```

#### 팔로우업 플래그 설정

메일에 깃발 표시를 달아 "나중에 꼭 처리해야 한다"는 표시를 남깁니다.  
지금 당장 답장하기 어려운 중요 메일, 처리 결과를 확인해야 하는 메일 등에 달아두면  
나중에 플래그 있는 메일만 모아보기로 빠르게 찾을 수 있습니다.  
처리가 끝나면 플래그를 완료 상태로 바꾸거나 해제할 수 있습니다.

```
OO유통 납기 조율 메일에 팔로우업 플래그 달아줘.
```

```
아직 답장 못 한 거래처 문의 메일들에 플래그 달아줘. 오늘 중 처리해야 해.
```

```
처리 완료된 OO건설 클레임 메일 플래그 완료 처리해줘.
```

```
OO인테리어 수주 건 메일 플래그 해제해줘. 처리 끝났어.
```

#### 읽음·안읽음 처리

메일의 읽음 상태를 수동으로 변경합니다.  
**안읽음으로 되돌리기**: 확인은 했지만 나중에 다시 처리해야 할 때 안읽음으로 표시해두면  
받은편지함에서 굵게 표시되어 놓치지 않을 수 있습니다.

```
방금 확인한 OO건설 납기 문의 메일 읽음 처리해줘.
```

```
오늘 받은 생산 일정 메일 안읽음으로 다시 표시해줘. 퇴근 후 처리할 거야.
```

#### 폴더 이동·아카이브

처리 완료된 메일을 받은편지함에서 다른 폴더로 정리합니다.  
**아카이브**는 "보관" 개념으로, 삭제하지 않고 받은편지함을 깔끔하게 유지할 때 사용합니다.  
Outlook의 아카이브 폴더에 이동되며 언제든 검색으로 다시 찾을 수 있습니다.

```
처리 완료된 OO인테리어 클레임 메일 아카이브로 이동해줘.
```

```
지난달 수주 관련 메일들 전부 아카이브로 옮겨줘.
```

```
받은편지함에 있는 뉴스레터·광고 메일들 정크메일함으로 이동해줘.
```

#### 이메일 삭제

메일을 휴지통으로 이동합니다. 완전 삭제가 아니며 휴지통에서 복구할 수 있습니다.

```
제목에 "광고" 들어간 메일 삭제해줘.
```

```
거래 완료된 임시 견적 메일들 삭제해줘.
```

---

### 이메일 — 답장·전달

#### 발신자에게만 답장

메일을 보낸 사람 한 명에게만 답장합니다.  
참조(CC)로 포함된 다른 사람들에게는 전달되지 않습니다.

```
OO건설 홍길동 부장 클레임 메일에 답장해줘.
내용: 접수 확인했습니다. 영업일 3일 이내 처리 후 결과 안내드리겠습니다.
```

```
납기 문의 메일에 답장해줘.
내용: 현재 해당 모델 재고 확보 중이며, 7월 15일 출하 예정입니다.
```

#### 전체 답장

메일의 발신자와 모든 참조자(CC)에게 동시에 답장합니다.  
여러 부서가 참조된 메일에서 모두에게 동일하게 회신할 때 사용합니다.

```
OOO이 보낸 검사 결과 메일에 전체 답장해줘.
내용: 확인했습니다. 해당 로트는 출하 보류 처리하겠습니다.
      품질팀에서 원인 분석 후 생산팀에 공유 부탁드립니다.
```

```
오늘 오전 임원 보고 메일에 전체 답장해줘.
내용: 검토 완료했습니다. 추가 자료 필요하시면 말씀 주세요.
```

#### 전달 (Forward)

받은 메일을 원본 그대로 다른 사람에게 넘깁니다.  
거래처 클레임이나 발주 변경 메일을 관련 부서 담당자에게 넘길 때 원본 내용이 그대로 전달됩니다.

```
오늘 OO유통 발주 변경 메일을 생산팀장 kim@iroyal.kr 에게 전달해줘.
메모: 수량 증량 건 생산 가능 여부 확인 부탁드립니다.
```

```
거래처 클레임 메일 품질팀장 kim1@iroyal.kr·생산팀장 kim2@iroyal.kr 두 명에게 전달해줘.
메모: 긴급 검토 요청. 오늘 중 회신 부탁드립니다.
```

```
신제품 사양 문의 메일 개발팀 담당자 dev@iroyal.kr 에게 넘겨줘.
```

---

### 캘린더 — 조회·검색

#### 일정 검색

내 캘린더에서 날짜 범위나 키워드로 일정을 조회합니다.

```
다음 주 내 일정 전부 보여줘.
```

```
7월에 OO건설 관련 일정 있어?
```

```
이번 달 Teams 온라인 회의 일정 목록 보여줘.
```

```
"납기 확인" 키워드가 들어간 일정 찾아줘.
```

#### 회의 가능 시간 조회

여러 참석자의 캘린더를 동시에 확인해서 모두가 비어 있는 시간을 찾아줍니다.  
여러 부서 담당자가 참석하는 회의 일정을 잡을 때 개별적으로 물어볼 필요 없이  
Claude가 자동으로 가능한 시간을 확인해줍니다.

```
내일 오후에 이철수 과장(lee@iroyal.kr), 김품질(quality@iroyal.kr) 과
1시간 회의 가능한 시간 찾아줘.
```

```
다음 주 중 김생산 부장, 김영업 부장, 김자재 부장 세 명이 동시에 비어 있는
오전 시간 찾아줘. 30분짜리야.
```

---

### 캘린더 — 일정 관리

#### 일정 생성

참석자를 초대하는 캘린더 일정을 생성합니다.  
**Teams 온라인 링크 포함** 옵션을 추가하면 Teams 회의 링크가 자동으로 생성되어  
초대장에 포함됩니다. 외부 거래처 참석자도 링크로 입장할 수 있습니다.

```
내일 오후 2시~3시에 "OO건설 납기 협의" 일정 만들어줘.
참석자: hong@oobuild.co.kr, lee@iroyal.kr
```

```
다음 주 화요일 오전 10시~11시 품질 점검 회의 만들어줘.
참석자: quality@iroyal.kr, prod@iroyal.kr
Teams 온라인 링크도 만들어줘.
```

```
7월 15일 오후 3시 "RB-7000 출시 킥오프" 일정 잡아줘.
참석자: lee@iroyal.kr, park@iroyal.kr, choi@iroyal.kr
장소: 본사 2층 대회의실
Teams 링크도 포함해줘.
```

#### 일정 수정

기존 일정의 시간·장소·참석자·내용을 변경합니다.  
이미 초대된 참석자에게는 변경 알림이 자동으로 발송됩니다.

```
내일 납기 협의 회의 시간을 오후 2시에서 3시로 변경해줘.
```

```
다음 주 품질 점검 회의에 참석자 추가해줘. hong@oobuild.co.kr 도 초대해.
```

```
화요일 품질 회의에 Teams 온라인 링크 추가해줘.
```

```
7월 15일 킥오프 회의 장소를 "본사 3층 중회의실"로 수정해줘.
```

#### 일정 삭제

일정을 삭제하면 참석자에게 취소 알림이 자동으로 발송됩니다.

```
내일 납기 협의 회의 취소해줘. 거래처 요청으로 연기됐어.
```

```
이번 주 금요일 임원 보고 일정 삭제해줘.
```

---

### Teams — 메시지 발송

#### 채널 메시지

Teams의 특정 팀·채널에 메시지를 올립니다.  
부서 전체 공지, 긴급 알림, 업무 공유 등 여러 사람이 함께 보는 게시판 역할을 합니다.  
채널 이름을 모르면 먼저 "Teams 채널 찾아줘"로 조회할 수 있습니다.

```
생산관리팀 채널에 공지 올려줘.
내용: OO인테리어 세면기 500개 수주 확정. 납기 7/15. 발주서는 SharePoint 수주발주서 폴더 확인 요망.
```

```
영업팀 채널에 메시지 보내줘.
내용: RB-7000 신제품 카탈로그 SharePoint에 업로드 완료. 거래처 안내 시 활용 바람.
```

```
품질관리팀 채널에 긴급 공지해줘.
내용: [긴급] OO건설 CR-500 양변기 10개 불량 클레임 접수. 오늘 오후 2시 긴급 회의 예정.
```

```
자재구매팀 채널에 알려줘.
내용: OO유통 발주 수량 300→500으로 증량 요청 들어옴. 자재 확보 가능 여부 오늘 중 확인 요청.
```

#### 1:1 채팅

특정 담당자에게 Teams 개인 메시지를 발송합니다.  
이메일보다 빠른 확인이 필요한 급한 협조 요청에 적합합니다.

```
이철수 과장(lee@iroyal.kr)에게 Teams 메시지 보내줘.
내용: 오늘 OO건설 수주 확정됐어. 발주서 메일로 전달할게, 확인해줘.
```

```
품질팀장(quality@iroyal.kr)에게 Teams 채팅 보내줘.
내용: 오전에 전달한 클레임 건 오늘 중 검토 가능할까요?
```

---

### Teams — 채널·대화 조회

#### 팀·채널 목록 조회

내가 가입된 Teams 팀 목록과 각 팀의 채널을 확인합니다.  
채널에 메시지를 보내거나 메시지를 읽으려면 팀 이름과 채널 이름을 먼저 확인해야 합니다.

```
우리 회사 Teams 팀 목록 보여줘.
```

```
"생산" 이름 들어간 Teams 팀 찾아줘.
```

```
영업팀 채널 목록 보여줘.
```

#### 채널 메시지 조회

특정 채널에 올라온 최근 메시지를 확인합니다.  
내가 잠깐 자리를 비운 사이 채널에 올라온 내용을 빠르게 파악할 때 유용합니다.

```
생산관리팀 채널 최근 메시지 20개 보여줘.
```

```
품질관리팀 채널에서 오늘 올라온 메시지 확인해줘.
```

```
영업팀 채널에서 "RB-7000" 관련 메시지 찾아줘.
```

#### 그룹채팅 메시지 조회

특정 그룹채팅의 최근 대화 내용을 확인합니다.

```
영업팀 그룹채팅 최근 내용 보여줘.
```

```
수주 협의 그룹채팅에서 어제 나눈 대화 보여줘.
```

#### 채팅·채널 ID 검색

채널에 메시지를 발송하거나 대화를 조회할 때 필요한 ID를 조회합니다.  
채널 이름만 알고 있을 때 실제 ID를 확인하는 용도입니다.

```
"수주공유" 채널 ID 찾아줘.
```

```
생산관리팀 Teams 채널 ID 알려줘.
```

---

### SharePoint·OneDrive — 파일 검색·읽기

#### 파일 검색

SharePoint 사이트나 OneDrive에서 파일명·키워드로 파일을 찾습니다.  
파일을 찾은 뒤 링크 생성, 이동, 이름 변경 등 후속 작업을 이어서 할 수 있습니다.

```
SharePoint에서 "RB-7000 사양서" 파일 찾아줘.
```

```
OneDrive에서 "발주서" 들어간 파일 최근 10개 찾아줘.
```

```
SharePoint 수주관리 사이트에서 OO인테리어 관련 파일 찾아줘.
```

```
"클레임" 키워드가 있는 파일 전체 검색해줘.
```

#### 폴더 내 파일 목록 조회

특정 폴더 안에 어떤 파일이 있는지 목록을 확인합니다.  
수주발주서 폴더, 출하서류 폴더 등에 무엇이 저장되어 있는지 파악할 때 사용합니다.

```
SharePoint /수주발주서/2026/ 폴더 안에 있는 파일 목록 보여줘.
```

```
OneDrive 영업자료 폴더 안에 뭐가 있는지 목록 보여줘.
```

```
SharePoint /클레임관리/2026/ 폴더 파일 목록 확인해줘.
```

---

### SharePoint·OneDrive — 파일 관리

#### 텍스트 파일 생성

SharePoint에 새 텍스트 파일(.txt)을 생성합니다.  
수주 현황·클레임 처리 결과·회의 메모 등 간단한 기록을 SharePoint에 바로 만들 때 사용합니다.

```
SharePoint 수주관리 사이트 /수주발주서/2026/ 폴더에
"20260529_수주현황.txt" 파일 만들어줘.
내용: 2026-05-29 수주 현황
      - OO인테리어: 세면기 WT-300 500개, 납기 7/15
      - OO건설: 양변기 CR-500 200개, 납기 7/20
```

```
SharePoint에 클레임 처리 결과 메모 파일 만들어줘.
파일명: 20260529_OO건설_클레임처리결과.txt
내용: 접수일: 2026-05-29, 내용: CR-500 수압불량 10개, 처리: 교환 처리 완료
```

#### 파일 업로드

내 PC에 있는 파일(PDF·Excel·Word·이미지 등)을 SharePoint 또는 OneDrive에 올립니다.  
이메일 첨부로 전달하면 버전이 분산되지만, SharePoint에 올리면 링크 하나로 최신 파일을 공유할 수 있습니다.  
4MB 이하는 즉시 업로드, 그 이상은 대용량 방식으로 자동 처리됩니다.

```
C:\수주\20260529_OO인테리어_발주서.pdf 를
SharePoint 수주관리 사이트 /수주발주서/2026/ 폴더에 올려줘.
```

```
C:\신제품\RB-7000_카탈로그.pdf 와
C:\신제품\RB-7000_사양서.xlsx 를
SharePoint 신제품 사이트 /신제품/RB-7000/ 폴더에 업로드해줘.
```

```
C:\출하\20260529_OO건설_출하명세서.pdf 를
OneDrive /출하서류/2026/ 폴더에 업로드해줘.
```

#### 파일 이름 변경

SharePoint·OneDrive에 저장된 파일의 이름을 변경합니다.  
"임시" "초안" 파일을 확정 후 정식 이름으로 바꿀 때 사용합니다.

```
SharePoint에 올라간 "발주서_임시.pdf" 파일명을
"20260529_OO인테리어_발주서_확정.pdf" 로 바꿔줘.
```

```
OneDrive에 있는 "카탈로그_v2.pdf" 를 "RB-7000_카탈로그_최종.pdf" 로 변경해줘.
```

#### 파일·폴더 이동

SharePoint·OneDrive 내에서 파일이나 폴더를 다른 위치로 옮깁니다.  
임시 폴더에 보관하던 파일을 확정 후 정식 위치로 이동할 때 사용합니다.

```
SharePoint /신제품/임시/ 폴더에 있는 RB-7000 사양서를
/신제품/RB-7000/확정/ 폴더로 이동해줘.
```

#### 파일·폴더 삭제

파일이나 폴더를 휴지통으로 이동합니다. 완전 삭제가 아니며 복구 가능합니다.

```
SharePoint /수주발주서/2026/ 에 있는 "발주서_초안_v1.pdf" 삭제해줘.
```

```
OneDrive /임시/ 폴더에 있는 테스트 파일들 전부 삭제해줘.
```

#### 공유 링크 생성

파일을 이메일 첨부 없이 링크 하나로 공유합니다.  
- **보기 전용**: 거래처·외부에 공유할 때. 상대방이 파일을 수정할 수 없습니다.  
- **편집 가능**: 사내 부서간 공동 작업 시.  
- **조직 내부만**: 링크가 외부로 유출되어도 회사 계정 없이는 열리지 않습니다.

링크 방식의 장점: SharePoint의 원본 파일을 업데이트하면 링크를 다시 보낼 필요 없이 상대방이 항상 최신 파일을 볼 수 있습니다.

```
SharePoint에 올린 RB-7000 카탈로그 공유 링크 만들어줘.
거래처에 보낼 거니까 보기 전용으로.
```

```
수주 발주서 사내 공유 링크 만들어줘. 이영업 차장이 편집도 해야 해.
```

```
OO건설 클레임 처리 결과 보고서 링크 만들어줘.
조직 내부에서만 볼 수 있게 해줘.
```

#### 파일 버전 이력 조회

SharePoint에 저장된 파일의 수정 이력을 확인합니다.  
누가 언제 파일을 수정했는지 추적할 수 있으며, 이전 버전으로 복구가 필요할 때 버전 번호를 확인하는 용도로 사용합니다.  
거래처에 보낸 사양서나 발주서가 언제 변경됐는지 확인해야 할 때 유용합니다.

```
SharePoint에 있는 RB-7000 사양서 버전 이력 보여줘.
언제 누가 수정했는지 확인해야 해.
```

```
OO인테리어 발주서 버전 목록 확인해줘.
혹시 내용이 바뀐 게 있는지 보려고.
```

---

### 복합 프롬프트 — 업무 흐름 한 번에

여러 도구를 이어서 쓰는 업무 흐름을 한 번에 지시하는 예시입니다.  
Claude가 순서대로 실행하며, 담당자·채널·파일 위치를 먼저 조회한 뒤 확인을 거쳐 실행합니다.


#### 수주 확정 시

```
OO인테리어 세면기 WT-300 500개 수주 확정됐어.
납기 7월 15일.
발주서 C:\수주\20260529_OO인테리어.pdf SharePoint 수주발주서 폴더에 올리고
부서 공유용 링크 만들어줘.
생산·자재·품질 Teams 채널에 수주 확정 공지하고
7월 10일 오전 10시 납기 확인 회의 잡아줘. Teams 링크 포함해서.
```

#### 클레임 접수 시

```
OO건설에서 CR-500 양변기 10개 불량 클레임 메일이 왔어.
발신자: purchase@oobuild.co.kr, 오늘 오전 수신.
원본 메일 찾아서 김품질 부장·김생산 부장에게 전달하고
원본 메일엔 팔로우업 플래그 달아줘.
품질관리팀 채널에 긴급 공지하고
김품질 부장·김생산 부장·이영업 부장 세 명이 동시에 참석 가능한 오늘 오후 시간 찾아서 회의 잡아줘. Teams 링크 포함.
```

#### 신제품 출시 시

```
스마트 비데 RB-7000 출시 확정됐어.
카탈로그 C:\신제품\RB-7000_카탈로그.pdf,
사양서 C:\신제품\RB-7000_사양서.xlsx SharePoint 신제품 폴더에 올리고
거래처 공유용 링크 만들어줘 (보기 전용).
영업팀·마케팅팀 Teams 채널에 출시 공지하고
주요 거래처 a@aa.co.kr, b@bb.co.kr, c@cc.co.kr 에게 출시 안내 메일 보내줘.
```

#### 출하 완료 통보 시

```
OO건설 납품 오늘 출하 완료됐어.
운송사 한진택배, 운송장 1234567890, 예상 도착 6월 2일.
거래처 purchase@oobuild.co.kr 에 출하 완료 메일 보내줘.
영업담당 lee@iroyal.kr CC 넣어줘.
출하명세서 C:\출하\20260529_OO건설.pdf SharePoint 출하서류 폴더에도 올려줘.
```

#### 발주 변경 수신 시

```
OO유통에서 기존 발주 300개→500개로 증량 요청 메일이 왔어.
발신자: order@oodist.co.kr, 오늘 오전 수신.
원본 메일 생산팀장 kim@iroyal.kr 에게 전달하고
자재구매팀·생산관리팀 채널에 긴급 공지해줘.
영업+생산+자재 조율 회의 내일 오전으로 잡아줘.
```