SharePoint Embedded 검색 앱, Copilot 라이선스와 과금 구분

1. 사내 문서 검색 앱을 만들 때 먼저 나오는 질문

예시를 하나 들겠습니다. 계약서를 보관하는 사내 앱에 '이 계약의 갱신 조건이 무엇인가' 같은 질문 기능을 붙여 달라는 요청이 들어왔습니다. 개발 담당은 문서를 잘게 나누고 임베딩을 만들어 벡터 데이터베이스에 넣는 작업부터 떠올립니다. 라이선스 관리자는 앱을 쓰는 직원 모두에게 Copilot 라이선스를 사 줘야 하는지 묻습니다.

Microsoft 365 Developer 블로그는 2026년 10월 13일 글에서 이 상황에 쓸 수 있는 기능을 소개했습니다. SharePoint Embedded 앱이 Microsoft 365 Copilot Retrieval API로 문서 발췌를 가져오는 방법, 그리고 앱 구성을 코딩 에이전트로 처리하는 SharePoint Embedded MCP 서버입니다. SharePoint Embedded는 앱이 쓰는 문서를 고객의 Microsoft 365 테넌트 안 컨테이너에 저장하는 API 기반 서비스입니다. 블로그는 이 콘텐츠가 감사·eDiscovery·보존·DLP·민감도 레이블 같은 Purview 통제 안에 있다고 설명합니다.

Retrieval API와 MCP 서버는 쓰는 시점도, 제공 상태 표기도 서로 다릅니다. 이 글은 기능 소개보다 라이선스·과금·제공 상태를 구분하는 데 집중합니다.

2. Retrieval API와 앱이 각각 맡는 일

블로그는 Retrieval API를 "Using the Retrieval API, developers submit a query and specify sharePointEmbedded as the data source, with pay-as-you-go billing on the Copilot Studio message meter."라고 설명합니다. 앱이 질의를 보내면서 데이터 소스를 sharePointEmbedded로 지정하면, API가 컨테이너에서 관련 텍스트 발췌를 반환합니다. 앱은 이 발췌를 자기 모델에 근거 자료로 넘겨 답변을 만듭니다.

블로그는 콘텐츠가 Microsoft 365 안에 머물기 때문에 별도의 색인 인프라를 만들고 유지할 필요가 없다고 설명합니다. Microsoft Learn 문서에 따르면 요청에는 FileStorageContainer.Selected 위임 권한이 필요하고, 결과는 로그인한 사용자가 접근할 수 있는 콘텐츠로 걸러집니다.

작성자 해석으로는, 문서 색인과 권한 동기화는 Microsoft 365가 처리하고 프롬프트·모델·답변 품질은 앱 개발팀이 계속 책임집니다. 답변이 틀렸을 때 어디를 고칠지 정할 때 이 구분이 도움이 됩니다.

3. 라이선스는 테넌트에 1명 이상이면 됩니다

라이선스 조건은 블로그 원문에 이렇게 적혀 있습니다. "Furthermore, Microsoft 365 Copilot licenses are not needed for every user who queries the Retrieval API, if at least one user in the tenant has a Microsoft 365 Copilot license." 이어서 "The licensed user(s) can initialize the semantic index."라고 덧붙였습니다. Learn 문서도 시맨틱 인덱스 초기화를 위해 테넌트에 Copilot 라이선스 사용자가 최소 1명 있어야 한다고 전제 조건에 적었습니다.

라이선스 관리자는 앱 사용자 수만큼 Copilot 라이선스를 준비할 필요가 없습니다. 대신 테넌트에 라이선스 사용자가 1명도 없으면 전제 조건을 채우지 못합니다. 개발용으로 따로 쓰는 시험 테넌트에서 특히 확인해야 합니다. 그 라이선스를 나중에 회수하면 검색이 어떻게 되는지는 공식 문서에서 확인하지 못했습니다.

4. 비용은 Azure 구독과 Copilot Studio 메시지 미터에 기록됩니다

블로그는 SharePoint Embedded를 Azure 구독으로 쓰는 만큼 내는 종량제 서비스이며 선결제 약정이 없다고 설명합니다. Retrieval API 요청은 앞서 인용한 대로 Copilot Studio 메시지 미터에 종량제로 기록됩니다.

