FlowStudio MCP を使用した Power Automate モニタリング

FlowStudio MCP のキャッシュストアを通じて、フロー健全性を監視し、障害率を追跡し、テナント資産をインベントリ化します — 高速読み込み、PA API レート制限なし、ガバナンスメタデータと修復ヒントで充実しています。

⚠️ Pro+ サブスクリプションが必須です。 このスキルは FlowStudio for Teams または MCP Pro+ サブスクライバーのみが利用可能な store_* ツールを呼び出します。

ユーザーが Pro+ アクセス権を持たない場合： 最初の store_* ツール呼び出しは 403/404 エラーを返します。その場合は：

1. store ツールの呼び出しを中止する
2. この機能には Pro+ サブスクリプションが必要であることをユーザーに伝える
3. https://mcp.flowstudio.app/pricing へのリンクを提供する
4. 質問がライブツール（例：「1 つの環境のフローをリストする」）で答えられる場合は、代わりに flowstudio-power-automate-mcp スキルを使用することを提案する

ディスカバリー： tools/list ではなく tool_search 経由でツールスキーマを読み込みます — query: "select:list_store_flows,get_store_flow_summary" で一般的なモニタリングツールを呼び出すか、query: "skill:governance" で全セットを読み込みます（サーバーのガバナンスバンドルはほとんどのモニタリング読み込みもカバーしています — このスキルと flowstudio-power-automate-governance は基盤となるツールファミリーを共有しています）。このドキュメントは応答形状、動作メモ、ワークフローパターンをカバーしています — tool_search が伝えられないことです。このドキュメントが実際の API レスポンスと矛盾する場合は、API が優先されます。

---

モニタリングの仕組み

Flow Studio は毎日、各サブスクライバーについて Power Automate API をスキャンし、結果をキャッシュします。2 つのレベルがあります：

• すべてのフローはメタデータをスキャンされます：定義、接続、所有者、トリガータイプ、および集計実行統計（runPeriodTotal、runPeriodFailRate など）。環境、アプリ、接続、およびメーカーもスキャンされます。
• 監視対象フロー（monitor: true）は追加で実行ごとの詳細を取得します：ステータス、継続時間、失敗したアクション名、および修復ヒントを含む個々の実行レコード。これが get_store_flow_runs と get_store_flow_summary に入力されるものです。

データの鮮度： フローが最後にスキャンされた時期を確認するには、get_store_flow の scanned フィールドをチェックしてください。古い場合は、スキャンパイプラインが実行されていない可能性があります。

モニタリングの有効化： update_store_flow または Flow Studio for Teams アプリ（フローの選択方法）で monitor: true を設定します。

重要なフローの指定： ビジネスクリティカルなフローに update_store_flow で critical=true を使用します。これにより、ガバナンススキルの通知ルール管理が重要なフローの障害アラートを自動設定できるようになります。

---

ツール

ツール	目的
list_store_flows	障害率とモニタリングフィルターを含むフローをリストする
get_store_flow	完全なキャッシュレコード：実行統計、所有者、ティア、接続、定義（triggerUrl フィールド含む）
get_store_flow_summary	集計実行統計：成功/失敗率、平均/最大継続時間
get_store_flow_runs	継続時間、ステータス、失敗したアクション、修復を含む実行ごとの履歴（エラーのみのビューには status="Failed" をフィルター）
update_store_flow	モニター フラグ、通知ルール、タグ、ガバナンスメタデータを設定する
list_store_environments	すべての Power Platform 環境
list_store_connections	すべての接続
list_store_makers	すべてのメーカー（市民開発者）
get_store_maker	メーカーの詳細：フロー/アプリ数、ライセンス、アカウントステータス
list_store_power_apps	すべての Power Apps キャンバスアプリ

開始/停止には、monitor-flow サーバーバンドルから set_live_flow_state を使用します（tool_search query: "select:set_live_flow_state"） — キャッシュは次のスキャン時に再同期されます。以前の set_store_flow_state 便利ラッパーは廃止されました。

---

ストア vs ライブ

質問	ストア使用	ライブ使用
何個のフローが失敗していますか？	list_store_flows	—
30 日間の失敗率は？	get_store_flow_summary	—
フローのエラー履歴を表示する	get_store_flow_runs（status="Failed" をフィルター）	—
このフローを誰が構築しましたか？	get_store_flow → owners をパース	—
完全なフロー定義を読む	get_store_flow はそれを持っている（JSON 文字列）	get_live_flow（構造化）
実行からアクション入力/出力を検査する	—	get_live_flow_run_action_outputs
失敗した実行を再送信する	—	resubmit_live_flow_run

