SharePoint Access via Playwright

Zugriff auf SharePoint-Dokumente und -Seiten ueber den Playwright MCP Server mit automatischer Microsoft-Authentifizierung.

Voraussetzungen

• •Playwright MCP Server muss aktiv sein (siehe .vscode/mcp.json)
• •Azure CLI Login muss bestehen (az login bereits durchgefuehrt)
• •Dokumente werden bei Bedarf unter .assets/ zwischengespeichert

Workflow

Schritt 1: Login-Identitaet ermitteln

Vor dem SharePoint-Zugriff die E-Mail-Adresse des angemeldeten Benutzers abfragen:

az ad signed-in-user show --query "mail" -o tsv

Aus der E-Mail die Domain extrahieren (z.B. user@contoso.com ergibt contoso.com). Den Login-Namen (volle E-Mail) fuer die Authentifizierung merken.

Schritt 2: SharePoint-Seite navigieren

mcp_playwright_browser_navigate -> URL der SharePoint-Seite

Schritt 3: Microsoft-Login behandeln

Nach Navigation pruefen, ob eine Microsoft-Login-Seite erscheint:

1. •mcp_playwright_browser_snapshot ausfuehren
2. •Nach Account-Auswahlbuttons suchen, die die ermittelte E-Mail-Domain enthalten
3. •Den passenden Account-Button anklicken:
   code

   mcp_playwright_browser_click -> auf den Account-Button mit der erkannten E-Mail
   

4. •Warten bis die SharePoint-Seite vollstaendig geladen ist:
   code

   mcp_playwright_browser_wait_for -> Seiteninhalt sichtbar
   

Wichtig: Falls kein Account-Button erscheint und stattdessen ein E-Mail-Eingabefeld:

1. •E-Mail-Adresse eingeben via mcp_playwright_browser_fill_form
2. •"Weiter"/"Next" anklicken
3. •Warten bis SSO/SAML-Redirect abgeschlossen ist

Schritt 4: Inhalte extrahieren

Fuer Detail-Workflows zur Inhaltsextraktion siehe references/content-extraction.md.

Kurzuebersicht:

Schritt 5: Dokumente herunterladen und zwischenspeichern

Fuer den vollstaendigen Dokument-Handling-Workflow siehe references/document-handling.md.

Kurzuebersicht:

Dokumente werden im Ordner .assets/ zwischengespeichert. Struktur:

.assets/
  SharePoint/
    <site-name>/
      dokument1.pdf
      dokument2.xlsx
      ...

Download-Ablauf:

1. •Link identifizieren - Dokument-URL aus dem Snapshot extrahieren
2. •Dateityp pruefen - PDF, DOCX, XLSX, PPTX, etc.
3. •Im Browser oeffnen - Link anklicken, SharePoint-Viewer oeffnet sich
4. •Screenshot erstellen - mcp_playwright_browser_take_screenshot fuer visuellen Kontext
5. •Download-URL extrahieren - Download-Button im SharePoint-Viewer suchen und Direktlink ermitteln
6. •Lokal speichern - Via PowerShell-Terminal herunterladen:

# Zielverzeichnis sicherstellen
New-Item -ItemType Directory -Force -Path ".assets/SharePoint/<site-name>"

# Download via Invoke-WebRequest (Cookie-basiert, wenn noetig)
Invoke-WebRequest -Uri "<direkter-download-link>" -OutFile ".assets/SharePoint/<site-name>/<dateiname>"

Alternativ bei authentifiziertem Zugriff ueber PnP PowerShell:

# Falls PnP.PowerShell verfuegbar
Connect-PnPOnline -Url "https://<tenant>.sharepoint.com/sites/<site>" -Interactive
Get-PnPFile -Url "/sites/<site>/Shared Documents/<dateiname>" -Path ".assets/SharePoint/<site-name>" -AsFile

Schritt 6: Inhalt analysieren und zusammenfassen

Nach dem Zugriff:

• •Strukturierte Zusammenfassung der gefundenen Inhalte erstellen
• •Navigationsstruktur und wichtige Links dokumentieren
• •Kontaktinformationen hervorheben
• •Quellenangabe mit SharePoint-URL angeben

Fehlerbehandlung

Einschraenkungen

• •Keine Passwort-Eingabe - Nur SSO/Account-Picker-basierte Authentifizierung
• •MFA erfordert ggf. manuelle Benutzerinteraktion
• •Grosse Dateien (>50 MB) koennen beim Download laenger dauern
• •DRM-geschuetzte Dokumente koennen nicht heruntergeladen werden