次の方法で共有

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

重要

  • これはプレビュー機能です。
  • プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能は、追加使用条件の対象であり、公式リリース前にお客様が早期にアクセスし、フィードバックを提供できるよう利用可能になっています。

概要

サーバー ID 表示名称 説明
mcp_MeServer 作業IQユーザー 自己認識と組織的認識のための 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)

注意

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

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

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

mcp_graph_getUsersManager

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

必須のパラメーター:

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

注意

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

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

  • 選択: マネージャーが返すプロパティのカンマ区切られたリスト(例: 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を使用し、mcp_graph_getUserProfilemeは使用しないでください。
  • サインインしたユーザーのマネージャーには mcp_graph_getMyManager を使います
  • ユーザー識別子はオブジェクト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 を使います

    例: 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