Troubleshooting

Most setup problems are environment problems. glass-mcp doctor checks everything glass needs and prints a remedy for each gap.

glass-mcp doctor          # per-check ✓/⚠/✗ with remedies; non-zero exit if blocked
glass-mcp doctor --deep   # also spawn + tear down the display to prove it starts
glass-mcp doctor --json   # machine-readable output

Your agent can run the same checks via the glass_doctor tool. To inspect configuration, run glass-mcp env for every GLASS_* variable (purpose, default, current value).

If something still misbehaves, open an issue on the glass repository.