Troubleshooting

BoJ Server Troubleshooting

Quick Fixes

just doctor    # Diagnose all issues
just heal      # Auto-repair

Common Issues

Server won't start

lsof -i :3007       # Check port conflict
deno task start      # Retry

Cartridge not loading

Check the cartridge manifest and ensure all dependencies are available:

curl http://localhost:3007/api/cartridges | jq '.[] | select(.status != "loaded")'

Authentication errors

Ensure environment variables are set:

echo $GITHUB_TOKEN     # Should not be empty
echo $GITLAB_TOKEN

MCP connection issues

From Claude Code, check the MCP configuration in settings. BoJ should be listed as an MCP server pointing to http://localhost:3007.

Getting Help

just help-me    # Opens feedback channel

Or: https://github.com/hyperpolymath/boj-server/issues/new