intune-mcp

Microsoft Graph API를 통해 Microsoft Intune에 대한 읽기 전용 액세스를 제공하는 MCP 서버입니다. Claude(또는 모든 MCP 클라이언트)가 관리 디바이스, 앱, 규정 준수 정책 및 구성 프로필을 쿼리할 수 있도록 합니다.

사전 요구 사항

• Node.js >= 18

• 위임된 권한이 있는 Azure AD(Entra ID) 앱 등록

• 자동 앱 등록을 위한 Azure CLI(az)(선택 사항)

Related MCP server: azure-query-mcp

빠른 시작

1. Azure AD 앱 등록

# Automated (requires Azure CLI + admin consent permissions)
.\scripts\register-app.ps1 -WriteEnv

# Or manually: create a public client app in Entra ID with these delegated permissions:
#   - DeviceManagementManagedDevices.Read.All
#   - DeviceManagementApps.Read.All
#   - DeviceManagementConfiguration.Read.All
# Then create .env:
#   AZURE_CLIENT_ID=<your-app-client-id>
#   AZURE_TENANT_ID=<your-tenant-id>

2. 설치 및 빌드

npm install
npm run build

3. 인증

npm run auth

디바이스 코드 프롬프트에 따라 Microsoft 계정으로 로그인합니다.

4. 실행

# Stdio mode (for local MCP clients like Claude Code)
npm start

# HTTP mode (for shared/remote deployment)
npm run start:http

전송 모드

HTTP 모드는 포트 3000에서 Express 서버를 시작합니다(--port 또는 PORT 환경 변수로 구성 가능). 엔드포인트는 다음과 같습니다:

사용 가능한 도구

필요한 권한(위임됨)

• DeviceManagementManagedDevices.Read.All

• DeviceManagementApps.Read.All

• DeviceManagementConfiguration.Read.All

개발

npm run dev          # TypeScript watch mode
npm test             # Run unit tests
npm run build        # Compile to dist/

실시간 검증

실제 Intune 테넌트에 대해 12개 엔드포인트 모두 테스트(사전 인증 필요):

node scripts/validate-tools.mjs

아키텍처

MCP Client -> Transport (stdio | HTTP) -> McpServer -> Tool Handlers -> GraphClient -> Microsoft Graph API

• 인증: MSAL 디바이스 코드 흐름, ~/.intune-mcp/token-cache.json의 파일 기반 토큰 캐시

• 로깅: ~/.intune-mcp/logs/intune-mcp.log의 구조화된 JSON 라인(10MB 회전, 5개 파일)

• Graph 클라이언트: 지수 백오프가 있는 자동 재시도(429, 401, 5xx), Retry-After 지원, 30초 요청 시간 제한, 최대 10페이지까지 자동 페이지 매김

• HTTP 모드: 세션별 인증, 30분 세션 TTL, 100세션 상한