Referenz zu Work IQ MCP-Tools

Der Work IQ MCP-Server stellt Tools über das Model Context Protocol (MCP) zur Verfügung. Dieser Artikel enthält eine Referenz zu jedem Tool, einschließlich Zweck, Parametern und Verwendungsbeispielen.

Work IQ MCP verwendet die Microsoft Entra-Authentifizierung und die Microsoft 365-Berechtigungen des angemeldeten Benutzers, wenn seine Tools auf Microsoft Graph-Ressourcenpfade zugreifen. Eine separate Mandantenrichtlinienebene wertet jede Toolanforderung aus und blockiert standardmäßig Mutationsvorgänge. Administratoren können unterstützte Erstellungs-, Aktualisierungs-, Lösch- und Aktionsanforderungen über die Mandantenrichtlinie aktivieren. Weitere Informationen finden Sie unter Richtliniengovernance für Work IQ MCP.

Objekttools

Entitätstools stellen CRUD-Vorgänge und -Aktionen für Microsoft 365-Ressourcen bereit. Diese Tools arbeiten mit relativen Ressourcenpfaden, die Microsoft Graph-Endpunkten zugeordnet sind.

fetch

Liest eine oder mehrere Entitäten nach Ressourcenpfad. Unterstützt das Abrufen mehrerer Pfade parallel.

Parameter

Antwort

Eine erfolgreiche Antwort enthält eine results Eigenschaft, bei der es sich um ein Array von Objekten mit den folgenden Eigenschaften handelt. Es gibt ein Objekt für jeden Ressourcenpfad im entityUrls Parameter der Anforderung.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "fetch",
    "arguments": {
      "entityUrls": [
        "/me/messages"
      ]
    }
  }
}

Antwort

{
  "results": [
    {
      "data": {
        "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0c6bc4a2-337b-4672-9bcd-6aa53af1b02a')/messages(id,subject,from,receivedDateTime,isRead,importance)",
        "value": [
          {
            "@odata.etag": "W/\"CQAAABYAAADltuSvpI1YRKDFG38ihSmWAABepTg8\"",
            "id": "AAMkADk0...",
            "receivedDateTime": "2026-05-31T15:40:44Z",
            "subject": "Your weekly PIM digest for Contoso",
            "importance": "normal",
            "isRead": false,
            "from": {
              "emailAddress": {
                "name": "Microsoft Security",
                "address": "MSSecurity-noreply@microsoft.com"
              }
            }
          },
          {
            "@odata.etag": "W/\"CQAAABYAAADltuSvpI1YRKDFG38ihSmWAAA/eZg0\"",
            "id": "AAMkADk0...",
            "receivedDateTime": "2026-05-26T07:39:09Z",
            "subject": "Microsoft Entra ID Protection Weekly Digest",
            "importance": "normal",
            "isRead": false,
            "from": {
              "emailAddress": {
                "name": "Microsoft Security",
                "address": "MSSecurity-noreply@microsoft.com"
              }
            }
          }
        ],
        "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?%24select=id%2csubject%2cfrom%2creceivedDateTime%2cisRead%2cimportance&%24top=10&%24skip=10"
      },
      "statusCode": 200
    }
  ]
}

fetch_blob

Ruft binäre Inhalte wie Dokumente, Bilder und Office-Dateien aus einem relativen Arbeits-IQ-Pfad ab. Der Inhalt wird als Base64-codierte Zeichenfolge mit Metadaten zurückgegeben.

Parameter

Antwort

Eine erfolgreiche Antwort macht die folgenden Eigenschaften über das MCP-Feld structuredContent verfügbar.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "fetch_blob",
    "arguments": {
      "path": "/me/drive/items/01ABCDEF/content"
    }
  }
}

Antwort

{
  "structuredContent": {
    "statusCode": 200,
    "contentType": "text/plain",
    "blobName": "notes.txt",
    "sizeBytes": 14,
    "base64Content": "SGVsbG8sIFdvcmtJUSE="
  }
}

create_entity

Erstellt eine neue Entität in einer Sammlung.

Parameter

Antwort

