mcpField
A
azure-cost-management-app

azure-cost-management-app

github.com/julianobarbosaクラウド・DevOps1454 回インストール2 日前に更新
リポジトリ

azure-cost-management-app について

Power BI ServiceでMicrosoft Azure Cost Management Appをインストールし、接続するブラウザー自動化スキルです。EA登録データの設定手順に加え、必要な権限、認証、接続確認を案内します。

主な機能

  1. 01既存アプリのインストール状況を確認
  2. 02AppSourceからMicrosoft公開版をインストール
  3. 03アプリをEA登録データに接続
  4. 04データソース認証を設定
  5. 05更新と接続状態を確認

活用シーン

  1. 01サンプルデータ表示中のアプリを接続
  2. 02EA登録用にCost Management Appを導入
  3. 03認証や更新設定の問題を調査

MCP 対応

Power BI Serviceの画面操作に`mcp__claude-in-chrome__*`ブラウザー自動化ツールを使用します。認証済みのブラウザータブでアプリのインストールと設定を進めます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/julianobarbosa/claude-code-skills --skill azure-cost-management-app

インストール後、Claude Code で/azure-cost-management-appを入力して読み込まれたか確認します。

詳細

Azure Cost Management App — スキルのインストールと接続

Microsoft Azure Cost Management App を Power BI Service にデプロイし、特定のワークスペースと EA 登録に接続するための、エンドツーエンドのブラウザー自動化です。

このスキルを使用する場面

  • ユーザーが AppSource から Power BI に Azure Cost Management App をインストールしたい
  • ユーザーが既存の Cost Management App のインストールを実際の EA データに接続したい
  • ユーザーが登録番号、EA コネクタ、または Cost Management App の「データを接続」に言及している
  • ユーザーが Power BI Service で Azure のコストデータを表示したい(Power BI Desktop ではない)

主な情報(開始前に確認)

テンプレートアプリのワークスペース動作: このアプリのような Power BI テンプレートアプリは、常に自動で名前が付けられた専用のワークスペースを作成します。devops-team のような任意の既存ワークスペースに直接インストールすることはできません。実際に「ワークスペースにデプロイする」とは、次のいずれかを意味します。

  1. 既存の自動作成された AzureCostManagementApp ワークスペースを実際の EA データに接続する(最も一般的)
  2. インストール後、デプロイメントパイプラインを使用してコンテンツを別のワークスペースに昇格させる

EA コネクタの認証: EA 登録用の Azure Cost Management コネクタには、請求先アカウントレベルで Enterprise Administrator(読み取り専用) ロールが必要です。標準の Azure RBAC ロール(Cost Management Reader、Billing Reader)は機能せず、認証エラーが発生します。

アプリの提供元: 必ず Microsoft Corporation からインストールしてください(コミュニティによる複製ではありません)。AppSource ギャラリーでは、Microsoft が公開しているアプリは下の方に表示されます。発行元が個人ユーザー名になっている、ユーザー共有の複製を通り過ぎて下にスクロールしてください。

ワークフロー

手順 1:既存のインストールを確認する

新しいコピーをインストールする前に、アプリの一覧を確認します。

  1. https://app.powerbi.com/groups/me/apps に移動します
  2. Azure Cost Management App の項目があるか確認します
  3. すでに存在する場合(特に「サンプルデータ」と表示されているもの)、ユーザーが必要としているのは新しいコピーのインストールではなく、EA データへの接続である可能性が高いです。続行する前に、意図を確認してください。

確認する質問:「サンプルデータを表示しているインストールがすでにあります。このアプリを EA データに接続しますか、それとも新しいコピーをインストールしますか?」

手順 2:AppSource で見つけてインストールする(新規インストールが必要な場合)
  1. アプリページの右上にある アプリを取得 をクリックします
  2. ギャラリーの検索バーで「Cost Management」を検索します
  3. 下にスクロールします。Microsoft Corporation 版は、ユーザー共有の複製の下に表示されます
  4. 次の情報で識別します:発行元 = 「Microsoft Corporation」、評価は約 2.3 星(73 件のレビュー)、バージョン 1006
  5. アプリカードをクリックし、今すぐ入手 をクリックします
  6. 「続行するには確認してください」ダイアログを確認し、今すぐ入手 をクリックします

インストールダイアログのオプション:

  • 「ワークスペースとアプリを更新する」→ 既存のインストールを更新します(設定を上書きします)
  • 「アプリを更新せずにワークスペースのコンテンツのみを更新する」→ コンテンツのみを更新します
  • 「アプリの別のコピーを新しいワークスペースにインストールする」→ 新しい自動命名ワークスペースを作成します。ワークスペース名の入力が必要です

ユーザーの意図に応じて選択してください。既存のインストールを EA データに接続する場合は、手順 3 に直接進みます。

手順 3:EA データに接続する(「データを接続」)

インストール済みアプリのレポートに移動します(左側のサイドバーにある AzureCostManagementApp ワークスペースアイコン、またはアプリの一覧から移動します)。「Getting Started」ページに、「このアプリはサンプルデータで表示されています。データを接続」というバナーが表示されます。

データを接続 をクリックし、パラメーターのダイアログに入力します。

