次の方法で共有

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 には ”me" を使用しないでください。

必須のパラメーター:

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

注意

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

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

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

mcp_graph_getMyManager

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

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

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

mcp_graph_getMyProfile

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

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

  • select: ユーザー プロファイルプロパティのコンマ区切りリスト
  • expand: 関連エンティティ (manager、directReports など) を展開します

mcp_graph_getUserProfile

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

必須のパラメーター:

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

注意

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

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

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

mcp_graph_getUsersManager

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

必須のパラメーター:

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

注意

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

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

  • select: マネージャーに返すプロパティのカンマ区切りのリスト (id、displayName、mail、jobTitle、userPrincipalName など)

mcp_graph_listUsers

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

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

  • top: 最初の n 人のユーザーのみを表示する
  • select: 返すユーザー プロパティのカンマ区切りリスト
  • filter: プロパティでユーザーをフィルター処理する (例: startswith(displayName,'A'))
  • orderby: 指定されたプロパティ (displayName など) で結果を並べ替えます
  • search: ユーザーのフリー テキスト検索。 形式: '"property:value"'、例: '"displayName:Neha"' は、'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
  • 最終的な整合性のサポート

ノート

  1. ログイン済みユーザーには mcp_graph_getMyProfile を使用し、「me」 を含む mcp_graph_getUserProfile は使用しないでください
  2. サインイン済みユーザーのマネージャーを取得するには mcp_graph_getMyManager を使用します
  3. userIdentifier はオブジェクト ID (GUID) または userPrincipalName (UPN) でなければならず、表示名は使用できません
  4. 表示名のみ利用可能な場合、mcp_graph_listUsers を使用してユーザーを最初に使用して検索します
  5. $expand はリクエストごとに 1 つのプロパティのみ展開できます (manager または directReports)
  6. 検索が失敗した場合、$search は自動的に $filter にフォールバックします
  7. 高度なクエリには ConsistencyLevel 'eventual' が必要となります
  8. 検索形式: '"property:value"' (引用符付き)

一般的なユース ケース

自分の情報を取得する

  • mcp_graph_getMyProfile を使用して現在のユーザーのプロファイルを取得する
  • mcp_graph_getMyManager を使用して現在のユーザーのマネージャーを取得する

2. ユーザーの検索

  • 検索パラメーターで mcp_graph_listUsers を使用する

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

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

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

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

4. 組織構造の取得

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