Übersicht über Work IQ MCP

Der Work IQ MCP-Server macht Microsoft 365 Intelligence-Funktionen für KI-Agents über das Modellkontextprotokoll (Model Context Protocol, MCP) verfügbar. Es bietet eine Reihe generischer Tools, mit denen Agents Microsoft 365-Entitäten lesen, erstellen, aktualisieren und löschen, Microsoft 365 Copilot für natürliche Sprache aufrufen und API-Schemas ermitteln können – alles über einen einzelnen MCP-Endpunkt.

Entwurfsgrundsätze

Work IQ MCP basiert auf den folgenden Entwurfsprinzipien:

  • Weniger Tools, mehr Pfade. Generische Tools arbeiten mit Ressourcenpfaden. Neue Workloads fügen Pfade und keine Tools hinzu– die Tooloberfläche wächst nie.
  • Introspektion über Enumeration. Agents fordern schemas zur Laufzeit (get_schema) an, anstatt Tausende von Typdefinitionen in den Kontext zu laden.
  • Richtlinie für Bereiche. Vier umfassende OAuth-Berechtigungsgate-Funktionen; Eine differenzierte Zugriffssteuerung wird pro Pfad, Methode und Mandantenrichtlinie erzwungen.

Toolkategorien

Die 10 Tools sind in vier Kategorien unterteilt:

Kategorie Tools Beschreibung
Entitätstools fetch, create_entity, update_entity, delete_entity, do_action, call_function CRUD-Vorgänge und -Aktionen für Microsoft 365-Ressourcen
Copilot-Tools ask, list_agents Aufrufen Microsoft 365 Copilot für natürliche Sprachintelligenz und Ermitteln verfügbarer Agents
Schematools get_schema, search_paths Ermitteln verfügbarer API-Pfade und Abrufen von OpenAPI-Schemas zur Laufzeit

Ausführliche Informationen zu den einzelnen Tools, einschließlich Parametern, finden Sie unter Work IQ MCP tool reference( Work IQ MCP tool reference).

Funktionsweise von Tools

Tools arbeiten mit relativen Ressourcenpfaden. Der Pfad zeigt die Ressource an, und das Tool fungiert als Verb:

fetch /me/messages                         → read my emails
do_action /me/sendMail                     → send an email
create_entity /me/events                   → create a calendar event
fetch /me/chats/{id}/messages              → read Teams chat messages
call_function /search/query                → semantic search
ask "What deals closed this quarter?"      → invoke Copilot agent

Neue Workloads, Back-Ends und Datenquellen fügen Pfade und keine Tools hinzu. Die Werkzeugoberfläche bleibt bei 10 fixiert.

Authentifizierung

Der Work IQ MCP-Server verwendet Microsoft Entra ID für die Authentifizierung. MCP-Clients ermitteln die Authentifizierungskonfiguration automatisch über den /.well-known/oauth-protected-resource Endpunkt. Ausführliche Informationen zu den erforderlichen Berechtigungen finden Sie unter Work IQ API permissions reference .For details on required permissions, see Work IQ API permissions reference.for details on required permissions, see Work IQ API permissions reference.

Hinweis

Der Work IQ-Dienstprinzipal wird automatisch im Mandanten erstellt, wenn Work IQ zum ersten Mal verwendet wird. In einigen Fällen, z. B. beim Konfigurieren der Work IQ MCP-Richtlinie im Microsoft 365 Admin Center vor einer MCP-Verwendung im Mandanten, ist der Dienstprinzipal möglicherweise noch nicht vorhanden, und die Richtlinienkonfiguration kann fehlschlagen. Mandantenadministratoren können es bereitstellen, indem sie die Schritte unter Aktivieren Ihres Mandanten für Work IQ ausführen.