フィールド値備考
BillingProfileIdOrEnrollmentNumber<enrollment number>例:53329720
NumberOfMonths<integer>例:過去 12 か月分の履歴には 12
ScopeEnrollment Number固定テキストです。スコープタイプの識別子です

次へ をクリックします。

ステップ 4:データソースを認証する(2 ステップ)

ステップ 1/2 — Blob ストレージのエンドポイント(匿名):

  • URL:https://ccmstorageprod.blob.core.windows.net/...
  • 認証方法:Anonymous
  • プライバシーレベル:None
  • サインインして続行をクリックします(ここでは資格情報は不要です)

ステップ 2/2 — EA Cost Management コネクタ(OAuth2):

  • ExtensionDataSourceKind:AzureCostManagement
  • ExtensionDataSourcePath:Enrollment Number;<enrollment-number>(自動入力されます)
  • 認証方法:OAuth2
  • プライバシーレベル:Organizational
  • サインインして接続をクリックします → EA 管理者が認証するための OAuth2 ポップアップが開きます

重要: OAuth2 ポップアップは、自動化セッションの外部にある別のブラウザーウィンドウとして開きます。 ユーザーは、そのポップアップで EA Enterprise Administrator のサインインを手動で完了する必要があります。 ユーザーが確認した後、接続を検証できるよう、戻って「完了」と伝えるよう案内してください。

ステップ 5:接続を確認する

認証が完了したら、ワークスペースのコンテンツ一覧に移動します: https://app.powerbi.com/groups/<workspace-group-id>/list

成功の目印:

  • バナーが次のように変わります:「サンプルデータを使用してこのアプリを表示しています。更新を実行中です。」
  • セマンティックモデルの行に次回の更新日が表示されます(スケジュールは自動構成済みです)
  • ヘッダーのワークスペース名が Azure Cost Management App <timestamp> になっています

認証後、最初の更新は自動的に実行されます。完了まで数分かかることがあります。最初の更新が完了すると、アプリに実際の EA データが表示されます。

ユーザーから収集するパラメーター

開始前に、まだ提供されていない場合は、以下の情報を収集します:

パラメーター説明例
EA Enrollment Number課金アカウントの登録番号53329720
月数読み込むコスト履歴の月数12
対象のワークスペースアプリを配置する場所devops-team(テンプレートアプリは独自のワークスペースを作成する点に注意してください)

ツール

以下の mcp__claude-in-chrome__* ブラウザー自動化ツールを全工程で使用します:

  • tabs_context_mcp — 既存のタブ ID を取得するため、必ず最初に呼び出します
  • navigate — Power BI の URL に移動します
  • computer(スクリーンショット、左クリック、入力、待機、スクロール、ズーム)— UI を操作します
  • browser_batch — 速度を上げるため、独立した連続操作をまとめて実行します
  • find — 自然言語による説明でフォーム要素を見つけます
  • form_input — ref を使ってドロップダウンの値を設定します

新しいタブは Microsoft のサインインページにリダイレクトされるため、新しいタブではなく、認証済みのタブ(app.powerbi.com)を使用します。

よくある問題

「サインインして接続」をクリックしても何も起こらない/ステップ 2 のままになる: OAuth2 ポップアップが Power BI の背後にある別ウィンドウとして開いている可能性があります。Microsoft のサインインポップアップがないかユーザーに確認してもらい、そこで EA 管理者としてのサインインを完了してもらってください。

プライバシーレベルのドロップダウンが空白: 「サインインして接続」をクリックする前に、Organizational に設定します。プライバシーレベルが空白だと、接続が停止することがあります。

認証後に更新が失敗する: EA コネクタには Enterprise Administrator(読み取り専用)が必要です。サインインしたアカウントにそのロールがない場合、更新は失敗します。セマンティックモデルの設定 → 更新履歴で、エラーの詳細を確認してください。

認証後もアプリにサンプルデータが表示される: これは正常です。最初の更新には数分かかります。ワークスペース一覧に移動し、バナーに「更新を実行中です」と表示されているか確認してください。

アプリ一覧に Azure Cost Management App の項目が複数ある: 異なるユーザーがインストールしたコピーである可能性があります。Owner 列を確認してください。現在のユーザーが所有する項目を設定できます。どれに接続するかユーザーに確認してください。


注意点

  • EA コネクターには、課金アカウントレベルでの Enterprise Admin(読み取り専用)権限が必要です。Azure RBAC ではありません。 サブスクリプションスコープで Cost Management Reader を付与しても、エラーなく 0 件の行が返されます。
  • EA Admin ロールの付与後、反映に 30 分かかります。 この間に発生する失敗は認証の問題に見えることがあります。デバッグの前にお待ちください。
  • テンプレートアプリのワークスペースは固定のワークスペース名でデプロイされます。 同じテナントに再インストールすると名前の競合エラーが発生するため、先にアンインストールしてください。
  • 通貨換算: EA データは USD です。アプリは Office の設定に基づく既定の通貨に換算しますが、これはテナントの課金通貨と異なる場合があります。
  • 一部のブラウザー設定では、OAuth2 ポップアップが通知なくブロックされます。 制限の厳しいブラウザーで初めてインストールする場合は、ポップアップを許可リストに登録する必要があります。失敗すると、スピナーが回り続けます。

コメント