Microsoft 365 Servis Sağlığı MCP Sunucusu

Microsoft 365 servislerinin (Teams, Exchange, SharePoint, Intune vb.) genel sağlık durumu ve bilinen olaylar/kesintiler hakkında salt-okunur bir Model Context Protocol sunucusu. ArubaCentralMCP / JamfMCP / DefenderCloudAppsMCP / TeamsCallsMCP / IntuneMCP / EntraIDMCP ile aynı mimari desenle yazılmıştır ve NetRadar Copilot Studio ajan ailesinin bir parçasıdır.

Amaç

"Bu genel bir Microsoft kesintisi mi, yoksa sorun yalnızca bizde mi?" sorusuna hızlı, kanıta dayalı yanıt vermek — sıfır kişisel veri (PII) içerir, yalnızca Microsoft'un kendi tenant'a özel servis durumu/duyuru bilgisi.

Mimari

flowchart LR
    A["MCP İstemcisi<br/>(Copilot Studio / Claude Code)"] -->|"HTTPS<br/>Authorization: Bearer &lt;token&gt;"| B["Caddy<br/>(aruba-mcp-vm üzerinde,<br/>yedinci site block'u)"]
    B -->|"127.0.0.1:8426"| C["m365-health-mcp.service<br/>Python / mcp.server.MCPServer"]
    C -->|"OAuth2 client_credentials<br/>Bearer &lt;access_token&gt;"| D["Microsoft Graph API<br/>/admin/serviceAnnouncement/healthOverviews<br/>/admin/serviceAnnouncement/issues"]

Barındırma: aruba-mcp-vm (Azure, ArubaMCP resource group) üzerinde yedinci bir systemd servisi (m365-health-mcp.service, port 8426) ve Caddy'de yedinci bir site block'u olarak çalışır. Dedike, ayrıcalıksız m365healthmcp sistem kullanıcısı altında.

Kimlik Doğrulama

Microsoft Entra ID, Doğuş Grubu tenant'ı. Ayrı bir Entra ID App Registration (M365HealthMCP), OAuth2 client_credentials akışı, tek bir application permission: ServiceHealth.Read.All (admin consent almış) — bu alan için Microsoft'un sunduğu tek seçenek, daha dar bir alternatif yok.

Araçlar

Tool	Açıklama
get_service_health_overview	Abone olunan tüm M365 servislerinin güncel durumu (sorunsuz/degraded özet dahil)
list_service_issues	Bilinen olay/kesintiler — başlık, etki, sınıflandırma, çözüldü mü, en son durum güncellemesi

Not: Graph'ın canlı v1.0 uç noktası status alanını camelCase (serviceOperational) döndürüyor; resmi Microsoft dokümanındaki örnek yanıltıcı şekilde PascalCase (ServiceOperational) gösteriyor. Kod büyük/küçük harfe duyarsız karşılaştırma yapıyor.

Gizlilik

Bu sunucu hiçbir kullanıcıya özel veri döndürmez — yalnızca Microsoft'un kendi servis durumu/duyuru bilgisi. Yazma/aksiyon işlemi içermez (Graph'ta zaten bu alanda bir yazma uç noktası yok).