Learn 문서는 과금 모델에 따라 청구 대상이 달라진다고 적었습니다. 표준 과금(standard billing)은 앱을 소유한 테넌트의 Azure 구독에, 패스스루 과금(pass-through billing)은 앱을 쓰는 테넌트의 구독에 청구됩니다. 고객사에 배포하는 SaaS 앱을 만든다면 비용을 누가 낼지를 이 선택으로 정하게 됩니다. Retrieval API를 쓰려면 컨테이너 유형에 종량제 과금을 먼저 설정해야 합니다.

Billing meters 문서는 미터 종류와 단위만 적었고 금액은 없었습니다. 같은 문서는 SharePoint Embedded 에이전트 대화 1건이 메시지 12건을 쓴다고 적었지만, Retrieval API 요청 1건이 몇 건으로 기록되는지는 적지 않았습니다. 그래서 메시지당 단가와 요청당 기록 건수는 확인하지 못했습니다. 금액은 같은 문서가 가격 링크로 안내한 SharePoint Embedded 제품 페이지와 Azure Cost Management에서 찾아야 하며, 이번에 열어 보지는 않았습니다. 예산은 시험 기간의 실제 사용량을 보고 잡는 편이 안전합니다.

5. 프리뷰 표기는 출처마다 다르게 적혀 있습니다

블로그는 MCP 서버를 "The SharePoint Embedded Model Context Protocol (MCP) server, now in public preview, enables you to build and manage apps with a coding agent."라고 소개했습니다. Retrieval API의 SharePoint Embedded 소스에는 상태를 적지 않았습니다. 반면 게시일 표시 없이 마지막 업데이트일(2026년 9월 17일)만 표시된 Learn 문서는 "Retrieval API support for the sharePointEmbedded data source is in preview."라고 적었습니다. 마지막 업데이트 2026년 8월 10일로 표시된 Billing meters 문서도 sharePointEmbedded 데이터 소스가 종량제 과금까지 포함해 프리뷰이고 Retrieval API 자체는 정식 제공(generally available)이라고 적었으며, 메시지 미터 항목에는 private preview 표기를 붙였습니다. 작성자는 이 출처들을 함께 보고, SharePoint Embedded 소스와 MCP 서버를 프리뷰로 보고 계획하는 편이 안전하다고 판단합니다.

MCP 서버는 코딩 에이전트가 SharePoint Embedded 앱 구성 작업을 대신 실행하게 해 주는 도구입니다. Learn 문서는 Node.js 22 이상, Azure CLI 로그인, 테넌트 관리자 권한(Global Administrator 또는 Application Administrator)을 전제 조건으로 적었습니다. 읽기 전용으로 실행하는 옵션이 있고, 컨테이너 안 콘텐츠를 다루는 작업은 별도로 동의해야 열립니다. 관리자 권한이 필요한 도구이므로 운영 테넌트에서 바로 쓰지 말고 시험 테넌트에서 읽기 전용으로 시작하는 편이 좋습니다.

지역 제한과 한국 테넌트에서 쓸 수 있는지는 공식 문서에서 확인하지 못했습니다. 이 글은 공식 문서를 읽고 정리했으며, 직접 실행해 보지는 않았습니다.

6. 이번 주에 해 볼 첫 단계

라이선스 관리자는 운영 테넌트와 시험 테넌트 각각에 Microsoft 365 Copilot 라이선스 사용자가 있는지 확인하십시오. 개발 담당은 만들려는 앱이 표준 과금과 패스스루 과금 중 어느 쪽에 맞는지 정하고, 비용을 낼 Azure 구독 담당자를 찾아 두십시오.

그다음 Billing meters 문서가 안내하는 가격 페이지에서 Copilot Studio 메시지 미터 단가가 공개되어 있는지 확인하고, 위 표의 과금 항목 옆에 적어 두면 됩니다. 프리뷰 기능이므로 실제 업무 문서를 올리기 전에 시험용 컨테이너와 사용 기간을 먼저 정하십시오.