FlowStudio MCP — AI エージェント向け Power Automate スキル

AI エージェントに、Power Automate ポータルと同等以上の可視性を提供します。 Graph API は最上位の実行ステータスしか返さないため、エージェントはアクションの入力、ループの反復、ネストされたエラーを確認できません。Flow Studio MCP はそのすべてを公開します。

人間はポータルをクリックして根本原因を見つけることができますが、MCP がなければエージェントにはそれができません。

このツールが必要な理由

• エージェントがフローの失敗を検知しても、その理由がわからない（Graph API はステータスコードしか返さないため）

• ポータルと同様に、エージェントにアクションレベルの入力と出力を確認させたい

• ループに数百の反復があり、一部で不正な出力が生成された場合、ポータルでは一つずつクリックする必要がありますが、エージェントならすべての反復の入力と出力を一度にスキャンできる

• 管理センターを開かずに、テナント全体のフローの健全性、失敗率、作成者のアクティビティを確認したい

• CoE スターターキットをインストールせずに、フローの分類、孤立したリソースの検出、コネクタの監査を大規模に行いたい

• エージェントとポータルの間で仲介役を務めることに疲れている

Graph API と Flow Studio MCP の比較

主な違い：Graph API はエージェントに実行ステータスを提供します。MCP はエージェントにすべてのアクションの入力と出力を提供します。

スキル

最初の3つのスキルはライブの Power Automate API 呼び出しを使用します。監視およびガバナンススキルはキャッシュストアを使用します。これは、集計統計、修復のヒント、ガバナンスメタデータを含む日次スナップショットです。ストアツールには FlowStudio for Teams または MCP Pro+ サブスクリプションが必要です。

各スキルは Agent Skills 仕様 に準拠しており、互換性のあるあらゆるエージェントで動作します。

対応エージェント

Copilot, Claude Code, Codex, OpenClaw, Gemini CLI, Cursor, Goose, Amp, OpenHands

クイックスタート

Claude Code プラグインとしてインストール

承認後、Claude プラグインマーケットプレイスから利用可能です。ローカルでテストする場合：

git clone https://github.com/ninihen1/power-automate-mcp-skills.git
claude --plugin-dir ./power-automate-mcp-skills

次に、MCP サーバーを接続します：

claude mcp add --transport http flowstudio https://mcp.flowstudio.app/mcp \
  --header "x-api-key: <YOUR_TOKEN>"

トークンは mcp.flowstudio.app で取得してください。

Codex にインストール

Codex セッション内で、スキルを直接インストールします：

$skill-installer install https://github.com/ninihen1/power-automate-mcp-skills/tree/main/skills/power-automate-mcp
$skill-installer install https://github.com/ninihen1/power-automate-mcp-skills/tree/main/skills/power-automate-debug
$skill-installer install https://github.com/ninihen1/power-automate-mcp-skills/tree/main/skills/power-automate-build
$skill-installer install https://github.com/ninihen1/power-automate-mcp-skills/tree/main/skills/power-automate-monitoring
$skill-installer install https://github.com/ninihen1/power-automate-mcp-skills/tree/main/skills/power-automate-governance

次に、~/.codex/config.toml で MCP サーバーを接続します：

[mcp_servers.flowstudio]
url = "https://mcp.flowstudio.app/mcp"

[mcp_servers.flowstudio.http_headers]
x-api-key = "<YOUR_TOKEN>"

skills.sh 経由でインストール

skills.sh で flowstudio を検索するか、以下を実行します：

npx skills add github/awesome-copilot -s flowstudio-power-automate-mcp
npx skills add github/awesome-copilot -s flowstudio-power-automate-debug
npx skills add github/awesome-copilot -s flowstudio-power-automate-build
npx skills add github/awesome-copilot -s flowstudio-power-automate-monitoring
npx skills add github/awesome-copilot -s flowstudio-power-automate-governance

ClawHub 経由でインストール

npx clawhub@latest install power-automate-mcp

Smithery 経由でインストール

npx smithery skill add flowstudio/power-automate-mcp

手動インストール

スキルフォルダーをプロジェクトの .github/skills/ ディレクトリ（またはエージェントがスキルを検出する場所）にコピーします。

MCP サーバーの接続

Claude Code:

claude mcp add --transport http flowstudio https://mcp.flowstudio.app/mcp \
  --header "x-api-key: <YOUR_TOKEN>"

Codex (~/.codex/config.toml):

[mcp_servers.flowstudio]
url = "https://mcp.flowstudio.app/mcp"

[mcp_servers.flowstudio.http_headers]
x-api-key = "<YOUR_TOKEN>"

Copilot / VS Code (.vscode/mcp.json):

{
  "servers": {
    "flowstudio": {
      "type": "http",
      "url": "https://mcp.flowstudio.app/mcp",
      "headers": { "x-api-key": "<YOUR_TOKEN>" }
    }
  }
}

トークンは mcp.flowstudio.app で取得してください。

実際のデバッグ例

これらはデモではなく、実際の運用調査からの例です。

• 子フローでの式エラー — contains(string(...)) がネストされたプロパティでクラッシュしました。エージェントは親フローから子フロー、ループの反復を追跡し、失敗した入力を特定しました。ポータルにはコンテキストなしで「ExpressionEvaluationFailed」と表示されていました。

• フローのバグではなくデータ入力ミス — ユーザーが立て続けに2つの「バグ」を報告しました。エージェントは両方ともデータ入力ミス（メールのカンマ欠落、CC フィールドの単一アドレス）であることを証明しました。フローは正しく、数秒で診断されました。

• Null 値による子フローのクラッシュ — レコードの 38% に Null 名が含まれていたため、split(Name, ', ') がクラッシュしました。エージェントは親から子、ループ、アクションへと追跡し、根本原因を特定して update_live_flow を介して修正をデプロイしました。

前提条件

• FlowStudio MCP サブスクリプション（すべてのライブツール）

• ストアツール（監視、ガバナンス）の場合：FlowStudio for Teams または MCP Pro+

• MCP エンドポイント: https://mcp.flowstudio.app/mcp

• API キー / JWT トークン (x-api-key ヘッダーとして渡されます)

リポジトリ構造

skills/
  power-automate-mcp/          core connection & operation skill
  power-automate-debug/        debug workflow skill
  power-automate-build/        build & deploy skill
  power-automate-monitoring/   flow health & tenant inventory skill
  power-automate-governance/   compliance & governance skill
examples/                      real debugging walkthroughs
README.md
LICENSE                        MIT

GitHub で利用可能

Copilot、Claude、および MCP 互換エージェントで動作します。

• awesome-copilot (マージ済み)

• skills.sh (3,000+ インストール)

• Smithery (公開済み)

• ClawHub (v1.1.0)

貢献

貢献を歓迎します。各スキルフォルダーには、必要なフロントマターを含む SKILL.md が含まれている必要があります。形式については既存のスキルを参照してください。

ライセンス

MIT

キーワード: Power Automate デバッグ, フロー実行履歴, 式の評価失敗, 子フローの失敗, ネストされたアクションエラー, ループ反復出力, エージェント自動化 MCP, Power Platform AI, フロー定義デプロイ, 失敗した実行の再送信, フロー監視, ガバナンス, CoE, 孤立リソース検出, コネクタ監査, アーカイブスコア, 作成者インベントリ