pbi-mcp-doctor

Diagnoses and configures read-only Power BI MCP server integration for Seshat BI workspaces.

2|Updated Jun 22, 2026
One-click install
npx skills add https://github.com/Kemetra/Seshat-BI --skill pbi-mcp-doctor-kemetra
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pbi-mcp-doctor
Source: https://github.com/Kemetra/Seshat-BI/tree/main/distribution/bundle-templates/shared/skills/pbi-mcp-doctor
Command: npx skills add https://github.com/Kemetra/Seshat-BI --skill pbi-mcp-doctor-kemetra

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams wiring Microsoft's official Power BI MCP servers into a Seshat BI workspace risk unsafe configurations, unverified prerequisites, and accidental mutation paths. This Skill provides a governed, read-only doctor that maps tasks to the correct Power BI surface, generates secret-scanned config templates, and runs safe preflight checks without ever granting approvals or mutating models. ## Core Features & Use Cases - Environment Doctor: Maps a task intent (model-edit, published-query, report-authoring, and more) to the governed Power BI surface, reporting recommendations, missing prerequisites, and the next named-human step. - Safe Config Generation: Produces placeholder-only, read-only .mcp.json templates that are secret-scanned before emission and refuse to overwrite existing files. - Read-Only Preflight: Validates runtime availability, refuses write-mode configs and --skipconfirmation, and gracefully skips when no MCP runtime is installed. - Use Case: A developer asks how to query a published semantic model from their agent harness; the doctor checks tenant prerequisites (preview setting, Build permission, Copilot license) and either names the missing prerequisite or records a write-once advisory at .seshat/powerbi-mcp-recommendation.yaml. ## Quick Start Ask the assistant to run the Power BI MCP doctor for your repo with an intent such as published-query to see which official MCP server fits and what prerequisites are missing.

Frequently Asked Questions about pbi-mcp-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I connect Power BI MCP servers to a Seshat BI workspace?▼

Run the read-only doctor with your task intent, such as published-query or report-authoring, to get a governed recommendation. Then generate a placeholder-only config with the safe generator and run the read-only preflight; never edit .mcp.json by hand or launch a server directly.

What Power BI tasks can the MCP doctor route to official Microsoft servers?▼

The doctor maps eight closed-vocabulary intents including model-edit, published-query, report-authoring, report-formatting, desktop-verification, db-connectivity, ci-validation, and sensitive-production. Each intent routes to the appropriate governed surface or names a blocking gate.

Can the Power BI MCP integration modify my semantic model?▼

No. The F016 execution adapter is parked, so all mutation paths are blocked even when semantic_model_ready has passed. The family only produces read-only diagnostics and two advisory records behind explicit flags.

Why does the report-authoring recommendation stay blocked?▼

Report authoring requires an exact target table with a committed semantic-model pass, a complete named-human dashboard_ready approval, and a harness probe confirming the official skill is discoverable. Until all three hold, the doctor reports the gate and the next human step.

Does the preflight work when no MCP runtime is installed?▼

Yes. When no MCP runtime is present, preflight reports a graceful skip with exit code 0 rather than failing. It still refuses write-mode configs and any --skipconfirmation invocation.

Will generated MCP configs contain credentials or tenant IDs?▼

No. Generated configs are placeholder-only and secret-scanned before emission; the generator refuses to write anything secret-shaped. That refusal is final and must never be bypassed by writing the file manually.