Skip to main content

:::warning AUTO-GENERATED — do not edit This page is generated from the MCP server snapshot content/guide-mcp.json. Edit the source MCP server (not this file), then run npm run generate. :::

Embed an existing Power BI report (migration bridge)

When to use: You are migrating a PowerBI dashboard and want to embed the existing report while rebuilding pieces natively.

Prerequisites​

  • The dashboard has a Power BI embedded config available via the dashboards GraphQL service.

Steps​

Step 1: Discover the embedded-config query on the dashboards service.​

Tools: list_microservices, search_endpoints, get_endpoint_details

Step 2: Fetch the embed config through the gateway with request<T>() and render with the Power BI client.​

Step 3: Run the quality gate.​

Full recipe definition​

The complete machine-readable recipe as returned by the MCP server:

{
  "id": "embed-powerbi",
  "title": "Embed an existing Power BI report (migration bridge)",
  "when": "You are migrating a PowerBI dashboard and want to embed the existing report while rebuilding pieces natively.",
  "prerequisites": [
    "The dashboard has a Power BI embedded config available via the dashboards GraphQL service."
  ],
  "steps": [
    {
      "action": "Discover the embedded-config query on the dashboards service.",
      "tools": [
        "list_microservices",
        "search_endpoints",
        "get_endpoint_details"
      ],
      "note": "coreDashboard (GraphQL) exposes dashboardEmbeddedConfig { accessToken, reportId, embedUrl, expiration }."
    },
    {
      "action": "Fetch the embed config through the gateway with `request<T>()` and render with the Power BI client.",
      "files": [
        "src/lib/dashboard.ts",
        "src/components/{feature}/powerBiReport.tsx"
      ],
      "note": "Handle token expiration (refresh before expiry). CSP already allows PowerBI frames at the gateway."
    },
    {
      "action": "Run the quality gate.",
      "note": "npm run verify"
    }
  ],
  "filesToCreate": [
    "src/components/{feature}/powerBiReport.tsx"
  ],
  "validation": [
    "`npm run verify` passes.",
    "Embed config is fetched at runtime — never hardcode tokens."
  ],
  "doneCriteria": [
    "verify green",
    "No embedded secrets/tokens committed."
  ],
  "commonMistakes": [
    "Hardcoding an access token.",
    "Ignoring token expiration."
  ],
  "relatedRecipes": [
    "add-kpi-page"
  ]
}