Eine erfolgreiche Antwort enthält ein Objekt in der structuredContent Eigenschaft mit den folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "create_entity",
    "arguments": {
      "parentUrl": "/me/messages",
      "jsonBody": "{ \"subject\": \"Hello world!\" }"
    }
  }
}

Antwort

{
  "statusCode": 201,
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0c6bc4a2-337b-4672-9bcd-6aa53af1b02a')/messages/$entity",
    "@odata.etag": "W/\"CQAAABYAAADltuSvpI1YRKDFG38ihSmWAABlFT7g\"",
    "id": "AAMkADk0...",
    "createdDateTime": "2026-06-01T17:32:39Z",
    "lastModifiedDateTime": "2026-06-01T17:32:39Z",
    "changeKey": "CQAAABYAAADltuSvpI1YRKDFG38ihSmWAABlFT7g",
    "categories": [],
    "receivedDateTime": "2026-06-01T17:32:39Z",
    "sentDateTime": "2026-06-01T17:32:39Z",
    "hasAttachments": false,
    "internetMessageId": "<CH7PR03MB79063B75F29F929523CCC68FAE152@CH7PR03MB7906.namprd03.prod.outlook.com>",
    "subject": "Hello world!",
    "bodyPreview": "",
    "importance": "normal",
    "parentFolderId": "AQMkADk0...",
    "conversationId": "AAQkADk0...",
    "conversationIndex": "AQHc8eykdVXKjf4ytUio+dQPqWG95A==",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": true,
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": ""
    },
    "toRecipients": [],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
      "flagStatus": "notFlagged"
    }
  }
}

update_entity

Updates vorhandenes Objekt.

Parameter

Antwort

Eine erfolgreiche Antwort enthält ein Objekt in der structuredContent Eigenschaft mit den folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "update_entity",
    "arguments": {
      "entityUrl": "/me/messages/AAMkADk0...",
      "jsonBody": "{ \"subject\": \"Updated: Hello world!\" }"
    }
  }
}

Antwort

{
  "statusCode": 200,
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0c6bc4a2-337b-4672-9bcd-6aa53af1b02a')/messages/$entity",
    "@odata.etag": "W/\"CQAAABYAAADltuSvpI1YRKDFG38ihSmWAABlFT7g\"",
    "id": "AAMkADk0...",
    "createdDateTime": "2026-06-01T17:32:39Z",
    "lastModifiedDateTime": "2026-06-01T17:32:39Z",
    "changeKey": "CQAAABYAAADltuSvpI1YRKDFG38ihSmWAABlFT7g",
    "categories": [],
    "receivedDateTime": "2026-06-01T17:32:39Z",
    "sentDateTime": "2026-06-01T17:32:39Z",
    "hasAttachments": false,
    "internetMessageId": "<CH7PR03MB79063B75F29F929523CCC68FAE152@CH7PR03MB7906.namprd03.prod.outlook.com>",
    "subject": "Updated: Hello world!",
    "bodyPreview": "",
    "importance": "normal",
    "parentFolderId": "AQMkADk0...",
    "conversationId": "AAQkADk0...",
    "conversationIndex": "AQHc8eykdVXKjf4ytUio+dQPqWG95A==",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": true,
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": ""
    },
    "toRecipients": [],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
      "flagStatus": "notFlagged"
    }
  }
}

delete_entity

Löscht ein Objekt.

Parameter

Antwort

Eine erfolgreiche Antwort enthält eine statusCode Eigenschaft, die structuredContent im Feld auf 204 festgelegt ist.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "delete_entity",
    "arguments": {
      "entityUrl": "/me/messages/AAMkADk0MDkyMzM3LTlmNzAtNDhmM...."
    }
  }
}

Antwort

{
  "statusCode": 204
}

do_action

Führt eine Nebeneffektaktion aus, z. B. das Senden von E-Mails, das Kopieren oder Verschieben von Elementen.

Parameter

Antwort

Eine erfolgreiche Antwort enthält ein Objekt in der structuredContent Eigenschaft mit den folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "do_action",
    "arguments": {
      "actionUrl": "/me/messages/AAMkADk0.../send"
    }
  }
}

