MCP 経由で Microsoft Power BI を Meta Muse に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Microsoft Power BI をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Microsoft Power BI + Meta Muse

Microsoft の職場アカウントでサインインする Power BI REST API：ワークスペース、セマンティックモデル、レポート、ダッシュボード、データフロー、ゲートウェイ、アプリ、モデルへの DAX クエリ、データソース、パラメーター、更新履歴とスケジュール、更新の開始とキャンセル。モデルのパラメーター変更はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

ステップ 1 — 認証情報を取得

設定は最初に一度だけ、約 10 分です。Power BI ライセンス（Free、Pro、Premium Per User）付きの Microsoft 職場または学校アカウントと、無料の Microsoft Entra アプリ登録が必要です。組織によっては管理者しか同意を付与できません。

1. https://entra.microsoft.com を開き、Applications、App registrations、New registration に進みます。別の Microsoft コネクタのアプリ登録を再利用することもできます。
2. サポートされるアカウントの種類は、通常 Accounts in this organizational directory only を選びます。Power BI は職場または学校アカウントでのみ動作し、個人の Microsoft アカウントでは使えません。
3. リダイレクト URI：プラットフォーム Web で、AnythingMCP Cloud なら https://cloud.anythingmcp.com/api/mcp-oauth/callback、AnythingMCP を自分でホストしている場合は <your AnythingMCP URL>/api/mcp-oauth/callback です。1 文字単位で一致させる必要があり、違うと Microsoft が AADSTS50011 を返します。
4. API permissions、Add a permission、Power BI Service、Delegated permissions で、Workspace.Read.All、Dataset.ReadWrite.All、Report.Read.All、Dashboard.Read.All、Dataflow.ReadWrite.All、Gateway.Read.All、App.Read.All にチェックを入れます。読み取り専用のコネクタにするなら、代わりに Dataset.Read.All と Dataflow.Read.All を選びます。組織でユーザー自身が同意できない場合は、続けて Grant admin consent をクリックします。
5. Certificates & secrets、New client secret で、シークレットの Value（一度しか表示されません）をコピーします。Secret ID ではありません。
6. Application (client) ID を MICROSOFT_CLIENT_ID に、シークレットの値を MICROSOFT_CLIENT_SECRET に貼り付けます。MICROSOFT_TENANT_ID には Directory (tenant) ID、contoso.onmicrosoft.com のようなドメイン、またはマルチテナントアプリなら organizations を設定します。common と consumers は使えません。コネクタをインストールします。
7. コネクタのページで Authorize with Provider をクリックし、Power BI ライセンスを持つユーザーでサインインします。リフレッシュトークンは暗号化して保存され、アクセストークンは自動で更新されます。確認のため power_bi_list_workspaces を実行します。

スコープ: コネクタは https://analysis.windows.net/powerbi/api/.default offline_access を要求します。.default は手順 4 でチェックした Power BI の権限を付与し（追加や削除はそこで行い、もう一度承認します）、offline_access はリフレッシュトークンを与えます。このコネクタに Microsoft Graph のスコープは追加しないでください。1 つのトークンは 1 つの API にしか使えません。

誰の権限で動くか: AI には、サインインしたユーザーが Power BI サービスで見られるものがそのまま見えます。行レベルセキュリティのあるモデルは、そのユーザーが見られる行だけを返します。

読み取れるデータ: ワークスペースと、どのロールで誰がアクセスできるか；ワークスペースごとのセマンティックモデル（データセット）、レポートとそのページ、ダッシュボードとそのタイル、データフロー、.pbix・.rdl・.xlsx・.json ファイルのインポート；ワークスペース ID を持たないユーザーのマイ ワークスペース（My workspace）の内容。power_bi_list_my_datasets、power_bi_list_my_reports、power_bi_list_my_dashboards で取得します；レポートとダッシュボードを含むインストール済みアプリ；モデルのデータソースと Power Query パラメーター；更新履歴（失敗した更新は serviceExceptionJson にエラーがあります）、拡張更新の詳細、更新スケジュール；データフローの更新トランザクションとデータソース；ユーザーが管理するオンプレミスゲートウェイ、そのデータソース、ゲートウェイがデータソースに到達できるかどうかです。

DAX クエリ: power_bi_execute_dax_query はセマンティックモデルの数値で質問に答えます。テナント設定 Dataset Execute Queries REST API（新しい管理ポータルでは Semantic model Execute Queries REST API。Admin portal、Tenant settings、Integration settings）が有効で、ユーザーがモデルの Read と Build の権限を持っている必要があります。Azure Analysis Services でホストされるモデルには対応しません。1 回の呼び出しで 1 クエリ、EVALUATE で始め（DEFINE の後でも可）、DAX のみです。モデルを把握するには、EVALUATE COLUMNSTATISTICS() でテーブルと列を一覧し、EVALUATE TOPN(5, 'Table') でサンプル行を表示します。API はメジャーを一覧しない（INFO 関数と DMV クエリは拒否されます）ため、AI はメジャー名をあなたに尋ねるか、レポートに表示されているものを使い、生の列を合計するよりモデルのメジャーを優先します。impersonated_user_name は行レベルセキュリティ下で別のユーザーの見え方を確認するもので、モデルへの書き込み権限が必要です。

