ユーザーリファレンス(プレビュー)

概要

使用可能なツール

mcp_graph_getDirectReports

ディレクトリ内の指定したユーザーの直属の部下を一覧表示します。 ユーザーのオブジェクトID(GUID)か userPrincipalName (メールのようなUPN)のいずれかを提供する必要があります。 meとしてuserIdentifierを使用しないでください。

[Required parameters]\(必須のパラメーター\):

• ユーザー識別子: ユーザーのオブジェクトID(GUID)または userPrincipalName (UPN)

オプション パラメーター:

• 選択: 返すプロパティのカンマ区切られたリスト(例: id、 displayName、 mail、 jobTitle、 userPrincipalName)
• top: 1 ページあたりに表示する品目の数

mcp_graph_getMyManager

サインインしているユーザー (呼び出し元) のマネージャーを取得します。 このエンドポイントは常に現在のユーザーのコンテキストのマネージャーを返します。

オプション パラメーター:

• select: マネージャー プロパティを返すカンマ区切りリスト

mcp_graph_getMyProfile

サインインしているユーザー (呼び出し元) のプロファイルの詳細を取得します。 このエンドポイントは常に現在のユーザーのコンテキストのプロファイルを返します。

オプション パラメーター:

• select: ユーザー プロファイルプロパティのコンマ区切りリスト
• 展開: 関連テーブル(例:Manager、 directReports)を展開する

mcp_graph_getUserProfile

ディレクトリ内の指定したユーザーのプロファイルを取得します。 ユーザーのオブジェクトID(GUID)か userPrincipalName (メールのようなUPN)のいずれかを提供する必要があります。 meとしてuserIdentifierを使用しないでください。 サインインしているユーザーには、 mcp_graph_getMyProfileを使用します。

[Required parameters]\(必須のパラメーター\):

• ユーザー識別子: ユーザーのオブジェクトID(GUID)または userPrincipalName (UPN)

オプション パラメーター:

• select: カンマ区切りで返すユーザーのプロパティリスト
• 展開: 関連するテーブル(マネージャーまたは directReports)を展開します。 要求ごとに展開できるプロパティは 1 つだけです。

mcp_graph_getUsersManager

ディレクトリ内の指定したユーザーのマネージャーを取得します。 ユーザーのオブジェクト ID (GUID) または userPrincipalName (電子メールのような UPN) を指定します。 meとしてuserIdentifierを使用しないでください。 サインインしているユーザーには、 mcp_graph_getMyManagerを使用します。

[Required parameters]\(必須のパラメーター\):

• ユーザー識別子: ユーザーのオブジェクトID(GUID)または userPrincipalName (UPN)

オプション パラメーター:

• select: マネージャーに対して返すプロパティのコンマ区切りの一覧。たとえば id、displayName、mail、jobTitle、userPrincipalName

mcp_graph_listUsers

組織内のユーザーの一覧を取得します。 $select、$filter、$top、$orderbyなどのクエリ オプションをサポートします。 既定の ConsistencyLevel は最終的です。

オプション パラメーター:

• ページのトップへ： 最初の n 人のユーザーのみを表示する
• select: カンマ区切りで返すユーザーのプロパティリスト
• フィルター: プロパティでユーザーを絞り込みます。例えば startswith(displayName,'A')
• orderby: 順序は与えられた性質によって得られる。例えば displayName
• search: ユーザーのフリー テキスト検索。 形式: "property:value" (displayName:Neha を含む表示名を検索するなど)。 スペースを含む複数のプロパティをサポートします。 フォールバック ルール: $search が失敗した場合、または結果が返されない場合は、 $filterを使用して自動的に再試行します。
• カウント： 項目の数を含める (true または false)
• ConsistencyLevel: 高度なクエリに必要なヘッダー (既定値: 最終的)

主要な機能

自己認識

• サインインしているユーザーのプロファイルを取得します。
• サインインしているユーザーのマネージャーを取得します。
• 現在のユーザー コンテキスト情報にアクセスします。
• ユーザー識別子は必要ありません。

ユーザー プロフィール

• ID または UPN でユーザーのプロファイルを取得します。
• displayName、mail、jobTitleなどのユーザー プロパティにアクセスします。
• managerやdirectReportsなどの関連テーブルを展開します。
• $selectを使用してプロパティを選択します。

組織階層

• ユーザーのマネージャーを取得します。
• ユーザーの直属の部下を取得します。
• レポート構造内を移動します。
• マネージャーと直属の部下の関係

ユーザー発見

• 組織内のユーザーをリストアップしましょう。
• 自動フォールバックを使用したフリーテキスト検索。
• OData のフィルター処理と順序付け。
• ページネーションのサポート。
• 結果のユーザー数をカウントします。

クエリ機能

• プロパティを選択するための OData $select。
• ユーザー フィルター処理用の OData $filter。
• 関連エンティティに対する OData $expand
• 並べ替えのための OData $orderby。
• フォールバック付きのフリーテキスト $search。
• 最終的な整合性のサポート。

メモ

• サインインしているユーザーにはmcp_graph_getMyProfileを使用し、meを付けたmcp_graph_getUserProfileは使用しないでください。
• サインインしているユーザーのマネージャーには mcp_graph_getMyManager を使いましょう。
• userIdentifier オブジェクトID(GUID)か userPrincipalName (UPN)でなければならず、表示名は使わないでください。
• 表示名のみが利用可能な場合は、まず mcp_graph_listUsers でユーザーを検索してください。
• $expand は、要求ごとに 1 つのプロパティのみを展開できます (manager または directReports)。
• $search には、検索が失敗した場合に $filter への自動フォールバックがあります。
• ConsistencyLevel は、 高度なクエリに最終的に必要です。
• 検索形式: "property:value" (引用符付き)。

一般的なユース ケース

自分の情報を取得する

• mcp_graph_getMyProfileを使って現在のユーザーのプロフィールを取得してください。
• mcp_graph_getMyManagerを使って現在のユーザーのマネージャーを取得してください。

ユーザーを検索する

• 検索パラメータで mcp_graph_listUsers を使います。

  例: John という名前のユーザーを検索 search='"displayName:John"' 。

• 結果から userPrincipalName またはオブジェクト ID を取得します。

ユーザーの詳細を取得する

• mcp_graph_getUserProfile で userIdentifier を使用する。
• selectを使用して特定のプロパティを取得します。
• manager または directReports を含めるには、expand を使用します。

組織構造を取得する

• mcp_graph_getUsersManagerを使用して、ユーザーのマネージャーを取得します。
• mcp_graph_getDirectReports を使用すると、ユーザーの直属の部下を取得できます。
• 呼び出しをチェーンしてレポート階層を移動します。