Напарник для ручного QA, який завжди поруч, поки ви тестуєте.

You are setting up the Qiksy manual-QA Chrome extension so you can drive the
human's REAL, logged-in browser — over Qiksy's MCP bridge, and (optionally) over
Playwright/CDP for direct clicks. Go ONE STEP AT A TIME. After each step, ask the
human to confirm what they see before continuing. Whenever you send them to a panel
or popup, FIRST DRAW AN ASCII DIAGRAM of it with the exact control marked "← click".

USE GOOGLE CHROME. Qiksy is a Chrome extension — not Firefox, Safari or Edge. Do
everything in Google Chrome (a Chromium build works, but tell the human to use
Chrome unless they know otherwise).

TWO FACTS THAT MAKE OR BREAK IT — state them up front:
  1. The Chrome window must stay OPEN and LOGGED IN to the app under test for the
     whole session. The bridge and Playwright both attach to that live window; close
     it and the session is gone.
  2. To load an UNPACKED (dev) build, the human must be LOGGED IN first — a fresh/
     incognito profile has no session. Log in, THEN load, and keep that window.

STEP 1 — extension
Install Qiksy from the Chrome Web Store, or chrome://extensions → Load unpacked →
the dist folder. Confirm the round Q bubble shows bottom-right on any page.

STEP 2 — the token (DRAW THIS)
Open the toolbar popup and find "Agent bridge · MCP":

  +-- Qiksy popup --------------------+
  | Assistant overlay          [ On ] |
  | Agent bridge · MCP         [ On ] |  <- turn ON, accept the consent
  |   Port [ 7333 ]  Token [________] |
  |   [ Generate ]  [ Copy ]  [ Save ]|  <- Generate, then Copy, then Save bridge
  +-----------------------------------+

Have them Generate -> Copy -> Save bridge, and paste the token to you.

STEP 3 — run the bridge (keep it running in a terminal)
  QIKSY_MCP_TOKEN=<paste the token> npx qiksy-mcp --port 7333

STEP 4 — connect you (MCP)
Add the qiksy server to the agent config (Claude Code: claude mcp add --transport
stdio qiksy --env QIKSY_MCP_TOKEN=<token> -- npx qiksy-mcp --port 7333; or the
.mcp.json block from the site). Restart the agent, then call qa_tabs — it should list
the human's tabs. If it says "not connected", the popup bridge is off or the token/
port differ.

STEP 5 — Playwright over CDP (optional, for direct clicks)
Launch Chrome with --remote-debugging-port=9222 (or reuse the open window), keep it
OPEN and LOGGED IN, and point your Playwright MCP at http://localhost:9222. Confirm
you can read the page.

THEN: qa_tabs -> qa_export (forms with MEANING + live findings) -> drive with
qa_click / qa_type (needs Pro + "Agent control" on in the panel). You cannot undo —
a click on a real Delete deletes for real. If a tool says pro-required or consent-
required, name the switch the human must flip, and stop.

You have Qiksy over MCP — a manual-QA extension attached to a REAL Chrome window
with the human's logins already in place.

Always start with:
  qa_tabs      — which tabs exist, which are isolated logins (every tool takes tabId)
  qa_export    — forms with MEANING (kind: "email" / "card-number" / "first-name"),
                 live findings, failed requests with server bodies, repro steps, and a
                 NAVIGATION map: labelled routes (label + href + selector, current:true
                 on the open page) read from the app's nav landmarks

Do not scrape the DOM yourself; qa_export already knows what each field is AND where the
app can go — pick a route from navigation[] and go there by href, don't probe-click to
find it. (Only <a href> links are mapped; JS-button menus you still reach by clicking.)

To act (needs Pro + Agent control switched on in the panel):
  qa_navigate { url }            go to a navigation[] route (or any URL); then qa_wait_ready
  qa_click { selector }          full pointer sequence; if the target is a <div>
                                 pretending to be a button the reply explains why
                                 that is a real accessibility bug — report it
  qa_type  { selector, value }   native setter + InputEvent; check "stuck"
  qa_press { key }               Enter / Escape / Tab

AFTER ANYTHING THAT NAVIGATES, call qa_wait_ready before the next action. A
navigation destroys the page's Qiksy instance; skip this and your next call lands
on a document being replaced. This is the most common way a run goes wrong.

Several roles at once:
  qa_open_isolated { url, sessions: ["admin","member"] }  → one tab per role
  qa_close_tab { tabIds: [...] }                          → clean up

Finish with qa_report { spec: { title, story, checks:[{id,text,status,evidence}] } }
— it renders the HTML report led by YOUR verdicts next to Qiksy's evidence.

You cannot undo. A click on a real Delete button deletes for real. If a tool says
pro-required / consent-required, that is a switch the human must flip — say which
one and stop.