ストアツールは「何が起きたのか？」と「どれくらい健全か？」に答えます。 ライブツールは「何が正確に間違ったのか？」と「今すぐ修正する」に答えます。

get_store_flow_runs または get_store_flow_summary が空の結果を返す場合は、次を確認してください：(1) フローに monitor: true が設定されていますか？ (2) scanned フィールドは最近ですか？ get_store_flow を使用して両方を確認します。

---

レスポンス形状

list_store_flows

直接配列。フィルター：monitor（ブール値）、rule_notify_onfail（ブール値）、rule_notify_onmissingdays（ブール値）。

[
  {
    "id": "Default-<envGuid>.<flowGuid>",
    "displayName": "Stripe subscription updated",
    "state": "Started",
    "triggerType": "Request",
    "triggerUrl": "https://...",
    "tags": ["#operations", "#sensitive"],
    "environmentName": "Default-aaaaaaaa-...",
    "monitor": true,
    "runPeriodFailRate": 0.012,
    "runPeriodTotal": 82,
    "createdTime": "2025-06-24T01:20:53Z",
    "lastModifiedTime": "2025-06-24T03:51:03Z"
  }
]

id 形式：Default-<envGuid>.<flowGuid>。最初の . で分割して environmentName と flowName を取得します。

triggerUrl と tags はオプションです。一部のエントリはスパース（id + monitor のみ） — displayName がないエントリはスキップしてください。

list_store_flows のタグはフローの description フィールドから自動抽出されます（メーカーのハッシュタグ（#operations など））。update_store_flow(tags=...) を経由して書き込まれたタグは別途保存され、get_store_flow にのみ表示されます — リスト応答には表示されません。

get_store_flow

完全なキャッシュレコード。重要なフィールド：

カテゴリ	フィールド
アイデンティティ	name、displayName、environmentName、state、triggerType、triggerKind、tier、sharingType
実行統計	runPeriodTotal、runPeriodFails、runPeriodSuccess、runPeriodFailRate、runPeriodSuccessRate、runPeriodDurationAverage/Max/Min（ミリ秒）、runTotal、runFails、runFirst、runLast、runToday
ガバナンス	monitor（ブール値）、rule_notify_onfail（ブール値）、rule_notify_onmissingdays（数値）、rule_notify_email（文字列）、log_notify_onfail（ISO）、description、tags
鮮度	scanned（ISO）、nextScan（ISO）
ライフサイクル	deleted（ブール値）、deletedTime（ISO）
JSON 文字列	actions、connections、owners、complexity、definition、createdBy、security、triggers、referencedResources、runError — すべて解析するために json.loads() が必要

継続時間フィールド（runPeriodDurationAverage、Max、Min）はミリ秒単位です。秒に変換するには 1000 で割ります。

runError は最後の実行エラーを JSON 文字列として含みます。これを解析します： json.loads(record["runError"]) — エラーがない場合は {} を返します。

get_store_flow_summary

時間枠にわたる集計統計（デフォルト：過去 7 日間）。

{
  "flowKey": "Default-<envGuid>.<flowGuid>",
  "windowStart": null,
  "windowEnd": null,
  "totalRuns": 82,
  "successRuns": 81,
  "failRuns": 1,
  "successRate": 0.988,
  "failRate": 0.012,
  "averageDurationSeconds": 2.877,
  "maxDurationSeconds": 9.433,
  "firstFailRunRemediation": null,
  "firstFailRunUrl": null
}

ウィンドウ内にこのフローの実行データが存在しない場合は、すべてゼロを返します。ウィンドウを変更するには startTime と endTime（ISO 8601）パラメーターを使用します。

get_store_flow_runs

キャッシュされた実行レコードの直接配列。パラメーター：startTime、endTime、status（配列 — エラーのみのビューには ["Failed"] を渡す、["Succeeded"]、または省略してすべてを表示）。

ウィンドウ内に実行データが存在しない場合は [] を返します。

トリガー URL

get_store_flow（キャッシュ）または get_live_flow（ライブ）から直接 triggerUrl フィールドを読み込みます。非 HTTP トリガーの場合は null です。

フローの開始/停止

monitor-flow サーバーバンドルから set_live_flow_state を使用します。キャッシュは次の日次スキャンで追いつきます。スキャンが同期されるまでキャッシュの鮮度が必要な場合は、ステータス変更後に get_live_flow を呼び出して確認します。

update_store_flow

ガバナンスメタデータを更新します。指定されたフィールドのみが更新されます（マージ）。完全に更新されたレコードを返します（get_store_flow と同じ形状）。

