이 문서는 관리자가 조직의 Claude에서 Microsoft 365 커넥터를 활성화하는 방법을 안내합니다. 여기에는 Microsoft Entra 동의 부여, 액세스 제한, 권한 관리가 포함됩니다. 설정이 완료되면 테넌트의 사용자는 Microsoft 365를 자신의 Claude 계정에 연결하여 Claude에서 SharePoint, OneDrive, Outlook, Teams 전체를 검색할 수 있습니다. 쓰기 도구를 활성화할 수도 있으며, 이를 통해 Claude는 구성원을 대신하여 이메일을 보내고, 일정 이벤트를 관리하고, 파일을 생성 및 업데이트하고, Teams 메시지를 보낼 수 있습니다.
Microsoft 365 커넥터는 모든 Claude 요금제(Free, Pro, Max, Ultra, Team, Enterprise)에서 사용 가능합니다.
설정 완료 후 Microsoft 365 연결 및 사용에 대한 최종 사용자 지침은 Microsoft 365에 연결을 참조하세요.
중요: 이 문서는 Microsoft Entra 테넌트가 필요한 회사 및 학교 계정을 다룹니다. 개인 Microsoft 계정은 관리자 설정이 필요하지 않으며 Team 및 Enterprise 요금제에 표시되지 않습니다. Microsoft 365에 연결에서 자세히 알아보세요.
설정 개요
조직의 누구나 Microsoft 365를 연결하기 전에 두 가지가 필요하며, 쓰기 도구를 활성화하려면 선택적인 세 번째 단계가 있습니다.
Team 및 Enterprise 요금제: Claude 조직 소유자가 조직의 Microsoft 365 커넥터를 활성화합니다.
모든 테넌트: Microsoft Entra 전역 관리자가 일회성 동의를 부여하여 테넌트에 대한 통합을 승인합니다.
쓰기 도구를 활성화하려면: Microsoft Entra 관리자가 업데이트된 권한 집합에 동의하고 조직의 쓰기 도구를 활성화합니다. 아래의 쓰기 도구 활성화를 참조하세요.
이 단계를 완료한 후 구성원은 Microsoft 365에 연결의 단계에 따라 Microsoft 365를 자신의 Claude 계정에 연결할 수 있습니다.
조직의 커넥터 활성화
이 단계는 Team 및 Enterprise 요금제에만 적용됩니다. Free, Pro, Max, Ultra 요금제에서는 다음 섹션으로 건너뛰세요.
Claude에 로그인합니다.
조직 설정 > 커넥터로 이동합니다.
페이지 상단의 “+ 추가”를 클릭한 후 “사용 가능한 모두”를 클릭합니다.
Microsoft 365를 찾아 “팀에 추가”를 클릭합니다.
Microsoft Entra 관리자 동의 부여
테넌트의 Microsoft Entra 전역 관리자가 누구든 연결하기 전에 통합을 승인해야 합니다. 이를 수행하는 두 가지 방법이 있습니다.
옵션 1: Claude를 통한 동의
Microsoft Entra 전역 관리자가 Claude 계정을 가지고 있으면 표준 연결 흐름 중에 동의를 부여할 수 있습니다.
사용자 정의 > 커넥터로 이동합니다.
Microsoft 365를 찾아 “연결”을 클릭합니다.
묻는 경우 “회사 또는 학교 계정”을 선택합니다.
Microsoft 365 자격 증명으로 인증합니다.
요청된 권한을 검토하고 수락하며, 전체 조직을 대신하여 액세스를 부여하는 확인란을 선택합니다.
이후 동일한 Entra 테넌트의 다른 사용자는 표준 최종 사용자 단계를 따라 연결할 수 있습니다. 동의 프롬프트가 표시되지 않으며, 인증하고 통합 사용을 시작하기만 하면 됩니다.
옵션 2: Microsoft Entra ID에서 수동 설정
Microsoft Entra 전역 관리자가 Claude 계정을 가지고 있지 않거나 앱 설치 및 권한 설정을 문제 해결해야 하는 경우 이 경로를 사용합니다. Microsoft Entra ID에서 직접 커넥터 앱을 추가하고 관리자 동의를 부여할 수 있습니다.
이 프로세스는 테넌트에 두 개의 서비스 주체를 추가합니다. 각 주체는 두 개의 M365 MCP for Claude 앱 등록 중 하나에 대한 서비스 수준 ID를 설정하여 Microsoft Graph API를 통해 조직의 데이터 및 리소스에 액세스하고 상호 작용할 수 있도록 합니다.
1. 서비스 주체 추가
Microsoft Graph Explorer를 사용하여 필요한 두 서비스 주체를 모두 추가합니다.
M365 MCP Client for Claude:
POST https://graph.microsoft.com/v1.0/servicePrincipals
{"appId":"08ad6f98-a4f8-4635-bb8d-f1a3044760f0"}
M365 MCP Server for Claude:
POST https://graph.microsoft.com/v1.0/servicePrincipals
{"appId":"07c030f6-5743-41b7-ba00-0a6e85f37c17"}
2. 관리자 동의 부여
다음 URL을 구성하여 브라우저에서 방문하고 {your-tenant-id}를 조직의 테넌트 ID로 바꿉니다.
M365 MCP Client for Claude:
https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=08ad6f98-a4f8-4635-bb8d-f1a3044760f0
M365 MCP Server for Claude:
https://login.microsoftonline.com/{your-tenant-id}/adminconsent?client_id=07c030f6-5743-41b7-ba00-0a6e85f37c17각 URL을 방문하면 조직을 대신하여 통합에 필요한 위임된 권한에 동의하라는 메시지가 표시됩니다.
3. 설정 완료
Team 및 Enterprise 요금제: Claude 조직 소유자가 조직 설정 > 커넥터에서 커넥터를 활성화해야 합니다. 그러면 구성원이 개별적으로 연결할 수 있습니다.
Free, Pro, Max, Ultra 요금제: 구성원은 사용자 정의 > 커넥터로 이동하여 Microsoft 365를 찾고 “연결”을 클릭하여 연결할 수 있습니다. 묻는 경우 “회사 또는 학교 계정”을 선택합니다.
커넥터 사용 가능 사용자 제한
테넌트에서 Claude를 통해 Microsoft 365에 인증할 수 있는 사용자를 제한하려면:
entra.microsoft.com의 Microsoft Entra 관리 센터로 이동합니다.
M365 MCP Server for Claude 엔터프라이즈 애플리케이션으로 이동합니다.
속성으로 이동하여 할당 필수?를 “예”로 설정합니다.
사용자 및 그룹에서 액세스 권한이 있어야 하는 특정 사용자 또는 그룹을 추가합니다.
M365 MCP Client for Claude 엔터프라이즈 애플리케이션에 대해 동일한 단계를 반복합니다.
두 구성 요소 모두 동일한 승인된 사용자 집합으로 제한되어야 합니다.
커넥터가 사용할 수 있는 권한 제한
통합이 액세스할 수 있는 리소스 유형을 제한하려면 기본 승인된 범위 집합에서 선택적으로 권한을 취소합니다. 이를 위해서는 Microsoft Entra 관리자 액세스 권한이 필요합니다.
Microsoft Entra 관리자는 entra.microsoft.com으로 이동합니다.
“엔터프라이즈 애플리케이션”을 선택합니다.
검색 상자 옆에서 애플리케이션 유형 필터를 제거합니다.
“M365 MCP Server for Claude”를 검색하고 클릭합니다.
권한으로 이동합니다.
관리자 동의 탭 아래의 Microsoft Graph 권한 목록에서 취소할 권한을 선택하고 “…” 버튼을 클릭합니다.
“권한 취소”를 선택하고 “예, 취소합니다”로 확인합니다.
취소된 후 해당 권한으로 리소스에 액세스하려는 시도는 “Failed to call tool” 오류를 반환합니다.
멤버는 자신의 Microsoft 365 설정에서 특정 도구를 개별적으로 끌 수 있으므로 Claude가 권한이 취소된 도구에 액세스하려고 시도하지 않습니다.
취소된 권한을 복원하려면 옵션 2: Microsoft Entra ID에서 수동 설정에 설명된 관리자 동의 부여 단계를 따릅니다. 이렇게 하면 권한이 기본 상태로 되돌아갑니다.
쓰기 도구 활성화
쓰기 도구를 사용하면 Claude가 이메일을 보내고, 초안 및 일정 이벤트를 관리하고, 사서함 설정을 업데이트하고, OneDrive 및 SharePoint에서 파일을 생성 및 업데이트하고, Microsoft Teams에서 메시지를 보낼 수 있습니다. 읽기 및 검색 도구는 쓰기 도구의 활성화 여부와 관계없이 동일하게 작동합니다.
1. 업데이트된 권한에 다시 동의
커넥터의 권한 집합에는 이제 쓰기 도구를 지원하기 위한 추가 Microsoft Graph 범위가 포함됩니다. 테넌트가 쓰기 도구 또는 Teams 쓰기 도구 출시 전에 동의한 경우, Microsoft Entra 전역 관리자가 쓰기 도구가 활성화되기 전에 업데이트된 권한 집합을 검토하고 승인해야 합니다. 테넌트의 엔터프라이즈 애플리케이션 동의 흐름에서 커넥터의 업데이트된 권한을 검토하고 승인합니다.
2. 조직의 쓰기 도구 활성화
조직 설정 > 커넥터로 이동하여 “Microsoft 365”를 찾고 각 쓰기 도구에 대해 항상 허용, 승인 필요 또는 차단됨 설정을 선택합니다. 변경 사항은 저장하는 즉시 적용됩니다. Enterprise 플랜은 사용자 정의 역할을 통해 사용자의 하위 집합에 대해 쓰기 도구를 활성화할 수 있습니다.
Microsoft Teams의 경우 각 Teams 쓰기 도구를 개별적으로 설정합니다. 보내기, 게시 및 회신 도구는 승인 필요 또는 차단됨으로 설정할 수 있으며(멤버가 각 전송을 확인), 새 채팅 시작은 항상 허용으로도 설정할 수 있습니다. 조직이 2026년 11월 9일 이후 처음으로 Microsoft 365 커넥터를 추가한 경우, 보내기, 게시 및 회신 도구도 항상 허용으로 설정할 수 있으며, 멤버는 이들에 대해 항상 허용을 선택할 수 있습니다. 커넥터를 제거하고 다시 추가하면 일반적으로 조직의 원래 설치 날짜가 유지됩니다.
이러한 도구에 대한 알림이 표시되면 쓰기 도구 검토, 도구 제한 검토 또는 도구 탭에서 지금 항상 허용으로 설정할 수 있습니다. 항상 허용으로 설정한 각 도구에 대해 제한이 즉시 종료되며, 멤버는 이에 대해 항상 허용을 선택할 수 있습니다. 일부 멤버는 과거에 해당 도구에 대해 항상 허용을 선택했을 수 있습니다. 그 이전 선택은 즉시 적용될 수 있으므로 Claude가 더 이상 묻지 않을 수 있습니다. “자동 승인” 모드 외에서는 Claude가 기본적으로 다른 모든 사람에게 선택할 때까지 묻습니다.
Microsoft 365 커넥터가 2개 이상인 경우 각 커넥터에서 도구를 저장합니다. 2026년 11월 9일 이전에 저장된 항상 허용은 다시 저장할 때까지 제한을 종료하지 않습니다. 나머지 도구의 경우 멤버는 2026년 12월 9일 이후에 제한이 제거될 때까지 각 사용을 승인해야 합니다. 그때까지 설정하지 않은 도구는 전체 커넥터가 차단됨으로 설정되지 않는 한 승인 필요로 변경됩니다.
저장한 변경 사항은 즉시 적용됩니다. 항상 허용으로 설정된 도구는 기본적으로 차단된 경우 즉시 켜집니다. 항상 허용을 사용하면 Claude는 “자동 승인” 모드 및 “자동 승인”으로 설정된 클라우드 예약 작업이나 Claude Code 루틴과 같은 일부 예약된 작업을 포함하여 먼저 누구에게도 묻지 않고 도구를 사용할 수 있습니다. 예약된 작업은 승인 필요인 도구에 대한 액세스를 잃을 수 있습니다. Cowork에서 멤버는 조직 설정 커넥터 도구에 대해 “항상 허용” 허용이 켜져 있을 때만 쓰기 도구에 대해 항상 허용을 선택할 수 있습니다.
커넥터의 기본 제한을 제한 없음으로 설정해도 기본적으로 차단된 도구는 켜지지 않습니다.
HIPAA를 활성화한 조직은 기본 차단 및 제한에 대한 이러한 변경 사항에 포함되지 않습니다. 알림을 받지 않으며, 항상 허용을 설정하거나 처음으로 커넥터를 추가해도 이 제한이 종료되지 않습니다.
Team 또는 Enterprise 조직이 2026년 11월 9일 이전에 커넥터를 추가한 경우, 최소 2026년 12월 9일까지 두 가지 제한이 적용됩니다.
조직이 쓰기 도구 또는 Teams 쓰기 도구 출시 전에 커넥터를 사용 중이었다면, 일부 쓰기 도구는 최소 2026년 12월 9일까지 기본적으로 차단됩니다. 더 빨리 켜려면 조직 설정 > 커넥터로 이동하여 “Microsoft 365”를 찾고 각 도구에 대해 설정을 선택합니다. 2026년 12월 9일 이후, 기본적으로 여전히 차단된 도구는 전체 커넥터가 차단됨으로 설정되지 않는 한 승인 필요로 설정됩니다. 이러한 도구 중 하나가 Anthropic이 해당 날짜 이후에 제거할 제한이 있는 11개의 Outlook, Calendar 및 Teams 도구 중 하나인 경우, 지금 항상 허용으로 설정할 수 있습니다. 즉시 켜집니다. 각 Microsoft 365 커넥터에 저장되면 해당 도구에 대한 제한이 종료되며, 멤버는 이에 대해 항상 허용을 선택할 수 있습니다. Claude는 “자동 승인” 모드 및 “자동 승인”으로 설정된 클라우드 예약 작업이나 Claude Code 루틴과 같은 일부 예약된 작업을 포함하여 먼저 누구에게도 묻지 않고 이를 사용할 수 있습니다. 예약된 작업은 승인 필요인 도구에 대한 액세스를 잃을 수 있습니다. HIPAA를 활성화한 조직은 기본 차단 및 제한에 대한 이러한 변경 사항에 포함되지 않습니다. Enterprise 플랜은 사용자 정의 역할을 통해 사용자의 하위 집합에 대해 쓰기 도구를 활성화할 수 있습니다.
사용자는 11개 도구에 대해 항상 허용을 선택할 수 없으므로 채팅 및 Cowork에서 각 사용을 확인합니다. 이들은 이메일 또는 Teams 메시지를 보내거나, 일정 이벤트를 생성, 변경, 삭제 또는 응답하거나, 자동 회신을 설정하는 도구입니다. 새 Teams 채팅 시작은 이들 중 하나가 아니며 항상 허용으로 설정할 수 있습니다.
두 제한 모두 2026년 12월 9일 이후에 종료됩니다. 아래의 2026년 12월 9일 이후 예정: 쓰기 도구 변경을 참조하세요.
3. 확인
활성화되면 Claude에게 “나에게 이메일 초안을 작성하되 보내지 마세요”와 같은 낮은 위험의 쓰기 작업을 수행하도록 요청하여 쓰기 도구가 활성화되었는지 확인합니다.
참고: Claude가 보내는 이메일에는 에이전트 시작으로 식별하는 속성 헤더가 포함됩니다. 파일 쓰기, 일정 쓰기 및 Teams 메시지는 현재 태그가 지정되지 않습니다. Claude가 일정 이벤트를 생성하거나 업데이트하면 Microsoft 365가 자동으로 참석자에게 초대 또는 업데이트 알림을 보냅니다. 첨부 파일은 쓰기 도구에서 지원되지 않으므로 보내기, 전달 및 초안 작성은 모두 첨부 파일이 있는 메시지를 거부합니다. 쓰기 도구는 또한 쓰기, 전송 및 수신자에 대한 사용자별 제한을 받습니다.
2026년 12월 9일 이후 예정: 쓰기 도구 변경
이는 2026년 11월 9일 이전에 Microsoft 365 커넥터를 추가한 Team 및 Enterprise 조직에 적용됩니다.
2026년 12월 9일 이후, Anthropic은 11개 도구에 대한 제한을 제거합니다. 그때까지 채팅 및 Cowork에서 Claude는 이러한 도구의 모든 사용 전에 사용자에게 묻습니다.
11개 도구:
Outlook: 이메일 보내기, 이메일 전달, 초안 보내기, 자동 회신 설정
Calendar: 이벤트 생성, 변경, 삭제 또는 응답
Teams: 채팅 메시지 보내기, 채널에 게시, 채널에 회신
지금 할 수 있는 작업:
쓰기 도구에 대한 설정을 선택합니다. 변경 사항은 저장하는 즉시 적용됩니다.
이러한 도구에 대한 알림이 표시되면 지금 항상 허용으로 설정할 수 있습니다. 사용자는 제한이 제거될 때까지 각 사용을 승인해야 합니다.
차단된 도구는 항상 허용 또는 승인 필요로 설정하면 즉시 켜집니다.
자동 승인으로 설정된 클라우드 예약 작업 또는 Claude Code 루틴은 항상 허용으로 설정된 도구를 누구에게도 묻지 않고 사용할 수 있습니다. 예약된 작업은 승인 필요인 도구에 대한 액세스를 잃을 수 있습니다.
제한이 제거될 때:
개별적으로 설정하지 않은 11개 도구는 커넥터의 기본 제한이 제한 없음이더라도 승인 필요로 설정됩니다.
저장한 설정은 유지됩니다. 차단됨으로 설정한 도구는 차단됨으로 유지됩니다.
사용자는 해당 도구를 항상 허용으로 설정한 경우에만 이러한 도구 중 하나에 대해 항상 허용을 선택할 수 있습니다. Cowork에서는 커넥터 도구에 대해 “항상 허용” 허용도 켜져 있어야 합니다. 기본적으로 꺼져 있습니다.
기본적으로 여전히 차단되어 있고 변경하지 않은 쓰기 도구는 켜지고 승인 필요로 설정됩니다. 도구를 끄려면 차단됨으로 설정합니다.
전체 커넥터를 차단됨으로 설정한 경우 해당 도구는 차단된 상태로 유지됩니다.
커넥터를 제거하고 다시 추가해도 제한이 제거되지 않습니다. 2026년 11월 9일 이후 처음으로 커넥터를 추가하는 조직은 이를 갖지 않습니다.
권한 참조
Microsoft 365 커넥터는 위임된 권한을 사용합니다. 즉, Claude가 각 사용자를 대신하여 작동하며 해당 사용자가 Microsoft 365에서 이미 볼 수 있는 권한이 있는 데이터에만 액세스할 수 있습니다. 권한은 기본적으로 읽기 전용입니다. 쓰기 도구를 활성화하는 경우에만 Claude가 콘텐츠를 보내거나, 생성하거나, 업데이트할 수 있습니다.
인증 중에 통합은 다음 권한을 요청합니다:
기본 액세스
User.Read: 로그인 및 사용자 프로필 읽기openid: 조직 계정으로 로그인offline_access: 데이터에 대한 액세스 유지email: 이메일 주소 보기profile: 기본 프로필 정보 보기
이메일(Outlook)
Mail.Read: 이메일 메시지 읽기Mail.ReadBasic: 이메일 메타데이터(발신자, 제목, 날짜) 읽기Mail.Read.Shared: 사용자가 액세스할 수 있는 사서함의 이메일 읽기참고: 공유 사서함 액세스는
Mail.Read.Shared권한을 통해 포함됩니다. 사용자는 Microsoft 365에서 위임 액세스 권한이 있는 공유 사서함(전체 액세스 및 폴더 수준 위임 포함)을 검색할 수 있습니다. 표준 관리자 동의 및 Microsoft 365에 이미 구성된 위임 권한 외에 추가 설정이 필요하지 않습니다.
MailboxFolder.Read: 사서함 폴더 구조 읽기MailboxItem.Read: 사서함의 항목 읽기MailboxSettings.Read: 사서함 설정(예: 사용자의 시간대) 읽기
참고: 이메일 검색은 각 사용자의 기본 사서함(보관 폴더 포함) 및 액세스할 수 있는 모든 공유 사서함을 포함합니다. 별도의 온라인 보관 사서함(In-Place Archive라고도 함)은 포함하지 않으므로 보존 정책이 해당 위치로 이동한 메시지는 결과에 나타나지 않습니다.
일정
Calendars.Read: 일정 이벤트 읽기Calendars.Read.Shared: 사용자와 공유된 일정 읽기
Teams 채팅
Chat.Read: Teams 채팅 메시지 읽기Chat.ReadBasic: Teams 채팅 메타데이터 읽기ChatMember.Read: 채팅 참가자 정보 읽기ChatMessage.Read: Teams 채팅 메시지 읽기
Teams 채널
Team.ReadBasic.All: 팀의 이름 및 설명 읽기Channel.ReadBasic.All: 채널 이름 및 설명 읽기ChannelMessage.Read.All: 채널 메시지 읽기
회의
OnlineMeetings.Read: 온라인 회의 읽기OnlineMeetingTranscript.Read.All: 회의 기록 읽기OnlineMeetingAiInsight.Read: AI 생성 회의 인사이트 읽기OnlineMeetingArtifact.Read.All: 회의 녹음 및 아티팩트 읽기OnlineMeetingRecording.Read.All: 회의 녹음 읽기
참고: 기본적으로 Microsoft는 부여된 권한에 관계없이 앱이 Teams 회의 기록에 액세스하도록 허용하지 않습니다. Claude가 기록을 읽도록 하려면 Teams 관리자가 Teams 관리 센터에서 회의 > 회의 설정으로 이동하여 기록 API 액세스 아래에서 Microsoft Graph 액세스를 켜야 합니다. 발언자 속성을 포함하려면 “구성”을 선택하고 기본적으로 꺼져 있는 발언자 속성 포함을 켜세요. 기록 API 액세스에 대한 Microsoft 가이드에서 자세히 알아보세요.
파일(OneDrive 및 SharePoint)
Files.Read: 사용자 파일 읽기Files.Read.All: 사용자가 액세스할 수 있는 모든 파일 읽기Sites.Read.All: SharePoint 사이트의 항목 읽기
쓰기 권한
다음 권한은 쓰기 도구를 지원하며 업데이트된 동의 집합에 포함됩니다:
Mail.Send: 이메일 보내기 및 전달Mail.ReadWrite: 초안 생성, 업데이트 및 삭제, 메시지 이동 및 레이블 지정Calendars.ReadWrite: 일정 이벤트 생성, 업데이트, 삭제 및 응답Files.ReadWrite.All: OneDrive 및 SharePoint에서 파일 및 폴더 생성, 업데이트 및 삭제. 삭제된 항목은 휴지통으로 이동합니다.MailboxSettings.ReadWrite: 범주, 받은 편지함 규칙 및 자동 회신 관리ChatMessage.Send: 사용자를 대신하여 Teams 채팅 메시지 보내기ChannelMessage.Send: Teams 채널에 게시 또는 회신Chat.Create: 사용자를 대신하여 새 채팅 시작People.Read: 조직의 사람을 찾아 채팅 시작
사용자 디렉터리
User.ReadBasic.All: 조직의 모든 사용자에 대한 기본 프로필 정보 읽기(회의 가용성 확인에 사용됨)
Microsoft 365 커넥터는 사용자의 권한을 사용하여 전체 테넌트에서 SharePoint를 검색합니다. 사이트별 검색 제한은 지원되지 않습니다.
개인정보 보호 및 보안
권한 상속: Claude는 각 사용자의 기존 Microsoft 365 권한을 반영합니다. 구성원은 Microsoft 365에서 직접 볼 수 없는 항목에 Claude를 통해 액세스할 수 없습니다.
요청 시. Claude는 사용자가 요청할 때 또는 설정한 예약된 작업이 필요할 때 Microsoft 365에 액세스합니다.
취소 가능한 액세스: 구성원은 사용자 지정 > 커넥터를 통해 자신의 통합을 연결 해제할 수 있습니다. Team 및 Enterprise 플랜 소유자는 조직 설정 > 커넥터에서 전체 조직의 커넥터를 제거할 수도 있습니다.
자세한 내용은 Microsoft 365 커넥터 보안 가이드를 참조하세요.
문제 해결
구성원이 인증할 수 없음
해당 계정이 개인 Microsoft 계정이 아닌 Microsoft Entra 테넌트에 연결되어 있는지 확인하세요.
Microsoft 365 라이선스가 활성화되어 있는지 확인하세요.
위의 옵션 1 또는 옵션 2를 사용하여 관리자 동의가 부여되었는지 확인하세요.
테넌트의 조건부 액세스 정책이 연결을 차단하고 있는지 확인하세요. 아래를 참조하세요: 조건부 액세스가 연결을 차단하고 있음.
구성원이 “도구 호출 실패” 오류를 보고 있음
Microsoft Entra에서 권한이 선택적으로 취소되었을 수 있습니다. 구성원은 Microsoft 365 설정에서 해당 도구를 끄거나 옵션 2: Microsoft Entra ID에서 수동 설정의 관리자 동의 단계를 반복하여 권한을 복원할 수 있습니다.
Teams 도구가 403 “범위 누락” 오류를 반환함
커넥터의 권한 집합에는 이제 Team.ReadBasic.All이 포함되어 있으며, Claude는 사용자가 속한 팀을 나열하는 데 필요합니다. 이 권한이 추가되기 전에 테넌트가 동의한 경우 이에 의존하는 Teams 도구는 403 “범위 누락” 오류를 반환합니다. 이를 해결하려면 Microsoft Entra 전역 관리자가 옵션 1: Claude를 통한 동의 또는 옵션 2: Microsoft Entra ID에서 수동 설정의 관리자 동의 단계를 반복하도록 하세요.
참고: 관리자 동의를 반복하면 쓰기 권한을 포함한 커넥터의 전체 현재 권한 집합이 부여됩니다. 의도적으로 쓰기 권한을 취소한 경우 나중에 다시 취소하세요.
구성원에게 쓰기 도구가 표시되지 않음
Microsoft Entra 관리자가 쓰기 범위를 포함하는 업데이트된 권한 집합에 동의했는지 확인하세요.
Microsoft 365 커넥터 구성에서 쓰기 도구가 활성화되어 있거나 구성원이 이를 부여하는 역할 기반 액세스 정책에 포함되어 있는지 확인하세요.
구성원이 사용자 지정 > 커넥터에서 Microsoft 365를 연결 해제했다가 다시 연결하도록 하세요.
Claude가 SharePoint 검색에서 찾은 파일을 찾지 못함
이는 SharePoint의 자체 검색에서 파일을 찾았지만 Claude는 찾지 못한 경우에만 적용됩니다. Claude가 SharePoint 및 OneDrive 파일을 검색할 때 모든 쿼리에 isDocument=true를 추가하므로 테넌트의 검색 인덱스가 문서로 표시한 파일만 찾습니다. 인덱스가 일부 파일을 표시하지 않으면 Claude는 찾지 못하며 오류가 표시되지 않습니다.
이것이 원인인지 확인하려면:
누락된 파일을 열 수 있는 사용자로 Graph Explorer에 로그인하세요. 요청받으면
Files.Read.All에 동의하세요.이 검색을 실행하고
budget을 누락된 파일의 단어로 바꾸세요. 다른 파일에 거의 포함되지 않는 단어를 선택하세요:POST https://graph.microsoft.com/v1.0/search/query
{"requests":[{"entityTypes":["driveItem"],"query":{"queryString":"
(budget)"},"size":100,"sortProperties":
[{"name":"LastModifiedTime","isDescending":true}]}]}
문서 필터를 추가하여 같은 단어로 다시 실행하세요:
POST https://graph.microsoft.com/v1.0/search/query
{"requests":[{"entityTypes":["driveItem"],"query":{"queryString":"(budget) AND
isDocument=true"},"size":100,"sortProperties":
[{"name":"LastModifiedTime","isDescending":true}]}]}
결과를 비교하세요:
예상한 Word, Excel, PowerPoint 또는 PDF 파일이 첫 번째 검색에만 나타나면 검색 인덱스가 이를 문서로 표시하지 않는 것입니다. Microsoft 지원팀에 사례를 열고 두 검색을 모두 공유하세요.
파일이 두 검색 모두에 나타나지 않으면 이것이 원인이 아닙니다.
조건부 액세스가 연결을 차단하고 있음
조건부 액세스 차단은 세 가지 방식 중 하나로 나타납니다:
사용자가 연결을 시도할 때 “MCP 서버와의 인증 실패”와
ofid_로 시작하는 참조 코드를 봅니다. 당사 지원팀이 해당 코드를 조회할 수 있습니다.이미 연결된 구성원이 Claude가 Microsoft 365 도구를 사용할 때 오류를 받습니다. 오류에는
AADSTS코드, 요청이 조건부 액세스 정책에 의해 차단되었다는 메모, 그리고 Entra에서 검색할 수 있는 추적 ID 및 상관 관계 ID가 포함됩니다.구성원이 정상적인 90일 만료보다 훨씬 더 자주 정기적인 주기로 Microsoft 365를 다시 연결하도록 요청받습니다. 이는 일반적으로 로그인 빈도 정책을 의미합니다.
Microsoft 365 연결은 구성원이 보는 로그인 이상을 포함합니다. 구성원이 브라우저에서 Microsoft에 로그인한 후 Claude의 서버는 해당 로그인을 액세스 토큰으로 교환하고 나중에 해당 토큰을 구성원을 대신하여 Microsoft 365 액세스로 교환합니다. 당사의 테스트에서 Entra는 Anthropic의 아웃바운드 IP 주소에서 오는 것으로 이러한 서버 측 요청에 대해 조건부 액세스 정책을 평가합니다. 이들은 구성원을 식별하고 구성원이 연결할 때 기록된 장치를 전달하며, 구성원의 현재 장치나 네트워크는 아닙니다. 따라서 정책은 구성원 자신의 로그인을 통과할 수 있지만 잠시 후 연결을 차단하거나 며칠 후에 차단할 수 있습니다. Anthropic의 아웃바운드 IP 주소에 대해 자세히 알아보세요.
연결을 차단하는 정책 찾기
Microsoft Entra 관리 센터에서 로그인 로그로 이동하고 사용자 로그인(비대화형) 탭을 엽니다. 구성원 자신의 로그인은 대화형 탭에 나타나며 일반적으로 성공으로 표시되므로 차단은 거기에 거의 없습니다.
영향을 받는 구성원으로 필터링하세요. 차단된 요청은 Claude용 M365 MCP 서버 또는 Claude용 M365 MCP 클라이언트 중 하나로 나타날 수 있으므로 애플리케이션으로 필터링하는 것보다 구성원으로 필터링하는 것이 더 안정적입니다. 일부 행을 숨기는 리소스로 필터링하지 마세요.
실패한 항목을 열고 조건부 액세스 탭을 선택하세요. 요청을 차단한 정책의 이름을 지정합니다.
오류 코드는 정책의 종류를 알려줍니다:
AADSTS70043: 로그인 빈도 정책입니다. 다음 섹션을 참조하세요.AADSTS53003: 액세스를 차단하도록 설정된 정책입니다. 조건부 액세스 탭에서 어느 것인지 알려줍니다. 위치 기반인 경우 다음 섹션을 참조하세요.AADSTS50076: 서버 측 요청에 다단계 인증을 요구하는 정책입니다. Microsoft 365를 연결 해제했다가 다시 연결하면 이를 지웁니다. 계속 발생하면 Microsoft 365 커넥터 보안 가이드를 참조하세요.AADSTS53000: 정책이 호환 장치를 요구합니다. 유사한 코드AADSTS530003은 정책이 관리되는 장치를 요구함을 의미합니다. 두 경우 모두 구성원은 정책을 충족하는 장치에서 다시 연결해야 합니다. Microsoft 365 커넥터 보안 가이드에서 자세히 알아보세요.
로그인 빈도 및 위치 정책에서 Anthropic의 IP 범위 제외
서버 측 요청이 Anthropic의 IP 범위에서 오기 때문에 자신의 네트워크로 로그인을 제한하거나 로그인 빈도를 강제하는 정책은 모든 구성원에 대해 이를 차단합니다. 정책에서 두 Claude 애플리케이션을 제외하는 것만으로는 충분하지 않습니다. Anthropic의 IP 범위도 정책에서 제외할 것을 권장합니다.
참고: 이 제외를 디바이스 규정 준수 정책에 사용하지 마세요. 서버 측 요청은 구성원이 연결할 때 기록된 디바이스를 포함하므로 디바이스 정책이 여전히 적용되며, Anthropic의 IP 범위를 제외하면 커넥터의 디바이스 확인이 해제됩니다. 디바이스 정책에 의해 차단된 구성원은 이를 충족하는 디바이스에서 다시 연결해야 합니다. Microsoft 365 커넥터 보안 가이드에서 자세히 알아보세요.
요청을 차단한 정책이 로그인 빈도 또는 위치 정책인 경우:
Microsoft Entra 관리 센터에서 조건부 액세스 > 명명된 위치로 이동하여 IP 범위 위치를 만듭니다. Anthropic의 아웃바운드 IP 주소 목록에서 현재의 모든 IPv4 범위를 전체적으로 추가합니다. 신뢰할 수 있는 위치로 표시를 선택하지 않은 상태로 두어 제외가 신뢰할 수 있는 위치를 사용하는 다른 정책에 영향을 주지 않도록 합니다. Anthropic이 해당 목록에 범위를 추가하면 이 위치에도 추가하세요.
요청을 차단한 정책을 열고 조건 > 위치 > 제외로 이동합니다.
만든 명명된 위치를 추가합니다. Claude 애플리케이션에 대한 기존 제외는 유지하세요.
정책을 저장하고 변경 사항이 적용될 때까지 몇 분 기다리세요.
영향을 받은 구성원이 사용자 지정 > 커넥터에서 Microsoft 365를 연결 해제했다가 다시 연결하도록 하세요.
참고: 범위를 제외하면 Anthropic의 주소에서 오는 모든 요청에 대해 정책이 해제되므로 모든 구성원의 모든 Microsoft 365 커넥터 활동이 영향을 받습니다. 로그인 빈도 정책의 경우 커넥터의 백그라운드 요청도 더 이상 이에 적용되지 않으므로 연결은 90일간 비활성 후 만료될 때까지 로그인 상태를 유지합니다. 주기적인 재연결을 유지하려면 정책을 그대로 두세요. 재연결하도록 요청받은 구성원은 재연결 전에 브라우저에서 Microsoft에서 로그아웃하거나 프라이빗 브라우징 창을 사용할 수 있습니다. 변경 사항을 적용하기 전에 효과를 확인하려면 먼저 보고서 전용 모드에서 정책을 복제하세요.
자주 묻는 질문
동의가 부여되기 전에 구성원이 연결을 시도하면 어떻게 되나요?
관리자가 앱 권한을 부여해야 통합을 사용할 수 있다는 오류 메시지가 표시됩니다. Microsoft Entra 전역 관리자가 필요한 권한을 승인할 때까지 연결이 실패합니다.
Microsoft 365 커넥터를 엔터프라이즈 검색과 함께 사용할 수 있나요?
예. 엔터프라이즈 검색이 활성화되면 Slack, Google Workspace, Microsoft 365 등의 다른 연결된 서비스와 함께 Microsoft 365를 쿼리하여 통합 검색을 수행할 수 있습니다.
커넥터가 읽을 수 있는 파일 형식은 무엇인가요?
Claude는 SharePoint 및 OneDrive에서 Word, Excel, PowerPoint(이전 .doc, .xls, .ppt 파일 포함), PDF 및 .txt, .md, .csv 같은 일반 텍스트 형식을 읽습니다. OneNote를 포함한 다른 형식은 읽을 수 없습니다. 전체 목록은 Microsoft 365에 연결을 참조하세요.
통합이 Microsoft 365 데이터를 수정할 수 있나요?
Entra 관리자가 쓰기 범위를 부여한 후에만 가능합니다. 쓰기 도구가 켜져 있으면 Claude는 이메일을 보내고, 초안 및 일정 이벤트를 관리하고, 사서함 설정을 업데이트하고, OneDrive 및 SharePoint에서 파일을 만들고 업데이트하고, Microsoft Teams에서 메시지를 보낼 수 있습니다(채널에 게시/답글, 채팅 메시지 보내기 또는 사용자를 대신하여 새 채팅 시작). 이는 항상 각 구성원의 기존 Microsoft 365 권한 범위 내에서 수행됩니다. 쓰기 범위가 없으면 통합은 읽기 전용입니다. Claude는 여전히 Teams 설정이나 권한을 변경할 수 없으며 메시지만 보낼 수 있습니다.
