# ContextQA ## ContextQA Tutorial - [ContextQA Documentation](https://learning.contextqa.com/readme.md): ContextQA documentation — complete reference for AI-powered test automation, the MCP server, integrations, and platform administration. - [Browse by Role](https://learning.contextqa.com/documentation-by-role/by-role.md): Find the ContextQA documentation that's most relevant to your role — whether you're a tester, developer, QA manager, or technology leader. - [For Testers](https://learning.contextqa.com/documentation-by-role/by-role/for-testers.md): Stop writing brittle selectors. Write plain-English test steps, let AI handle execution, and spend your time on exploratory testing instead of script maintenance. - [For SDETs](https://learning.contextqa.com/documentation-by-role/by-role/for-sdets.md): Extend your automation framework with 67 MCP tools, export tests as Playwright code, manage test infrastructure via API, and let AI handle the maintenance burden so you focus on architecture. - [For QA Managers](https://learning.contextqa.com/documentation-by-role/by-role/for-qa-managers.md): Get full visibility into test coverage, release readiness, and team productivity. Manage test plans across products, track flaky test trends, and demonstrate QA's impact with concrete metrics. - [For Developers](https://learning.contextqa.com/documentation-by-role/by-role/for-developers.md): Generate tests from your Jira tickets, trigger test runs from your IDE via MCP, get AI root cause analysis in your terminal, and never break production again. - [For Product Managers](https://learning.contextqa.com/documentation-by-role/by-role/for-product-managers.md): Turn your Jira tickets into automated test cases, get release readiness reports you can trust, and ensure every feature ships with test coverage before it reaches users. - [For Engineering Managers](https://learning.contextqa.com/documentation-by-role/by-role/for-engineering-managers.md): Ship faster with quality gates that don't slow you down. Get team-level test coverage metrics, reduce MTTD, and give your engineers AI testing infrastructure that scales with your product. - [For VPs & CTOs](https://learning.contextqa.com/documentation-by-role/by-role/for-vp-engineering.md): The business case for AI-powered test automation. Reduce engineering toil, accelerate release cadence, and build a quality-at-speed culture without growing your QA headcount. - [Introduction to ContextQA](https://learning.contextqa.com/getting-started/introduction.md): An overview of ContextQA, an AI-powered test automation platform that lets teams create, run, and maintain web, mobile, and API tests using natural language. - [Quickstart Guide](https://learning.contextqa.com/getting-started/quickstart.md): A step-by-step guide to signing in, creating a test case with AI assistance, running it, and reviewing the results in under five minutes. - [Tutorial: CI/CD with GitHub Actions](https://learning.contextqa.com/getting-started/ci-cd-tutorial.md): Set up automated test execution in your GitHub Actions pipeline — organize tests into a suite and plan, configure GitHub secrets, add the workflow file, and verify your first automated run. - [Interactive Demo](https://learning.contextqa.com/getting-started/interactive-demo.md): Step through real ContextQA workflows — every screenshot captured live by the AI agent, every action logged. - [Core Concepts](https://learning.contextqa.com/getting-started/core-concepts.md): A practical explanation of every major building block in ContextQA, from workspaces and test cases to environments, self-healing, and the MCP server. - [Platform Architecture](https://learning.contextqa.com/getting-started/architecture-overview.md): A detailed explanation of ContextQA's 9-stage AI execution pipeline, its 13+ specialized agents, infrastructure components, and the MCP server that connects the platform to external AI assistants. - [Web Testing Overview](https://learning.contextqa.com/web-testing/web-testing.md): Complete guide to creating, managing, and executing web application tests in ContextQA — from recording your first test to running full regression suites. - [Creating Test Cases](https://learning.contextqa.com/web-testing/creating-test-cases.md): Create web test cases in minutes using ContextQA's unified creation panel — AI-assisted generation, file import, browser recording, or manual authoring. - [Requirements Management](https://learning.contextqa.com/web-testing/requirements-management.md): Upload requirement documents to ContextQA and let AI generate test cases, analyze coverage gaps, and track change history — all from a single Requirements Library. - [Test Steps Editor](https://learning.contextqa.com/web-testing/test-steps-editor.md): A comprehensive reference for the ContextQA step editor, covering all step types, field options, variable syntax, AI verification steps, and conditional and loop logic. - [Debugging Test Cases](https://learning.contextqa.com/web-testing/debugging-test-cases.md): Debug test cases interactively with breakpoints, live variable inspection, step-by-step execution, and real-time browser or device viewing. - [Uploaded Test Files](https://learning.contextqa.com/web-testing/uploaded-test-files.md): View, manage, and analyze imported requirement files — browse generated test cases, review AI analysis, identify coverage gaps, and inspect file metadata. - [Imported Files](https://learning.contextqa.com/web-testing/imported-files.md): View and manage test cases generated from imported files, review AI analysis results, and track import history. - [Version History](https://learning.contextqa.com/web-testing/version-history.md): Track, compare, and restore previous versions of your test cases with ContextQA's built-in version history. - [Requirements Library](https://learning.contextqa.com/web-testing/requirements-library.md): Upload requirements documents, review AI-generated test cases, analyze coverage gaps, and manage your requirements library in ContextQA. - [Database Steps](https://learning.contextqa.com/web-testing/database-steps.md): How to add database verification steps to your test cases — run SQL queries, store results in variables, and assert expected values. - [Custom Code Steps](https://learning.contextqa.com/web-testing/custom-code-steps.md): How to write and execute custom JavaScript code as test steps — for complex logic, calculations, and DOM interactions that go beyond natural language steps. - [Document Generation Steps](https://learning.contextqa.com/web-testing/document-generation-steps.md): How to generate TXT and CSV files during test execution — for testing file upload workflows, data exports, and document-dependent features. - [Managing Test Suites](https://learning.contextqa.com/web-testing/managing-test-suites.md): How to create, organize, and maintain test suites in ContextQA, including nested suites, adding and reordering test cases, and converting test cases to step groups. - [Test Plans](https://learning.contextqa.com/web-testing/test-plans.md): How to create, configure, and manage test plans in ContextQA — grouping suites into executable plans with scheduling, CI/CD integration, and recovery settings. - [Test Data Management](https://learning.contextqa.com/web-testing/test-data-management.md): How to manage local variables, global variables, test data profiles, environment parameters, and API response variables in ContextQA for data-driven and parameterized testing. - [Environment Data Management](https://learning.contextqa.com/web-testing/environment-data-management.md): How to manage environments, environment variables, database connections, test data profiles, and global variables from the consolidated Environment Data Management workspace in ContextQA. - [Tutorial: Data-Driven Testing](https://learning.contextqa.com/web-testing/data-driven-testing-tutorial.md): Build a parameterized login test that runs automatically with multiple user roles — one test case, one data profile, four executions, zero duplication. - [Tutorial: Step Groups](https://learning.contextqa.com/web-testing/step-groups-tutorial.md): Build a reusable login step group, insert it into multiple test cases, pass variables to it, and update it once to fix every test that uses it. - [AI Self-Healing](https://learning.contextqa.com/web-testing/self-healing.md): How ContextQA's self-healing AI detects broken test steps caused by UI changes and automatically repairs them, including how to view healed steps, configure thresholds, and approve suggested healings - [Interactive Demo](https://learning.contextqa.com/web-testing/self-healing-demo.md): See how ContextQA's AI Self-Healing detects broken locators when the UI changes and repairs test steps automatically — without any engineer intervention. - [Mobile Testing Overview](https://learning.contextqa.com/mobile-testing/mobile-testing.md): End-to-end automated testing for iOS and Android apps on ContextQA's real device farm — no emulators, no local device lab required. - [Prerequisites](https://learning.contextqa.com/mobile-testing/prerequisites.md): What you need before running your first mobile test in ContextQA — app files, iOS signing, and device farm access. - [Uploading Apps (APK & IPA)](https://learning.contextqa.com/mobile-testing/uploading-apps.md): How to upload Android APK and iOS IPA files to ContextQA, manage app versions, and reference uploaded builds in test cases and test plans. - [Creating Mobile Tests](https://learning.contextqa.com/mobile-testing/creating-mobile-tests.md): How to create, configure, and execute automated test cases for iOS and Android apps in ContextQA — including AI generation, gesture support, and run history review. - [Tutorial: Your First Mobile Test](https://learning.contextqa.com/mobile-testing/mobile-testing-tutorial.md): Upload an Android APK, generate a test case from a plain-English prompt, execute it on a real device, and review the results — all in under ten minutes. - [Mobile Test Plans](https://learning.contextqa.com/mobile-testing/mobile-test-plans.md): How to organize mobile test cases into suites, build multi-device test plans, configure parallel execution with mobile concurrency, and schedule automated runs. - [API Testing Overview](https://learning.contextqa.com/api-testing/api-testing.md): Overview of REST API testing in ContextQA — request configuration, response validation, API chaining, and hybrid test flows. - [Creating API Tests](https://learning.contextqa.com/api-testing/creating-api-tests.md): Step-by-step guide to creating API test cases in ContextQA — configuring requests, using variables, capturing responses, chaining calls, and importing from Swagger. - [Validating Responses](https://learning.contextqa.com/api-testing/validating-responses.md): Response validation techniques in ContextQA — payload validation, structure validation, status codes, and header assertions. - [API Chaining](https://learning.contextqa.com/api-testing/api-chaining.md): Connect multiple API calls in a single test case by extracting response fields into variables and passing them to subsequent steps — including hybrid API and UI flows. - [Tutorial: Your First API Test](https://learning.contextqa.com/api-testing/api-testing-tutorial.md): Build a two-step API test that authenticates against a REST endpoint, captures the access token, chains it into a second request, and validates the response — all without writing code. - [Mock API Testing](https://learning.contextqa.com/api-testing/mock-api-testing.md): Capture real API responses during test execution and replay them as mocks on future runs for faster, more stable tests. - [Salesforce Testing Overview](https://learning.contextqa.com/salesforce-testing/salesforce-testing.md): Overview of Salesforce testing in ContextQA — why Salesforce requires a different automation approach, what ContextQA handles automatically, and how to get started. - [Test Generation & Execution](https://learning.contextqa.com/salesforce-testing/test-generation-and-execution.md): Recording Salesforce test cases in ContextQA, managing test data with profiles and parameters, and running tests in parallel with execution logs. - [Execution Overview](https://learning.contextqa.com/execution/execution.md): Run, schedule, and monitor test executions across browsers and environments — with parallel runs, video evidence, and full execution traceability. - [Running Tests](https://learning.contextqa.com/execution/running-tests.md): How to execute individual test cases, test suites, and test plans in ContextQA, including live execution monitoring, parallel execution, and programmatic triggering via the MCP server. - [Debugging Tests](https://learning.contextqa.com/execution/debugging-tests.md): Use the interactive debugger to step through test cases, set breakpoints, inspect live variables, capture video, review AI agent steps, and modify steps mid-session in ContextQA. - [Parallel Execution](https://learning.contextqa.com/execution/parallel-execution.md): Parallel test execution in ContextQA lets multiple test cases run simultaneously, cutting total plan duration and surfacing failures faster. - [Environments](https://learning.contextqa.com/execution/environments.md): How to create and manage environment configurations in ContextQA, including base URLs, encrypted parameters, variable usage in test steps, and environment selection at execution time. - [Scheduling](https://learning.contextqa.com/execution/scheduling.md): How to create, configure, and manage recurring test schedules in ContextQA using frequency options, and how scheduled results surface through email and Slack notifications. - [Tutorial: Build and Schedule a Regression Suite](https://learning.contextqa.com/execution/regression-suite-tutorial.md): Go from a handful of individual test cases to a continuously running regression suite — group tests into a suite, build a test plan, run it, and schedule it to run every night with Slack alerts on fai - [Video & Screenshots](https://learning.contextqa.com/execution/video-and-screenshots.md): Test execution video recording and screenshots in ContextQA — every run produces a complete evidence package including WebM video, HAR, and Playwright trace. - [Interactive Demo](https://learning.contextqa.com/execution/demo.md): Explore a live test execution run — step-by-step results, per-step screenshots, console logs, network traces, and AI root cause analysis, all captured automatically. - [Reporting Overview](https://learning.contextqa.com/reporting/reporting.md): An overview of the dashboards, reports, and analytics that ContextQA provides to help QA teams, developers, and engineering managers understand test health at every level. - [Test Results](https://learning.contextqa.com/reporting/test-results.md): View step-by-step test results, video recordings, network logs, and AI root cause analysis for every ContextQA test execution. - [Analytics Dashboard](https://learning.contextqa.com/reporting/analytics-dashboard.md): A guide to the dashboards and analytics surfaces in ContextQA, including execution trends, coverage, AI insights, and risk-based testing. - [Failure Analysis](https://learning.contextqa.com/reporting/failure-analysis.md): How to use ContextQA's failure analysis, root cause, flaky test detection, and bug tracker integration features to diagnose and resolve test failures quickly. - [How to Debug a Failing Test](https://learning.contextqa.com/reporting/debugging-failing-tests.md): A step-by-step workflow for diagnosing why a test failed using ContextQA's execution evidence — AI root cause analysis, screenshots, video, network logs, console logs, and Playwright traces. - [Flaky Test Detection](https://learning.contextqa.com/reporting/flaky-test-detection.md): Flaky test detection in ContextQA — AI-powered failure classification identifies intermittent failures and separates them from real application bugs. - [Exporting Reports](https://learning.contextqa.com/reporting/exporting-reports.md): Test report export from ContextQA — share execution URLs, download evidence packages, export Playwright code, and embed results in Jira and Slack notifications. - [Interactive Demo](https://learning.contextqa.com/reporting/demo.md): Explore the ContextQA Reporting & Analytics dashboard — track pass rates, detect flaky tests, classify failures by root cause, and share results with stakeholders. - [AI Features Overview](https://learning.contextqa.com/ai-features/ai-features.md): Overview of ContextQA's AI capabilities — test generation, autonomous execution, self-healing, knowledge base, custom agents, and context graph. - [AI Assistant](https://learning.contextqa.com/ai-features/ai-assistant.md): Use the AI Assistant to navigate the ContextQA platform, generate test cases from natural language descriptions, and get contextual help during test execution. - [AI Test Generation](https://learning.contextqa.com/ai-features/ai-test-generation.md): Generate test cases automatically from Jira tickets, Figma designs, Swagger specs, videos, or natural language using ContextQA's AI-powered test generation. - [Tutorial: Generate Tests from Requirements](https://learning.contextqa.com/ai-features/generate-tests-from-requirements-tutorial.md): Turn a requirements document into a full test suite. Upload a specification, answer the AI's clarifying questions, review the generated test cases with traceability back to each requirement, and run t - [Requirements Coverage Gaps](https://learning.contextqa.com/ai-features/requirements-coverage-gaps.md): How to review AI-identified coverage gaps in your uploaded requirements, inspect gap details with similarity scores, and accept or dismiss AI-suggested test cases. - [Autonomous Agent Pipeline](https://learning.contextqa.com/ai-features/autonomous-agent-pipeline.md): How ContextQA's autonomous AI agent pipeline executes tests across nine stages — navigate, discover, plan, execute, capture, assert, heal, report, and archive. - [Knowledge Base](https://learning.contextqa.com/ai-features/knowledge-base.md): How to create and use Knowledge Base entries to teach ContextQA's AI agent how to handle application-specific UI patterns, consent banners, popups, and test-specific instructions. - [Tutorial: Configure a Knowledge Base](https://learning.contextqa.com/ai-features/knowledge-base-tutorial.md): A step-by-step tutorial for creating Knowledge Base entries that teach ContextQA's AI how to handle cookie banners, chat widgets, and other application-specific patterns — then verifying the AI follow - [Custom Agents](https://learning.contextqa.com/ai-features/custom-agents.md): How to create custom AI agent personas in ContextQA to calibrate test execution behavior for specialized application domains such as Salesforce, accessibility testing, or localization. - [AI Context Graph](https://learning.contextqa.com/ai-features/context-graph.md): ContextQA AI context graph — how ContextQA builds and applies accumulated application knowledge through UI Elements, Knowledge Bases, Custom Agents, and AI Data Analyst. - [Interactive Demo](https://learning.contextqa.com/ai-features/demo.md): See how ContextQA generates complete, executable test cases from a URL and plain-English description in under 30 seconds — no code required. - [Integrations Overview](https://learning.contextqa.com/integrations/integrations.md): A guide to all the systems ContextQA connects with, including bug trackers, CI/CD pipelines, project management tools, and notification systems. - [Jira](https://learning.contextqa.com/integrations/jira.md): Connect ContextQA to Jira to generate test cases from tickets, report defects with AI root cause analysis, and sync test execution status bidirectionally. - [Azure DevOps](https://learning.contextqa.com/integrations/azure-devops.md): How to connect ContextQA with Azure Boards to create work items from test failures and track bugs with full reproduction context. - [GitHub Actions](https://learning.contextqa.com/integrations/github-actions.md): Run ContextQA AI test automation in your GitHub Actions CI/CD pipeline. Trigger tests on every pull request, report results, and block merges on failure. - [Jenkins](https://learning.contextqa.com/integrations/jenkins.md): Jenkins ContextQA integration — trigger test plans from a Jenkinsfile, poll for results, and fail builds automatically when tests fail. - [GitLab CI](https://learning.contextqa.com/integrations/gitlab-ci.md): GitLab CI ContextQA integration — trigger test plans from .gitlab-ci.yml, poll for results, and fail pipeline stages automatically when tests fail. - [CircleCI](https://learning.contextqa.com/integrations/circleci.md): CircleCI ContextQA integration — trigger test plans from a CircleCI config.yml, poll for results, and fail workflows automatically when tests fail. - [Slack](https://learning.contextqa.com/integrations/slack.md): How to configure Slack webhooks in ContextQA so your team receives test run summaries and critical failure alerts in the right channels. - [Webhooks](https://learning.contextqa.com/integrations/webhooks.md): ContextQA webhook notifications — send test plan results to any HTTP endpoint on completion, enabling integrations with PagerDuty, custom dashboards, and internal tools. - [MCP Server Overview](https://learning.contextqa.com/mcp-server/overview.md): Connect any MCP-compatible AI agent to ContextQA's 67 tools for test creation, execution, failure analysis, and self-healing — all through natural language. - [Installation & Setup](https://learning.contextqa.com/mcp-server/installation-and-setup.md): Connect the ContextQA MCP Server to AI assistants like Claude, Claude Code, Cursor, ChatGPT, and Codex using OAuth 2.0. - [Authentication](https://learning.contextqa.com/mcp-server/authentication.md): How the ContextQA MCP Server authenticates AI clients with OAuth 2.0 — the sign-in flow, sessions, multiple accounts, and troubleshooting. - [Tutorial: Your First Test with an AI Agent](https://learning.contextqa.com/mcp-server/first-test-tutorial.md): Connect an AI assistant such as Claude Code or Cursor to the ContextQA MCP server, then create, run, and review your first test using natural-language prompts — no test code and no manual API calls. - [Agent Integration Guide](https://learning.contextqa.com/mcp-server/agent-integration-guide.md): Integrate AI agents with ContextQA MCP tools — tool call ordering, async execution, debugging, and multi-step workflow orchestration. - [Interactive Demo](https://learning.contextqa.com/mcp-server/demo.md): See how Claude and other AI agents use ContextQA's MCP tools to create tests, run them, and analyze failures — all from a natural language conversation. - [Tool Reference](https://learning.contextqa.com/mcp-server/tool-reference.md): Complete index of all 67 ContextQA MCP tools — test case management, execution, suites, infrastructure, AI test generation, and telemetry. - [Test Case Management](https://learning.contextqa.com/mcp-server/tool-reference/test-case-management.md): Complete reference for the 8 MCP tools that create, read, update, delete, and query test cases in ContextQA. - [Execution & Results](https://learning.contextqa.com/mcp-server/tool-reference/execution-and-results.md): Complete reference for MCP tools that trigger test runs, poll for completion, and retrieve results including screenshots and step details. - [Test Suites & Plans](https://learning.contextqa.com/mcp-server/tool-reference/suites-and-plans.md): MCP tool reference for managing and executing test suites and test plans in ContextQA. - [Infrastructure & Data](https://learning.contextqa.com/mcp-server/tool-reference/infrastructure-and-data.md): MCP tool reference for managing environments, devices, UI elements, and test data profiles in ContextQA. - [Test Generation](https://learning.contextqa.com/mcp-server/tool-reference/test-generation.md): Complete reference for the 10 MCP tools that generate test cases from code changes, tickets, designs, specs, videos, and natural language requirements. - [Bug, Defect & Advanced Testing](https://learning.contextqa.com/mcp-server/tool-reference/bug-defect-and-advanced.md): MCP tool reference for defect management, performance and security testing, code export, and AI-powered impact analysis in ContextQA. - [Telemetry & Custom Agents](https://learning.contextqa.com/mcp-server/tool-reference/telemetry-and-agents.md): MCP tool reference for execution telemetry, AI reasoning inspection, custom agent personas, and knowledge bases in ContextQA. - [Support-to-Fix & Migration](https://learning.contextqa.com/mcp-server/tool-reference/support-and-migration.md): MCP tool reference for ticket-driven bug reproduction, failure investigation, analytics coverage gap analysis, and test suite migration in ContextQA. - [Administration Overview](https://learning.contextqa.com/administration/administration.md): Guide to managing users, roles, workspace settings, SSO configuration, storage, backups, and audit logs in ContextQA. - [Roles & Permissions](https://learning.contextqa.com/administration/roles-and-permissions.md): Configure role-based access control in ContextQA — built-in roles, custom roles, permissions, and team member assignment. - [Team Management](https://learning.contextqa.com/administration/team-management.md): Manage workspaces, invite team members, and configure workspace settings in ContextQA for organized test automation across teams. - [SSO & Authentication](https://learning.contextqa.com/administration/sso-and-authentication.md): SSO single sign-on ContextQA configuration — set up SAML SSO with Okta, Azure AD, or Google Workspace, and manage authentication for the entire organization. - [Glossary](https://learning.contextqa.com/reference/glossary.md): A-Z glossary of ContextQA terms — definitions for test automation concepts, platform features, UI labels, and MCP server API terminology. - [Keyboard Shortcuts](https://learning.contextqa.com/reference/keyboard-shortcuts.md): ContextQA keyboard shortcuts for the portal — browser shortcuts, editor actions, and accessibility guidance for navigating the test automation platform efficiently. - [Changelog](https://learning.contextqa.com/reference/changelog.md): Changelog for ContextQA documentation — tracks additions, updates, platform release notes, and MCP server version history. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://learning.contextqa.com/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.