ThinkAloud MCP-server

Kør ThinkAloud-tests og fokusgrupper direkte fra Claude Desktop, Claude Code eller ethvert andet MCP-klient-værktøj. Serveren er et tyndt lag over REST-API'et (se docs/API.md) — al validering, guardrails og credit-træk sker server-side.

Forudsætning: API-nøgle (Bureau-plan)

Opret en nøgle på https://thinkaloud.activero.net/app/profile → "API keys" (kræver Bureau-plan). Nøglen (ta_...) vises kun én gang. Kørsler startet via MCP tilskrives kontoen og trækker credits præcis som i appen.

Opsætning

Byg én gang:

cd mcp && npm install && npm run build

Claude Code:

claude mcp add thinkaloud -e THINKALOUD_API_KEY=ta_DIN_NOEGLE -- node C:/sti/til/ThinkAloud/mcp/dist/index.js

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "thinkaloud": {
      "command": "node",
      "args": ["C:/sti/til/ThinkAloud/mcp/dist/index.js"],
      "env": { "THINKALOUD_API_KEY": "ta_DIN_NOEGLE" }
    }
  }
}

Env-variabler: THINKALOUD_API_KEY (anbefalet) eller THINKALOUD_ACCESS_CODE (pilot/integration, uden konto-kontekst); THINKALOUD_BASE_URL (default https://thinkaloud.activero.net).

Værktøjer

| Værktøj | Gør | Koster | |---|---|---| | thinkaloud_start_test | Start test af en URL (thinkaloud/e2e) → run_id | ~100-250 cr | | thinkaloud_test_status | Poll status + fremdrift + rapport-links | — | | thinkaloud_test_results | Maskinlæsbare fund + HTML/PDF-rapport-links | — | | thinkaloud_list_tests | Kontoens tidligere kørsler | — | | thinkaloud_focus_group | Fokusgruppe på navne/tekster/idéer (synkron, 1-3 min) | ~25 cr | | thinkaloud_suggest_personas | Foranalyse: foreslå personaer ud fra siden | gratis (kvote) | | thinkaloud_account | Konto + credit-saldo | — |

Typisk flow: suggest_personas → start_test → poll test_status → test_results.

Gatede sider (login/staging): thinkaloud_start_test tager valgfrit auth (HTTP Basic), headers (fx en API-nøgle der gater sitet) og storage_state (log selv ind og indsæt den eksporterede session — SSO/2FA uden password-deling). Kun testkonti — personaerne klikker rigtigt rundt. Secrets rammer aldrig disk/rapport (ephemere env-variabler server-side).