Antwort

{
  "statusCode": 202
}

call_function

Ruft eine Microsoft Graph-Funktion auf, um abgeleitete Daten wie Zeitpläne, Deltas oder Suchergebnisse zu berechnen.

Parameter

Antwort

Eine erfolgreiche Antwort enthält ein Objekt in der structuredContent Eigenschaft mit den folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "call_function",
    "arguments": {
      "parentUrl": "/me/calendarView?startdatetime=2026-06-01T17:51:49.607Z&enddatetime=2026-06-08T17:51:49.607Z"
    }
  }
}

Antwort

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('0c6bc4a2-337b-4672-9bcd-6aa53af1b02a')/calendarView(id,subject,start,end,location,organizer,isAllDay)",
    "value": [
      {
        "@odata.etag": "W/\"5bbkr6SNWESgxRt/IoUplgAAKcCTsQ==\"",
        "id": "AAMkADk0...",
        "subject": "Sales and Marketing Sync",
        "isAllDay": false,
        "start": {
          "dateTime": "2026-06-08T12:30:00.0000000",
          "timeZone": "UTC"
        },
        "end": {
          "dateTime": "2026-06-08T13:00:00.0000000",
          "timeZone": "UTC"
        },
        "location": {
          "displayName": "Sales and Marketing / General",
          "locationType": "default",
          "uniqueId": "Sales and Marketing / General",
          "uniqueIdType": "private"
        },
        "organizer": {
          "emailAddress": {
            "name": "Sales and Marketing",
            "address": "SalesandMarketing@contoso.com"
          }
        }
      }
    ],
    "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/calendarView?startdatetime=2026-06-01T17%3a51%3a49.607Z&enddatetime=2026-06-08T17%3a51%3a49.607Z&%24select=id%2csubject%2cstart%2cend%2clocation%2corganizer%2cisAllDay&%24top=10&%24skip=10"
  },
  "statusCode": 200
}

Copilot-Tools

Copilot-Tools bieten Informationen in natürlicher Sprache, indem sie Microsoft 365 Copilot aufrufen und verfügbare Agents ermitteln.

fragen

Stellt Microsoft 365 Copilot (oder einem bestimmten Agent) eine Frage in natürlicher Sprache zu Ihren Daten. Wenn Sie eine agentIdangeben, geht die Anforderung an diesen spezifischen Agent. Wenn Sie es weglassen, wird die Anforderung an den integrierten Microsoft 365 Copilot-Agent gesendet.

Parameter

Antwort

Eine erfolgreiche Antwort enthält eine JSON-Zeichenfolge in der text Eigenschaft eines TextContent-Objekts . Die Zeichenfolge enthält die folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "ask",
    "arguments": {
      "question": "Do I have any meetings today?"
    }
  }
}

Antwort

{
  "response": "You have **4 meetings scheduled today**. Here\\u2019s a clear view of your day:...",
  "conversationId": "cc7d6f5202cb4c5b814b120440e48ede"
}

abrufen

Durchsucht Microsoft 365-Daten und verbundene Unternehmensquellen, auf die der angemeldete Benutzer zugreifen kann. Das Tool gibt modellfreundliche Grounding-Markdowns mit Inline-Zitaten und strukturierten Metadaten für jede zitierte Quelle zurück. Die grounding Strategie ist die Standardeinstellung.

Parameter

Dataverse und Power BI sind Roadmapquellen, derzeit nicht unterstützte Abrufquellen. Obwohl das Schema einen Dataverse Funktionsnamen enthält, muss Dataverse weiter ausgewertet werden, bevor es als unterstützt bezeichnet werden kann, und es handelt sich nicht um eine kurzfristige Priorität. Es ist keine Zeitleiste für die Lieferung festgelegt.

Antwort

Die autorisierende Antwortnutzlast liegt in der application/vnd.ms-workiq.retrieval Eigenschaft von structuredContent.

