Troubleshooting

Check the local server, route enablement, and rebuilt extension before deeper diagnosis.

Field guide · 08

The toolbar is unavailable

Confirm the page route is enabled, the extension has site permission, and the page was refreshed after loading a new extension build. Browser-extension content scripts cannot always update an already-open page without a reload.

The agent cannot see the Queue

Confirm the local server is running and the MCP client points to the expected loopback endpoint. Check the extension compatibility notice if server and extension builds come from different revisions.

A screenshot misses image pixels

Image capture can be affected by resource decoding, cross-origin rules, canvas restrictions, or unsupported source types. Preserve the Annotation and report the capture context; do not assume a retrieved crop contains every resource merely because metadata exists.