SharePoint Embedded 엔터프라이즈 업데이트 — 분당 12,000 RU와 MCP 서버(프리뷰)
SharePoint Embedded가 앱·테넌트당 분당 12,000 RU 한도, 최소 권한 가이드, 코딩 에이전트용 MCP 서버(프리뷰)를 정리했다. 운영 전 확인할 점을 짚는다.
이 글은 Microsoft 365 Developer Blog의 “Develop enterprise-grade apps with SharePoint Embedded”(2026-10-22, Steve Pucelik)를 읽고 정리·재구성한 것입니다. 한도 값은 원문이 “게시 시점” 기준이라고 밝힌 것이며, 제가 직접 실행해 확인한 것은 아닙니다.
결론부터
이번 글은 신기능 하나가 아니라 “SharePoint Embedded로 업무 앱을 만들 때 어디까지 믿고 설계해도 되는가” 를 숫자로 정리한 문서입니다. 눈에 띄는 것은 세 가지입니다. 앱·테넌트당 기본 API 한도가 분당 12,000 리소스 유닛(RU)이라는 점, 권한을 좁게 쓰라는 가이드, 그리고 코딩 에이전트로 컨테이너 유형을 만들 수 있는 MCP 서버(프리뷰)입니다. 이 중 프리뷰로 명시된 것은 MCP 서버뿐입니다.
핵심 숫자
원문이 제시한 값입니다. 모두 게시 시점 기준입니다.
| 항목 | 값 |
|---|---|
| 테넌트당 사이트·컨테이너 합계 상한 | 200만 |
| 컨테이너당 검색 가능 열 | 40개 |
| 앱·테넌트당 API 한도 | 분당 12,000 RU |
| 비교: 라이선스 1,000 이하 SharePoint 테넌트 | 분당 1,250 RU (최대 9.6배 차이) |
요청당 약 2 RU를 가정한 추정이므로, 실제 처리량은 호출하는 API의 비용에 따라 달라집니다. 컨테이너는 SharePoint의 “조직당 사이트 수” 한도에 포함된다는 점도 눈여겨볼 대목입니다.
권한과 협업 기능
원문은 앱이 사용자 대신 동작하는 위임 접근을 앱 전용 접근보다 권장합니다. 행동이 개별 사용자에게 묶이기 때문입니다. 또 FileStorageContainer.Selected 권한으로 파일 미리보기 같은 작업에서 Files.Read.All 같은 넓은 권한을 대체할 수 있다고 합니다. Word, Excel, PowerPoint는 실시간 공동 편집, 자동 저장, 버전 기록이 기본 제공되며, 공유 접근 수준은 테넌트와 관리자 설정에 달려 있습니다. 컨테이너 유형 설정에는 UrlTemplate이 추가됐습니다. 뷰어가 지원하지 않는 콘텐츠에서 다운로드로 보내는 식의 리다이렉트용입니다.
MCP 서버(프리뷰)
코딩 에이전트에 “내 앱용 컨테이너 유형을 만들어 줘”라고 말하면 리소스를 프로비저닝하는 방식입니다. 클라이언트로는 GitHub Copilot(VS Code, CLI), Claude Desktop, Cursor, Azure AI Foundry가 언급됩니다. 같은 제품군의 Retrieval API와 MCP 서버는 벡터 DB 없이 RAG 글에서 다뤘습니다. 이번 것은 검색이 아니라 프로비저닝 쪽이라는 점이 다릅니다.
실무에서 달라지는 점
- 앱 개발팀: 429/503 처리를 “있으면 좋은 것”에서 설계 필수 항목으로 올려야 합니다. Retry-After를 읽고, 대기 후 동시성을 낮추고, 재시도 횟수를 제한하는 공통 모듈을 먼저 만드세요. 대기 직후 요청이 몰리는 현상도 원문이 피하라고 한 항목입니다.
- 테넌트 관리자: 컨테이너가 조직 전체 사이트 상한(게시 시점 200만)을 SharePoint 사이트와 나눠 쓴다는 점을 용량 계획에 넣으세요. 컨테이너를 사용자·고객 단위로 마구 만드는 설계는 이 상한과 충돌할 수 있습니다.
- 보안 담당: 앱 등록 시 요청하는 Graph 권한을 점검하세요.
Files.Read.All을 쓰는 앱이 있다면FileStorageContainer.Selected로 줄일 수 있는지 검토하고, 가능하면 위임 접근으로 바꾸는 것이 원문 권고입니다. - 프리뷰 도입 판단: MCP 서버를 운영 구독에서 에이전트에 연결하기 전에, 에이전트가 프로비저닝할 수 있는 범위를 개발 테넌트에서 먼저 확인하세요. 자연어로 리소스를 만들 수 있다는 것은 잘못된 요청으로도 만들어질 수 있다는 뜻입니다. 이 부분은 제 해석입니다.
- IT 강사: 한도 숫자는 “외우는 값”이 아니라 “배포 전 문서에서 다시 확인하는 값”으로 가르치세요. 원문도 한도가 바뀔 수 있다고 반복해서 밝힙니다. 실습에는 개발 테넌트가 필요합니다.
참고
- Microsoft 365 Developer Blog, Develop enterprise-grade apps with SharePoint Embedded (2026-10-22): https://devblogs.microsoft.com/microsoft365dev/develop-enterprise-grade-apps-with-sharepoint-embedded/