Anforderungsbeispiele, funktionsspezifische Bereiche, SharePoint Embedded-Unterstützung, Anleitung zur Antwortverarbeitung und Fehlerbehandlung finden Sie unter Verwenden des retrieve Tools in Work IQ MCP.

list_agents

Listet verfügbare Agents auf, die Sie mit dem ask Tool verwenden können. Gibt ein JSON-Array verfügbarer Agents zurück, und der integrierte Microsoft 365 Copilot-Agent ist immer enthalten.

Parameter

Dieses Tool akzeptiert keine Parameter.

Antwort

Eine erfolgreiche Antwort enthält eine JSON-Zeichenfolge in der text Eigenschaft eines TextContent-Objekts . Die Zeichenfolge enthält die folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "list_agent",
    "arguments": {}
  }
}

Antwort

[
  {
    "agentId": "bizchat-as-gpt-scenario",
    "name": "Microsoft Copilot",
    "provider": "Microsoft"
  }
]

Schematools

Schematools ermöglichen die Laufzeitermittlung verfügbarer API-Pfade und ihrer OpenAPI-Schemas. Durch die Verwendung dieser Tools können Agenten ermitteln, welche Vorgänge verfügbar sind, ohne große Schemadefinitionen im Voraus in den Kontext laden zu müssen.

get_schema

Ruft das OpenAPI-Schema für einen bestimmten Vorgang ab, identifiziert durch Pfad und Vorgangstyp.

Parameter

Antwort

Eine erfolgreiche Antwort enthält das JSON-Schema oder die TypeScript-Definitionen in der text Eigenschaft eines TextContent-Objekts .

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "get_schema",
    "arguments": {
      "path": "/me/messages",
      "operationType": "fetch"
    }
  }
}

Antwort

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "microsoft.graph.messageCollectionResponse",
  "type": "object",
  "properties": {
    "value": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/microsoft.graph.message"
      }
    }
  },
  "$defs": {
    ...
  }
}

search_paths

Durchsucht verfügbare API-Pfade nach Präfix oder RegEx-Filter. Verwenden Sie dieses Tool, um zu ermitteln, welche Ressourcenpfade verfügbar sind, bevor Sie andere Tools aufrufen.

Parameter

Antwort

Eine erfolgreiche Antwort enthält eine paths Eigenschaft im structuredContent Feld. Bei dieser Eigenschaft handelt es sich um ein Array von Objekten mit den folgenden Eigenschaften.

Beispiel

Anforderung

▶ Öffnen Sie dieses Beispiel in der interaktiven Demo

{
  "method": "tools/call",
  "params": {
    "name": "search_paths",
    "arguments": {
      "filter": "messages"
    }
  }
}

Antwort

{
  "paths": [
    {
      "path": "/admin/serviceAnnouncement/messages",
      "operations": [
        "fetch",
        "create"
      ]
    },
    {
      "path": "/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}",
      "operations": [
        "fetch",
        "create",
        "update"
      ]
    },
    ...
  ]
}

Zulässige Ressourcenpfade

Entitätstools arbeiten mit relativen Ressourcenpfaden. Standardmäßig sind die folgenden Pfadpräfixe zulässig:

• /me/
• /users/
• /sites/

Die folgenden Pfadsegmente sind blockiert:

• /authentication/
• /servicePrincipals/

Fehlerbehandlung

Wenn ein Toolaufruf fehlschlägt, gibt der Work IQ MCP-Server Fehler mit den folgenden Informationen zurück:

• HTTP-Statuscode vom Downstreamdienst
• Retry-After Header für Drosselungsantworten (von Microsoft Graph weitergeleitet)
• Anfordern von Korrelations-IDs zur Problembehandlung

Der Server führt keine automatischen Wiederholungsversuche durch. Der MCP-Client empfängt Fehler und trifft clientseitige Wiederholungsentscheidungen.

Verwandte Inhalte

• Übersicht über Work IQ MCP
• Verwenden des Abruftools in Work IQ MCP
• Migrieren von Workflows für den Agentenabruf zu Work IQ MCP
• Übersicht über die Work IQ-API
• Referenz zu Work IQ-API-Berechtigungen