Apparatus / Setup & reference

Troubleshoot Pilot

I cannot find the extension download

Use the official Pilot or Pilot Stealth Chrome Web Store listing. Check the GhostStack name and developer before installing. If Chrome cannot install it, record the store error and your Chrome version; do not substitute an unrelated extension with a similar name.

The client connects but no browser appears

Check the Pilot popup. Pair the browser with the same account used for the MCP client and keep Chrome open. Enable the session grant. If the connection is revoked or expired, pair again. With two connected browsers already, disconnect one before adding another.

I see an authorization error

Confirm that you are connecting to /mcp/pilot, that Identity login completed and that your account has Apparatus access. Check service availability for the access requirements of other services. Do not reuse a token issued for a different service or work around a denied authorization.

A domain or tab is refused

allowlist_refused means the domain or permission level is not allowed. Review a request in the extension before granting access. foreign_tab means the tab does not belong to the caller’s agent group. Use the agent window or the explicit adopt path rather than guessing a tab ID.

A redirect can change domains. Review the final destination instead of broadening the allowlist automatically.

Pilot asks me to choose a browser

browser_ambiguous means more than one browser is available and no target was chosen. List browsers, then specify the intended one or set a default. Approvals must be completed on that browser.

I hit a rate or operation limit

Allow the rolling minute to clear after the 30-call limit. Wait for an active operation to finish or reach a terminal cancellation state before starting another when two are already active. Adding another client or workspace does not reset account-wide limits.

A write timed out

Do not replay the action blindly. Inspect the page and check the operation status. A dispatched submission is not evidence that the website accepted it, and a timeout is not evidence that nothing happened.

Ask for help

Send the service name, client version, extension version, error code and the step that failed to hello@ghoststack.app. Do not send passwords, authorization tokens, session cookies or private page content.