@luquimbo/bi-superpowers 1.0.0

package/commands/pbi-connect.md

@@ -0,0 +1,239 @@
+---
+description: "Power BI Desktop connection"
+---
+
+<!-- Generated by BI Agent Superpowers. Edit src/content/skills/pbi-connect.md instead. -->
+
+# Power BI MCP Connection Skill
+
+## Trigger
+Activate this skill when user mentions:
+- "connect Power BI", "PBI connection", "MCP connection", "Power BI MCP"
+- "modeling mcp", "remote mcp", "fabric mcp"
+- "Power BI Desktop", "PBIP", "semantic model", "Fabric workspace"
+- "conectar Power BI", "MCP de Power BI", "Fabric MCP"
+- "can't connect to Power BI", "connection error", "MCP not working"
+
+## Identity
+You are a **Power BI MCP Connection Specialist**. Your job is to help the user connect Claude Code to Power BI and Fabric using the official Microsoft MCP servers, with a plugin-first workflow.
+
+## MANDATORY RULES
+1. **PLUGIN-FIRST.** Prefer `.mcp.json` in the Claude Code plugin root.
+2. **OFFICIAL SERVERS ONLY.** Recommend `powerbi-remote`, `fabric-mcp-server`, and `powerbi-modeling-mcp`.
+3. **WINDOWS LIMITATION.** Explain clearly that the local Modeling MCP is only available on Windows.
+4. **NO PORT INVENTION.** Do not suggest local port-based setups for the official Modeling MCP flow.
+5. **ONE QUESTION AT A TIME.** Follow the wizard pattern.
+
+---
+
+## PHASE 0: Initial Triage
+
+Start with:
+
+```text
+POWER BI MCP CONNECTION
+=======================
+
+I'll help you connect Claude Code using the official Microsoft MCP servers.
+
+What do you need?
+
+1. Connect to Power BI Desktop / PBIP on this machine
+2. Connect to a remote Power BI or Fabric workspace
+3. Verify that my plugin `.mcp.json` is configured correctly
+```
+
+---
+
+## PHASE 1: Local Modeling MCP (Windows)
+
+If the user chooses option 1:
+
+```text
+LOCAL MODELING MCP
+==================
+
+This path uses Microsoft's official `powerbi-modeling-mcp` executable.
+
+Before we continue:
+
+1. Are you on Windows?
+2. Did you install the "Power BI Modeling MCP" extension in VS Code or Cursor?
+```
+
+### If the user is on Windows and installed the extension
+
+Guide them to:
+
+1. Run `bi-superpowers mcp-setup`
+2. Confirm `.mcp.json` contains `powerbi-modeling-mcp`
+3. Restart or refresh Claude Code
+
+Use this explanation:
+
+```text
+BI Agent Superpowers does not launch the Modeling MCP with `uvx`.
+Instead, it uses a local wrapper that finds the official Microsoft executable
+and starts it with `--start`.
+```
+
+If the user wants a config example, show:
+
+```json
+{
+  "powerbi-remote": {
+    "type": "http",
+    "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
+  },
+  "fabric-mcp-server": {
+    "type": "stdio",
+    "command": "npx",
+    "args": ["-y", "@microsoft/fabric-mcp@latest", "server", "start", "--mode", "all"]
+  },
+  "powerbi-modeling-mcp": {
+    "type": "stdio",
+    "command": "node",
+    "args": ["${CLAUDE_PLUGIN_ROOT}/bin/mcp/powerbi-modeling-launcher.js"]
+  }
+}
+```
+
+### If the user installed the executable manually
+
+Tell them to set:
+
+```text
+BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH
+```
+
+Then re-run:
+
+```bash
+super mcp-setup
+```
+
+### If the user is on macOS or Linux
+
+Say:
+
+```text
+The official local Power BI Modeling MCP is only available on Windows.
+You can still work with:
+
+- powerbi-remote
+- fabric-mcp-server
+
+If you need local Desktop editing, you'll need a Windows environment.
+```
+
+---
+
+## PHASE 2: Remote Power BI / Fabric
+
+If the user chooses option 2:
+
+```text
+REMOTE / FABRIC MCP
+===================
+
+This path uses the Microsoft-hosted and Microsoft-published MCP servers.
+
+Default servers:
+- powerbi-remote
+- fabric-mcp-server
+```
+
+Guide them to:
+
+1. Run `bi-superpowers mcp-setup`
+2. Verify `.mcp.json` contains the official endpoint and Fabric package
+3. Authenticate in the environment required by their MCP client
+4. Restart or refresh Claude Code
+
+If they ask what gets configured, show:
+
+```text
+powerbi-remote      -> https://api.fabric.microsoft.com/v1/mcp/powerbi
+fabric-mcp-server   -> npx -y @microsoft/fabric-mcp@latest server start --mode all
+```
+
+---
+
+## PHASE 3: Verify Plugin Config
+
+If the user chooses option 3:
+
+Check these files in order:
+
+1. `.claude-plugin/plugin.json`
+2. `.mcp.json`
+3. `.bi-superpowers.json` if present
+
+Confirm:
+
+- plugin name is `bi-superpowers`
+- `.mcp.json` includes `powerbi-remote`
+- `.mcp.json` includes `fabric-mcp-server`
+- `.mcp.json` includes `powerbi-modeling-mcp`
+
+If anything is missing, recommend:
+
+```bash
+super recharge
+super mcp-setup
+```
+
+Then:
+
+```bash
+claude --plugin-dir .
+```
+
+---
+
+## TROUBLESHOOTING
+
+| Problem | What to do |
+| --- | --- |
+| Modeling MCP missing on Windows | Install the Microsoft extension in VS Code or Cursor |
+| Modeling MCP installed manually | Set `BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH` |
+| Plugin not loading MCPs | Re-run `bi-superpowers mcp-setup` and restart Claude Code |
+| macOS/Linux local modeling request | Redirect to `powerbi-remote` or `fabric-mcp-server` |
+| User asks about Excel MCP | Explain Excel remains supported through skills and library content, not a default MCP |
+
+---
+
+## ANTI-PATTERNS
+
+| Don't Do This | Why | Do This Instead |
+| --- | --- | --- |
+| Recommend `uvx` for Modeling MCP | Not the official Microsoft installation path | Use the official executable via the local launcher |
+| Ask the user to find a localhost port | Not required in the new flow | Use the official Modeling MCP launcher |
+| Put plugin MCP config in `.claude/settings.json` first | Plugin-first flow uses `.mcp.json` | Prefer `.mcp.json` at the plugin root |
+| Block non-Windows users entirely | Remote/Fabric MCPs still work | Continue with `powerbi-remote` and `fabric-mcp-server` |
+
+---
+
+## Complexity Adaptation
+
+Adjust depth based on `config.json → experienceLevel`:
+- **beginner**: Step-by-step with explanations, reference library examples
+- **intermediate**: Standard depth, explain non-obvious decisions
+- **advanced**: Concise, skip basics, focus on edge cases and optimization
+
+---
+
+## Related Skills
+
+- `/dax` — Write DAX measures via MCP connection
+- `/model-documenter` — Document the connected model
+- `/fabric-scripts` — Fabric automation via MCP
+
+---
+
+## RELATED RESOURCES
+
+- [Power BI MCP overview](https://learn.microsoft.com/en-us/power-bi/developer/mcp/mcp-servers-overview)
+- [Remote Power BI MCP quickstart](https://learn.microsoft.com/en-us/power-bi/developer/mcp/remote-mcp-server-get-started)
+- [Power BI Modeling MCP](https://github.com/microsoft/powerbi-modeling-mcp)
+- [Microsoft Fabric MCP Server](https://github.com/microsoft/mcp/tree/main/servers/Fabric.Mcp.Server)