設定可能なフィールド：monitor（ブール値）、rule_notify_onfail（ブール値）、rule_notify_onmissingdays（数値、0 = 無効）、rule_notify_email（カンマ区切り）、description、tags、businessImpact、businessJustification、businessValue、ownerTeam、ownerBusinessUnit、supportGroup、supportEmail、critical（ブール値）、tier、security。

list_store_environments

直接配列。

[
  {
    "id": "Default-aaaaaaaa-...",
    "displayName": "Flow Studio (default)",
    "sku": "Default",
    "type": "NotSpecified",
    "location": "australia",
    "isDefault": true,
    "isAdmin": true,
    "isManagedEnvironment": false,
    "createdTime": "2017-01-18T01:06:46Z"
  }
]

sku 値：Default、Production、Developer、Sandbox、Teams。

list_store_connections

直接配列。非常に大きくなる可能性があります（1500 項目以上）。

[
  {
    "id": "<environmentId>.<connectionId>",
    "displayName": "user@contoso.com",
    "createdBy": "{\"id\":\"...\",\"displayName\":\"...\",\"email\":\"...\"}",
    "environmentName": "...",
    "statuses": "[{\"status\":\"Connected\"}]"
  }
]

createdBy と statuses は JSON 文字列です — json.loads() で解析します。

list_store_makers

直接配列。

[
  {
    "id": "09dbe02f-...",
    "displayName": "Sample Maker",
    "mail": "maker@contoso.com",
    "deleted": false,
    "ownerFlowCount": 199,
    "ownerAppCount": 209,
    "userIsServicePrinciple": false
  }
]

削除されたメーカーは deleted: true を持ち、displayName/mail フィールドがありません。

get_store_maker

完全なメーカーレコード。重要なフィールド：displayName、mail、userPrincipalName、ownerFlowCount、ownerAppCount、accountEnabled、deleted、country、firstFlow、firstFlowCreatedTime、lastFlowCreatedTime、firstPowerApp、lastPowerAppCreatedTime、licenses（M365 SKU の JSON 文字列）。

list_store_power_apps

直接配列。

[
  {
    "id": "<environmentId>.<appId>",
    "displayName": "My App",
    "environmentName": "...",
    "ownerId": "09dbe02f-...",
    "ownerName": "Catherine Han",
    "appType": "Canvas",
    "sharedUsersCount": 0,
    "createdTime": "2023-08-18T01:06:22Z",
    "lastModifiedTime": "2023-08-18T01:06:22Z",
    "lastPublishTime": "2023-08-18T01:06:22Z"
  }
]

---

一般的なワークフロー

不健全なフローを見つける

1. list_store_flows
2. runPeriodFailRate > 0.1 かつ runPeriodTotal >= 5 でフィルター
3. runPeriodFailRate 降順でソート
4. 各フローについて：get_store_flow で詳細を取得

特定のフローの健全性をチェック

1. get_store_flow → scanned（鮮度）、runPeriodFailRate、runPeriodTotal をチェック
2. get_store_flow_summary → オプションの時間枠で集計統計
3. get_store_flow_runs(status=["Failed"]) → 修復ヒント付きの実行ごとの障害詳細
4. さらに深い診断が必要な場合 → ライブツールに切り替え：
   get_live_flow_runs → get_live_flow_run_action_outputs

フローのモニタリングを有効化

1. monitor=true で update_store_flow
2. オプションで rule_notify_onfail=true、rule_notify_email="user@domain.com" を設定
3. 次の日次スキャン後に実行データが表示されます

日次ヘルスチェック

1. list_store_flows
2. runPeriodFailRate > 0.2 かつ runPeriodTotal >= 3 のフローにフラグを立てる
3. state="Stopped" の監視対象フローにフラグを立てる（自動中断を示す可能性）
4. 重大な障害の場合 → get_store_flow_runs(status=["Failed"]) で修復ヒントを取得

メーカー監査

1. list_store_makers
2. 削除されたアカウントで所有されているフローを識別（deleted=true、ownerFlowCount > 0）
3. 特定のユーザーについて get_store_maker で詳細を取得

インベントリ

1. list_store_environments → 環境数、SKU、場所
2. list_store_flows → ステート、トリガータイプ、失敗率別のフロー数
3. list_store_power_apps → アプリ数、所有者、共有
4. list_store_connections → 環境ごとの接続数

---

関連スキル

• flowstudio-power-automate-mcp — 基盤スキル：接続設定、MCP ヘルパー、ツールディスカバリー
• flowstudio-power-automate-debug — アクションレベルの入力/出力による詳細診断（ライブ API）
• flowstudio-power-automate-build — フロー定義の構築とデプロイ
• flowstudio-power-automate-governance — ガバナンスメタデータ、タグ付け、通知ルール、CoE パターン