13 Troubleshooting

14 Common Issues

14.1 MCP Servers Not Loading

14.1.1 Symptom: Hammer Icon Missing

The 🔨 icon doesn’t appear in Claude Desktop.

Checklist

JSON syntax error — Validate at jsonlint.com
Claude not fully restarted — Quit from system tray, not just close window
Wrong file location — Must be in %APPDATA%\Claude\
File permissions — Run as administrator if needed

14.1.2 How to Check Logs

Press Win + R
Type: %APPDATA%\Claude\logs
Open the most recent .log file
Look for error messages related to MCP servers

14.2 Power BI Connection Issues

14.2.1 Symptom: Cannot Connect to Model

Common Causes

Not signed in to Power BI in your browser
No access to the workspace
Wrong URL encoding — spaces must be %20
VPN/Firewall blocking connection

14.2.2 Fix: URL Encoding

If your workspace is called “Robert Prizelius”, the URL must be:

powerbi://api.powerbi.com/v1.0/myorg/Robert%20Prizelius

Not:

powerbi://api.powerbi.com/v1.0/myorg/Robert Prizelius  ❌

14.3 JSON Syntax Errors

14.3.1 Common Mistakes

Error	Problem	Fix
Unexpected token	Missing comma	Add comma after each item (except last)
Unexpected end	Missing brace	Count `{` and `}` — must match
Invalid character	Wrong quotes	Use `"` not `"` or `"`
Path not found	Single backslash	Use `\\` or `/` in paths

14.3.2 Correct Example

{
  "mcpServers": {
    "server1": {
      "command": "C:\\path\\to\\file.exe",
      "args": [],
      "env": {}
    },
    "server2": {
      "command": "C:\\another\\path.exe",
      "args": [],
      "env": {}
    }
  }
}

14.4 Getting Help

Contact Support

Querex
🌐 www.querex.no