Work IQ MCP ツール リファレンス

Work IQ MCP サーバーは、 モデル コンテキスト プロトコル (MCP) を介してツールを公開します。 この記事では、各ツールの目的、パラメーター、使用例など、リファレンスを提供します。

Work IQ MCP は、ツールが Microsoft Graph リソース パスにアクセスするときに、Microsoft Entra 認証とサインインしているユーザーの Microsoft 365 アクセス許可を使用します。 個別のテナント ポリシー レイヤーが各ツール要求を評価し、既定で変更操作をブロックします。 管理者は、テナント ポリシーを通じて、サポートされている作成、更新、削除、およびアクション要求を有効にすることができます。 詳細については、 Work IQ MCP のポリシーガバナンスを参照してください。

エンティティ ツール

エンティティ ツールは、Microsoft 365 リソースに対する CRUD 操作とアクションを提供します。 これらのツールは、 Microsoft Graph エンドポイントにマップされる相対リソース パスで動作します。

フェッチ

リソース パスで 1 つ以上のエンティティを読み取ります。 複数のパスを並列でフェッチできます。

パラメーター

応答

正常な応答には、次のプロパティを持つオブジェクトの配列である results プロパティが含まれています。 要求の entityUrls パラメーターには、リソース パスごとに 1 つのオブジェクトがあります。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "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

相対的な Work IQ パスからドキュメント、画像、Office ファイルなどのバイナリ コンテンツをフェッチします。 コンテンツは、メタデータを含む Base64 エンコード文字列として返されます。

パラメーター

応答

正常な応答は、MCP structuredContent フィールドを介して次のプロパティを公開します。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

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

create_entity

コレクションに新しいエンティティを作成します。

パラメーター

応答

正常な応答には、次のプロパティを持つ structuredContent プロパティのオブジェクトが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "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 します。

パラメーター

応答

正常な応答には、次のプロパティを持つ structuredContent プロパティのオブジェクトが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "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

エンティティを削除します。

パラメーター

応答

成功した応答には、[structuredContent] フィールドに 204 に設定されたstatusCodeプロパティが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "statusCode": 204
}

do_action

メールの送信、アイテムのコピー、移動などの副作用のあるアクションを実行します。

パラメーター

応答

正常な応答には、次のプロパティを持つ structuredContent プロパティのオブジェクトが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "statusCode": 202
}

call_function

Microsoft Graph 関数を呼び出して、スケジュール、差分、検索結果などの派生データを計算します。

パラメーター

応答

正常な応答には、次のプロパティを持つ structuredContent プロパティのオブジェクトが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

{
  "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"
    }
  }
}

応答

{
  "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 ツール

Copilot ツールは、Microsoft 365 Copilot を呼び出し、使用可能なエージェントを検出することで、自然言語インテリジェンスを提供します。

質問する

Microsoft 365 Copilot (または特定のエージェント) に、データについて自然言語で質問します。 agentIdを指定すると、要求はその特定のエージェントに送られます。 省略すると、要求は組み込みの Microsoft 365 Copilot エージェントに移動します。

パラメーター

応答

正常な応答には、TextContent オブジェクトの text プロパティに JSON 文字列が含まれています。 文字列には以下のプロパティが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

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

retrieve

Microsoft 365 データと、サインインしたユーザーがアクセスできる接続されたエンタープライズ ソースを検索します。 このツールは、引用された各ソースのインライン引用と構造化されたメタデータを含む、モデルフレンドリーなグラウンディング Markdown を返します。 grounding戦略が既定です。

パラメーター

Dataverse と Power BI はロードマップ ソースであり、現在サポートされている取得ソースではありません。 スキーマには Dataverse 機能名が含まれていますが、Dataverse がサポートされていると説明するにはさらに評価が必要であり、短期的な優先事項ではありません。 デリバリー タイムラインはコミットされていません。

応答

Authoritative Response Payload is in the application/vnd.ms-workiq.retrieval property of structuredContent.

要求の例、機能固有のスコープ、SharePoint Embedded サポート、応答処理ガイダンス、エラー処理については、「 Work IQ MCP で retrieve ツールを使用する」を参照してください。

list_agents

ask ツールで使用できるエージェントを一覧表示します。 使用可能なエージェントの JSON 配列を返します。組み込みの Microsoft 365 Copilot エージェントは常に含まれます。

パラメーター

このツールはパラメーターを取りません。

応答

正常な応答には、TextContent オブジェクトの text プロパティに JSON 文字列が含まれています。 文字列には以下のプロパティが含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

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

スキーマ ツール

スキーマ ツールを使用すると、利用可能な API パスとその OpenAPI スキーマをランタイムで検出できます。 これらのツールを使用することで、エージェントは、大きなスキーマ定義を前もってコンテキストにロードすることなく、使用可能な操作を検出できます。

get_schema

パスと操作の種類によって識別される、特定の操作の OpenAPI スキーマを取得します。

パラメーター

応答

正常な応答には、TextContent オブジェクトの text プロパティに JSON スキーマまたは TypeScript 定義が含まれています。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

{
  "$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

プレフィックスまたは正規表現フィルターで利用可能な API パスを検索します。 このツールを使用して、他のツールを呼び出す前に、使用可能なリソース パスを検出します。

パラメーター

応答

成功した応答には、[structuredContent] フィールドに paths プロパティが含まれています。 このプロパティは、次のプロパティを持つオブジェクトの配列です。

例

要求

▶ インタラクティブ デモでこの例を開きます

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

応答

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

許可されるリソース パス

エンティティ ツールは相対リソース パスで動作します。 既定では、次のパス プレフィックスを使用できます。

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

次のパス セグメントはブロックされます。

• /authentication/
• /servicePrincipals/

エラー処理

ツールの呼び出しが失敗すると、Work IQ MCP サーバーは次の情報を含むエラーを返します。

• ダウンストリーム サービスからの HTTP 状態コード
• Retry-After 調整応答のヘッダー (Microsoft Graph から渡される)
• トラブルシューティング用の関連付け ID を要求する

サーバーは自動再試行を実行しません。 MCP クライアントはエラーを受信し、クライアント側の再試行を決定します。

関連コンテンツ

• Work IQ MCP の概要
• Work IQ MCP で取得ツールを使用する
• エージェント取得ワークフローを Work IQ MCP に移行する
• Work IQ API の概要
• Work IQ API のアクセス許可リファレンス