OneDrive-Speicher

Übersicht

Der OneDrive-Speicheranbieter ermöglicht Dateioperationen über die Microsoft Graph API. Unterstützt persönliches OneDrive, OneDrive for Business und SharePoint-Dokumentbibliotheken.

Voraussetzungen

Microsoft-Azure-Konto
Azure-Active-Directory-(Entra-ID)-Mandant
App-Registrierung mit Microsoft-Graph-Berechtigungen

Setup

Anwendung in Azure AD registrieren

Gehen Sie ins Azure-Portal > Azure Active Directory > App registrations > New registration:
- Name: satware AI OnlyOffice MCP
- Unterstützte Kontotypen: Einzelmandant oder Mehrmandant
- Redirect-URI: http://localhost:8080/oauth/callback (für delegierte Authentifizierung)
- Notieren Sie sich die Application (client) ID und die Directory (tenant) ID
Client-Secret erstellen

Gehen Sie zu Certificates & secrets > New client secret. Kopieren Sie den Secret-Wert sofort (er wird nicht wieder angezeigt).
API-Berechtigungen konfigurieren

Gehen Sie zu API permissions > Add a permission > Microsoft Graph:
- Anwendung (Server)
- Delegiert (Benutzer)
- Wählen Sie Application permissions
- Hinzufügen: Files.ReadWrite.All, User.Read.All
- Klicken Sie auf Grant admin consent
- Wählen Sie Delegated permissions
- Hinzufügen: Files.ReadWrite, Files.ReadWrite.All

Authentifizierungsarten

Anwendung (empfohlen für Server)

Am besten für automatisierte Systeme ohne Benutzerinteraktion:

{
  "type": "onedrive",
  "tenantId": "your-tenant-id",
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "authType": "application",
  "userId": "user@contoso.com"
}

Delegiert (interaktiv)

Für Anwendungen, die im Auftrag eines Benutzers handeln:

{
  "type": "onedrive",
  "tenantId": "your-tenant-id",
  "clientId": "your-client-id",
  "authType": "delegated"
}

Konfiguration

Parameter	Erforderlich	Beschreibung
`type`	Ja	Muss `"onedrive"` sein
`tenantId`	Ja	Azure-AD-Tenant-ID
`clientId`	Ja	Application (client) ID
`clientSecret`	Nein	Client-Secret (erforderlich für Anwendungsauthentifizierung)
`authType`	Nein	`"application"` oder `"delegated"` (Standard: `"delegated"`)
`userId`	Nein	Benutzer-ID/UPN (erforderlich für Anwendungsauthentifizierung)
`driveId`	Nein	Spezifische Drive-ID (für SharePoint)
`basePath`	Nein	Basis-Pfad-Präfix

SharePoint-Dokumentbibliothek

{
  "type": "onedrive",
  "tenantId": "xxx-xxx-xxx",
  "clientId": "yyy-yyy-yyy",
  "clientSecret": "your-secret",
  "authType": "application",
  "driveId": "b!xxxxx-drive-id",
  "basePath": "/Shared Documents"
}

Umgebungsvariablen

Variable	Beschreibung
`STORAGE_TYPE`	Auf `onedrive` setzen
`AZURE_TENANT_ID`	Azure-AD-Tenant-ID
`AZURE_CLIENT_ID`	Application-ID
`AZURE_CLIENT_SECRET`	Client-Secret