書き込める内容: power_bi_refresh_dataset、power_bi_cancel_refresh、power_bi_refresh_dataflow はインストール時にオンです。更新はソースを読み込み、1 日の更新回数の上限に数えられるため、AI は開始前にあなたに確認します。データセットの更新は本文なしの 202 を返し、新しい実行は進行中 Unknown のステータスで power_bi_get_refresh_history の先頭に表示されます。共有容量（Pro）では、スケジュール更新を含めモデルごとに 1 日 8 回まで、指定できるのは notify_option のみです。type、objects、commit_mode などのオプションを付けると拡張更新になり、Premium、PPU、Fabric の容量が必要で、notify_option は送れません。power_bi_get_refresh_details で追跡し power_bi_cancel_refresh でキャンセルできるのは拡張更新だけです。

インストール時はオフ: power_bi_update_dataset_parameters です。モデルの Power Query パラメーター（たとえば読み込むサーバーや期間）を変更し、次回の更新から反映されます。AI にそれをさせる場合だけ、ツール単位でオンにしてください。

データ形式: 一覧は {"value": [...]} で返ります。ID は GUID です。時刻は UTC の ISO 8601 です。webUrl で Power BI サービスの項目が開きます。DAX の結果は results[0].tables[0].rows に入り、列のキーは Table[Column]、計算列は [Name] です。

ページングとフィルター: 一覧ツールはすべてを一度に返します。例外は power_bi_list_workspaces と power_bi_list_workspace_users で、top と skip でページングします。ワークスペースは OData で絞り込めます。例：contains(name,'Sales')。

制限: DAX クエリが返すのは 1 つのテーブルで、最大 100,000 行または 1,000,000 値のどちらか先に達するほう、かつ 15 MB までです。ユーザーごとに毎分 120 クエリまで実行できます。Power BI REST API はユーザー単位とテナント単位でスロットリングし、429 応答には Retry-After が付きます。Premium 容量は過負荷になると更新を遅らせ、1 時間を超えてスロットリングされた更新は失敗します。

よくあるエラー: 401 は承認の期限切れまたは取り消し、あるいはクライアントシークレットの期限切れを意味します。必要なら新しいシークレットを貼り付け、もう一度 Authorize with Provider をクリックしてください。403 PowerBINotAuthorizedException または Unauthorized は、ユーザーがそのワークスペースや項目にアクセスできない、手順 4 の権限が足りない、または DAX の場合に Build 権限かテナント設定が欠けていることを意味します。404 ItemNotFound または PowerBIEntityNotFound は ID の誤りか、項目が別のワークスペースにあることを意味します。400 DatasetExecuteQueriesError は DAX クエリが無効であることを意味し、エンジンのメッセージが理由を示します。更新時の 400 は、拡張オプションと一緒に notify_option を送った、共有容量で拡張オプションを使った、またはすでに更新が実行中であることを意味します。

このコネクタはレポート、ダッシュボード、モデルの作成・編集・削除は行わず、.pbix ファイルのアップロードもせず、Microsoft Graph も使いません。個人の Microsoft アカウントでは動作しません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Muse にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Muse はリモート MCP サーバーをカスタムコネクタとして追加し、OAuth でサインインします。

1. Muse で Settings → Connectors を開き、Add custom connector を選びます。
2. MCP サーバーの URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID を貼り付けます。
3. Muse が AnythingMCP のサインインページを開きます。サインインしてアクセスを承認します。
4. チャットで、Microsoft Power BI のツールが必要になる依頼を Muse にしてみましょう。

チャットから設定することもできます（Web、iOS・Android アプリ、WhatsApp）。Muse に次のメッセージを送ってください:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

セルフホストの場合は、https://cloud.anythingmcp.com の代わりにインスタンスの公開 HTTPS アドレスを使ってください。Muse は Meta のクラウドから接続するため、localhost は使えません。

利用可能なツール

プロンプトの例

• 「Sales ワークスペースのセマンティックモデルのうち、前回の更新に失敗したものはどれで、原因は何ですか？」
• 「Sales Overview レポートの背後にあるモデルで、2026 年第 3 四半期の地域別売上はいくらでしたか？」
• 「Finance モデルのテーブルと列、そして Orders テーブルのサンプル行を 5 行見せてください。」
• 「Executive Summary レポートのページと、KPI ダッシュボードのタイルを一覧にしてください。」
• 「Inventory モデルの今日の更新履歴を見せて、私が確認したら更新を開始してください。」

FAQ

Muse はどこで使えますか? Meta は現在、Muse を米国とカナダで提供しています。Web、iOS・Android アプリ、WhatsApp で利用できます。

Meta はこのコネクタを審査しますか? いいえ。Meta はカスタムコネクタを審査しません。Muse に見えるのは、AnythingMCP でこの MCP サーバーに対して有効にしたツールだけです。コネクタはいつでも Settings → Connectors で切断できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Gemini に接続
• Microsoft Copilot に接続