次の方法で共有

Microsoft 365ユーザープロファイルMCPサーバー参照

重要

Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 フロンティアは、Microsoft の最新の AI イノベーションと直接接続します。 Frontier のプレビューは、お客様の契約書に記載されている既存のプレビュー利用規約に従います。 これらの機能は現在開発中であるため、提供状況や機能は今後変更される可能性があります。

概要

サーバー ID 表示名称 プロパティ
mcp_MeServer Microsoft 365ユーザープロファイルMCPサーバー 自己認識と組織的認識のための MCP サーバー。 この MCP サーバーを使用して、組織内のユーザープロファイルにアクセスし、自身のプロファイル、他のユーザーのプロファイル、ユーザーの直属の上司、または直属の部下を取得するなど、さまざまな操作を実行できます。

使用可能なツール

mcp_graph_getDirectReports

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

必須のパラメーター:

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

注意

『私』を userIdentifierとして送らないでください。 表示名のみが利用可能な場合は、まずユーザーを検索して userPrincipalName またはオブジェクトIDを取得します。

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

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

mcp_graph_getMyManager

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

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

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

mcp_graph_getMyProfile

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

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

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

mcp_graph_getUserProfile

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

必須のパラメーター:

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

注意

「me」を送信しないでください。 表示名のみが利用可能な場合、まずユーザーを検索します。

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

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

mcp_graph_getUsersManager

ディレクトリ内の指定したユーザーのマネージャーを取得します。 ユーザーのオブジェクトID(GUID)か userPrincipalName (メールのようなUPN)のいずれかを提供する必要があります。 「私」を userIdentifier に使わず、サインインしているユーザーには mcp_graph_getMyManager を使ってください。

必須のパラメーター:

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

注意

「me」を送信しないでください。 表示名のみが利用可能な場合、まずユーザーを検索します。

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

  • 選択: マネージャーが返すプロパティのカンマ区切られたリスト(例: id,displayName、 mail、 jobTitle、 userPrincipalName)

mcp_graph_listUsers

組織内のユーザーの一覧を取得します。 $select、$filter、$top、$orderby などのクエリのオプションをサポートします。 ConsistencyLevel デフォルトで最終設定に設定されています。

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

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

主な機能

自己認識

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

ユーザー プロファイル

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

組織階層

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

ユーザー発見

  • 組織内のユーザーを一覧表示する
  • 自動フォールバック付きフリー テキスト検索
  • OData のフィルター処理と順序付け
  • 改ページ位置の自動調整のサポート
  • 結果でユーザーをカウントする

クエリ機能

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

ノート

  • サインインユーザーには mcp_graph_getMyProfile を使い、「私」と mcp_graph_getUserProfile しないでください。
  • サインインしたユーザーのマネージャーには mcp_graph_getMyManager を使います
  • ユーザー識別子はオブジェクトID(GUID)または userPrincipalName (UPN)でなければならず、表示名は使わないでください
  • 表示名のみが表示されている場合は、まず mcp_graph_listUsers でユーザーを検索してください
  • $expand 1リクエストごとに1つのプロパティ(manager または directReports)しか拡張できません。
  • 検索が失敗した場合、$search は自動的に $filter にフォールバックします
  • 高度なクエリには ConsistencyLevel 'eventual' が必要となります
  • 検索形式: '"property:value"' (引用符付き)

一般的なユース ケース

自分の情報を取得する

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

ユーザーを検索する

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

    例: search='"displayName:John"' (john という名前のユーザーを検索する)

  • 結果から userPrincipalName やオブジェクトIDを取得してください

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

  • mcp_graph_getUserProfile で userIdentifier を使用する
  • select を使用して特定のプロパティを取得する
  • expandを使えば manager を含めるか、 directReports

4. 組織構造の取得

  • mcp_graph_getUsersManagerを使ってユーザーのマネージャーを取得してください
  • mcp_graph_getDirectReportsを使ってユーザーの直属の部下を取得できます
  • チェーン呼び出しによるレポート階層のナビゲーション
  • Last updated on