# SmartestQA Docs > SmartestQA (Selenity Technology) is an AI-assisted, no-code test automation platform for web, Android, iOS and desktop apps, with API, database, mail and load-test steps in the same scenario. These docs explain every module: what it is for, how to use it step by step, how its numbers are calculated, what goes wrong and how to fix it. Each page is available as HTML and as Markdown (same URL, .md). Start with Quick Start; module pages follow the order of work: Discover → Analyze → Automate → Schedule → Report → Maintenance. ## Get started - **Quick Start** (whole section: https://docs.smartestqa.ai/en/quick-start-section.md) - [Quick Start](https://docs.smartestqa.ai/en/quick-start.md): Paths, the four steps, and what you need before you begin. - [Create your account](https://docs.smartestqa.ai/en/quick-start-account.md): Sign up with a corporate email, set your password from the email link and log in. - [Create a project](https://docs.smartestqa.ai/en/quick-start-project.md): Pick the right project type, know the defaults, and use the sample project. - [Connect your app](https://docs.smartestqa.ai/en/quick-start-connect.md): Install the browser extension, add a start page URL, and decide whether you need an agent. - [Run your first test](https://docs.smartestqa.ai/en/quick-start-first-test.md): Record a web test, dry run it, put it in a pipeline and read the report. - [Progress meters](https://docs.smartestqa.ai/en/quick-start-progress.md): How the setup guide and the Setup Roadmap measure progress, with the formulas. - [Troubleshooting](https://docs.smartestqa.ai/en/quick-start-troubleshooting.md): Messages new users see during sign-up, setup and the first run, with causes and fixes. - [FAQ](https://docs.smartestqa.ai/en/quick-start-faq.md): Common questions from customers and admins, and how SmartestQA compares. - [Core concepts](https://docs.smartestqa.ai/en/concepts.md): The mental model of SmartestQA in one page: what each building block is, how they connect, and where each one is explained. - [Video library](https://docs.smartestqa.ai/en/videos.md): Every training video in one place: one lesson per module and the short how-to videos. ## Use cases - **Use cases** (whole section: https://docs.smartestqa.ai/en/use-cases-section.md) - [Use cases](https://docs.smartestqa.ai/en/use-cases.md): One page per question a test team asks: the short answer, the steps, a video that shows it, and links to the detailed pages. - [How do I prove every requirement is tested?](https://docs.smartestqa.ai/en/use-case-coverage.md): Link test cases to sub-requirements in Analyze, run them in a pipeline, and read requirement coverage, the coverage funnel and the gaps in InSight › Test Health. - [How do I build, run and schedule a regression suite?](https://docs.smartestqa.ai/en/use-case-regression.md): Put your test cases in a pipeline in Schedule, run it once, give it a Period so it starts by itself, and read every run in Report. - [How do I find out why a test failed?](https://docs.smartestqa.ai/en/use-case-failed-test.md): Open the run in Report: the Summary names the first failed step of each test case, the step shows its log and screenshot, and AI Failure Analysis says whether it is a bug, a test problem or a flaky step. - [What happens to my tests when the UI changes?](https://docs.smartestqa.ai/en/use-case-self-healing.md): When a locator breaks, the runner finds the element again, checks that the step still did its job, saves the new locator and puts the repair in Maintain › Auto-heal for review. - [Can agents watch my test suite for me?](https://docs.smartestqa.ai/en/use-case-agents.md): Install an autonomous agent such as Daily triage or Coverage gap report, switch it on, and read each run's summary, report and proposals. An agent proposes; a person applies. - [How do I automate a web test without writing code?](https://docs.smartestqa.ai/en/use-case-no-code-web.md): Record the flow in your browser from Automate, add a check from the step toolbar, save and try it with Dry Run: no code is needed. - [How can an AI assistant write and run my tests?](https://docs.smartestqa.ai/en/use-case-ai-assistant-mcp.md): Connect Claude or another MCP client to the SmartestQA MCP server; the assistant plans, writes and dry-runs test cases in your project, and writes a change only after you approve its diff. - [How do I get test cases from a requirements document?](https://docs.smartestqa.ai/en/use-case-requirements-to-tests.md): Select a module folder in Analyze, attach the document on the Import tab and click Analyze with AI; you edit the outline, generate steps, check coverage and click Create. - [How does SmartestQA learn what my application looks like?](https://docs.smartestqa.ai/en/use-case-app-map.md): Discover Your App scans each page you visit into actions with locators and screenshots; the Action List holds them and the App Map describes the pages, their links and how well they are tested. - [How do I test a REST API without writing code?](https://docs.smartestqa.ai/en/use-case-api-testing.md): Save the requests in API Requests, add them to a test case as API steps, save values from the response under JSON Paths and check them with Assertion steps. - [How do I turn a UI test into API tests?](https://docs.smartestqa.ai/en/use-case-ui-to-api.md): Add a Network step in List mode to a web test case, run it in a pipeline, then click Make API test in Maintenance, Network Calls: the captured calls become API steps in a new test case. - [How do I get a load test from my functional tests?](https://docs.smartestqa.ai/en/use-case-load-test.md): Open a test case with API steps, let AI generate a JMeter plan or a k6 script from them, save it as a new test case, run it in a pipeline and read the load report. - [How do I check the database inside a UI test?](https://docs.smartestqa.ai/en/use-case-database-check.md): Create a database connection in Data Source, add a Database step with an SQL query to the test case, name its outputs and compare them in Assertion steps. - [How do I run the same test with many sets of data?](https://docs.smartestqa.ai/en/use-case-data-driven.md): Upload an Excel or CSV dataset, read its columns in the steps with {{excel:name}}_column, and set the pipeline's Loop mode to Loop: the test case then runs once per row. - [How do I test sign-up with a one-time code sent by e-mail?](https://docs.smartestqa.ai/en/use-case-email-otp.md): Connect a test mailbox under Integrations, add an Extract OTP mail step after the step that sends the code, and type the saved variable into the code field. - [How do I test a mobile app on real devices from my browser?](https://docs.smartestqa.ai/en/use-case-real-devices.md): Upload your build to the App Library, take an Available device in Device Farm › Devices, drive it live in the browser, and send dry runs and pipelines to the same devices. - [How do I record a mobile test without writing Appium code?](https://docs.smartestqa.ai/en/use-case-mobile-recording.md): Click Record Actions in a MOBILE project, tap the elements on the live screen of the device, and Save Steps: SmartestQA stores each tap as an action with its locators. - [How do I test a Windows or macOS desktop application?](https://docs.smartestqa.ai/en/use-case-desktop-app.md): Create a DESKTOP project, run the agent and Appium on the machine with the app, add the app in Desktop Configuration, record it with the Desktop Recorder and run it on that agent. - [How do I run tests on every deploy and see what changed?](https://docs.smartestqa.ai/en/use-case-ci-cd.md): Add two steps to your CI: one tells SmartestQA that a deploy happened, one starts a pipeline and fails the build on a red test. Deploys & Repos then shows each version, its commits and whether it was tested. - [How do failed tests become Jira issues?](https://docs.smartestqa.ai/en/use-case-jira-defects.md): Switch on Auto Task Creation in the pipeline so each failed test case becomes a task, and connect Jira in Integrations with Send Tasks to Jira so tasks become Jira issues and Jira changes flow back. - [How do I get test results in Slack, Teams or e-mail?](https://docs.smartestqa.ai/en/use-case-notifications.md): Paste a channel webhook into the Slack or Microsoft Teams page in Integrations and choose the events; for e-mail, switch on Email Notification in the pipeline and enter the recipients. - [How do I sync automated test results with Xray or Zephyr Scale?](https://docs.smartestqa.ai/en/use-case-test-management-sync.md): Connect Xray or Zephyr Scale in Integrations and sync the test cases first; Zephyr Scale then gets a test cycle with results after each pipeline, and Xray gets a Test Execution when an export is requested. - [How do I find and fix flaky tests?](https://docs.smartestqa.ai/en/use-case-flaky-tests.md): InSight › Execution lists the test cases whose result flips between pass and fail, with a score from 0 to 1; Report shows Passed on retry and a Flaky verdict per run, and you fix the cause with waits, stable locators or retries. - [How do I keep passwords and API keys out of my tests?](https://docs.smartestqa.ai/en/use-case-secrets.md): Store each password, token and API key as an encrypted key in Data Source › Variables and reference it in the step as {{ds:key}}; the value is stored encrypted and appears as •••••• in logs and reports. - [How do I control who can do what, and see who changed what?](https://docs.smartestqa.ai/en/use-case-access-audit.md): Give each person the Admin or User role and the projects they work on in Company Settings › Users, optionally from Active Directory groups, and read every change, sign-in and denied attempt in Configuration › Logs › Audit logs. ## Build tests - **Discover** (whole section: https://docs.smartestqa.ai/en/discover-section.md) - [Discover](https://docs.smartestqa.ai/en/discover.md): What Discover is for, its four tabs, what you need, and which capture method to use. - [Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.md): Scan a web app page by page: settings, the review window, page names and what each scan creates. - [Mobile & desktop](https://docs.smartestqa.ai/en/discover-mobile-desktop.md): Capture Android, iOS and desktop apps with the Appium inspector and the Desktop Recorder. - [Actions](https://docs.smartestqa.ai/en/discover-actions.md): Create and edit actions, find them in the Action List, and rename, copy or delete them safely. - [App Map](https://docs.smartestqa.ai/en/discover-app-map.md): Build the map with Update map, describe each page, and group pages into modules. - [Notes](https://docs.smartestqa.ai/en/discover-notes.md): Write the rules and facts the AI cannot see, and control which notes reach it. - [How the numbers work](https://docs.smartestqa.ai/en/discover-numbers.md): Formulas and worked examples for the locator chip, Cases, the roadmap percentage and App Map coverage. - [Troubleshooting](https://docs.smartestqa.ai/en/discover-troubleshooting.md): Every Discover message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/discover-faq.md): Questions and answers, AI assistant use and the module’s limits. - **Analyze** (whole section: https://docs.smartestqa.ai/en/analyze-section.md) - [Analyze](https://docs.smartestqa.ai/en/analyze.md): What Analyze is for, the requirement model, the screen, and how requirements turn into test cases in Automate. - [Folders, documents & archive](https://docs.smartestqa.ai/en/analyze-folders.md): Work with the requirement tree: module folders, the Documents folder, filters, moving, archiving and restoring. - [Write requirements](https://docs.smartestqa.ai/en/analyze-requirements.md): Create a main requirement by hand, add or generate sub-requirements, set status and severity, save, and comment. - [Generate from documents with AI](https://docs.smartestqa.ai/en/analyze-import.md): The three-step AI wizard: import a document, review the requirement and scenario outline, generate steps and create everything. - [Link test cases](https://docs.smartestqa.ai/en/analyze-test-cases.md): Link existing test cases to sub-requirements, generate new ones with AI, and see how links reach pipelines and coverage. - [AI assessment](https://docs.smartestqa.ai/en/analyze-assessment.md): Score a main requirement and all its sub-requirements with AI, read the result and use it to close gaps. - [How the numbers work](https://docs.smartestqa.ai/en/analyze-numbers.md): Formulas and worked examples for the Quality Score, Score Breakdown, wizard coverage, wizard counts, folder counts and requirement coverage elsewhere. - [Troubleshooting](https://docs.smartestqa.ai/en/analyze-troubleshooting.md): Every Analyze message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/analyze-faq.md): Questions and answers, AI assistant use through MCP and the module’s limits. - **Automate** (whole section: https://docs.smartestqa.ai/en/automate-section.md) - [Automate](https://docs.smartestqa.ai/en/automate.md): What Automate is for, its three panels, what you need per project type, and the ways to build a test case. - [Test cases and folders](https://docs.smartestqa.ai/en/automate-test-cases.md): Create test cases and templates, organise them in folders and modules, find them, and archive or restore them. - [Record and add steps](https://docs.smartestqa.ai/en/automate-add-steps.md): Record a flow in a web, mobile or desktop app, or add steps one by one from the toolbar, including templates. - [Edit steps and save](https://docs.smartestqa.ai/en/automate-editor.md): The editor screen, reordering and switching steps off, replacing and editing actions, Test Case Detail, and what Save checks. - [Variables and test data](https://docs.smartestqa.ai/en/automate-test-data.md): Write {{variables}}, pass values between steps, use data sources and datasets, and run one test case once per data row. - [Dry run and live log](https://docs.smartestqa.ai/en/automate-dry-run.md): Start a dry run on the server, your agent or a device, read the live log, and see how a dry run differs from a pipeline run. - [AI in Automate](https://docs.smartestqa.ai/en/automate-ai.md): Generate steps from a prompt, expand a case into negative and edge cases, generate test cases for a module, AI descriptions, AI steps and AI Analyze. - [How the numbers work](https://docs.smartestqa.ai/en/automate-numbers.md): Formulas and worked examples for the status icon, template badge, usage chip, folder summary, live-log progress and recent runs. - [Troubleshooting](https://docs.smartestqa.ai/en/automate-troubleshooting.md): Every Automate message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/automate-faq.md): Questions and answers, how AI assistants build test cases through MCP, and the module’s limits. - **Schedule** (whole section: https://docs.smartestqa.ai/en/schedule-section.md) - [Schedule](https://docs.smartestqa.ai/en/schedule.md): What a pipeline is, the four Schedule tabs, where runs execute, and the flow from your first pipeline to a nightly run. - [Build a pipeline](https://docs.smartestqa.ai/en/schedule-create.md): Create a pipeline, add test cases, requirements or other pipelines, set the run order and Setup/Before/After/Teardown phases, save, tag and delete. - [Schedule a pipeline](https://docs.smartestqa.ai/en/schedule-timing.md): Run a pipeline daily, weekly, monthly or on a cron expression between two dates, check the next run on Scheduled Runs, and pause a schedule. - [Where a pipeline runs](https://docs.smartestqa.ai/en/schedule-where.md): Run Environment (SmartestQA server, your agents, mobile device farms, desktop agents), the server queue, and the start page and DEV/TEST/PRP environment. - [Parameters & run settings](https://docs.smartestqa.ai/en/schedule-settings.md): Pipeline Parameters, Data & loop (repeat, dataset loop, data table), Test Management, AI Options, e-mail notifications and browser settings of a pipeline. - [Run, stop and follow](https://docs.smartestqa.ai/en/schedule-runs.md): Start a pipeline with Run or Save & Execute, stop a running pipeline, read Execution History, open its reports, and start it from a terminal or CI/CD. - [Triggers & queues](https://docs.smartestqa.ai/en/schedule-triggers-queues.md): Start pipelines from webhooks, e-mails and files, and process work items one pipeline run each, with retries, deferral and SLA. - [How the numbers work](https://docs.smartestqa.ai/en/schedule-numbers.md): Formulas and worked examples for the items badge, planned case runs, History Result, last run status, Disconnected, thread limits, queue messages and queue counts. - [Troubleshooting](https://docs.smartestqa.ai/en/schedule-troubleshooting.md): Every Schedule message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/schedule-faq.md): Questions and answers about pipelines, AI assistants and pipelines through MCP, and the module’s limits. - **Report** (whole section: https://docs.smartestqa.ai/en/report-section.md) - [Report](https://docs.smartestqa.ai/en/report.md): What Report shows, how a report is built from a pipeline run, what you need, and where to look first. - [Find a run](https://docs.smartestqa.ai/en/report-list.md): The Reports list: what each column means, how to search, filter and sort, open a report, follow and stop a running run. - [Run summary, export & share](https://docs.smartestqa.ai/en/report-summary.md): The report header and Summary tab: verdict, test cases, error logs and settings; manual runs; PDF export, email sharing and tags. - [Steps, screenshots & video](https://docs.smartestqa.ai/en/report-steps.md): A test case tab: runs and retries, the step table, the Log Detail dialog, screenshots, video, saved variables, network reports and device diagnostics. - [AI failure analysis](https://docs.smartestqa.ai/en/report-ai-analysis.md): AI verdicts on failed steps (Real Bug, Test / Infrastructure Issue, Flaky, Unclassified), the AI Analyze button, and the AI Report Feedback review of a whole run. - [Load test results](https://docs.smartestqa.ai/en/report-load-tests.md): How JMeter and k6 runs appear in Report: the load-run Summary, each step’s report, the comparison with the previous run, live results and JTL files. - [How the numbers work](https://docs.smartestqa.ai/en/report-numbers.md): Formulas and worked examples for the Result chip, Duration, run status, the 2-hour rule, verdicts, test case states, step chips, durations, AI confidence and load verdicts. - [Troubleshooting](https://docs.smartestqa.ai/en/report-troubleshooting.md): Every Report message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/report-faq.md): Questions and answers about reports, how AI assistants read reports through MCP, and the module’s limits. - **Maintenance** (whole section: https://docs.smartestqa.ai/en/maintenance-section.md) - [Maintenance](https://docs.smartestqa.ai/en/maintenance.md): What Maintain is for, its three tabs, who can use it, and where its review queues come from. - [Auto-heal reviews](https://docs.smartestqa.ai/en/maintenance-auto-heal.md): Read a repair card, open its details, approve or reject it, and know what each decision changes. - [How auto-heal decides](https://docs.smartestqa.ai/en/maintenance-how-healing-works.md): When the runner heals a step, how it finds and checks the element, what it saves, and the settings that control it. - [AI Steps](https://docs.smartestqa.ai/en/maintenance-ai-steps.md): Turn AI steps that passed into regular actions, so they run from a saved locator without an AI call. - [Network Calls](https://docs.smartestqa.ai/en/maintenance-network-calls.md): Turn the browser calls a Network step captured into a new API test case, one test case at a time. - [How the numbers work](https://docs.smartestqa.ai/en/maintenance-numbers.md): Formulas and worked examples for the status counts, the 1/3 runs bar, the AI score, the InSight banner and the AI Steps and Network counts. - [Troubleshooting](https://docs.smartestqa.ai/en/maintenance-troubleshooting.md): Every Maintain message and symptom, and every auto-heal run-log reason, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/maintenance-faq.md): Questions and answers about auto-heal and conversions, the smartest_heal MCP tool and the module’s limits. - **InSight** (whole section: https://docs.smartestqa.ai/en/insight-section.md) - [InSight](https://docs.smartestqa.ai/en/insight.md): The home dashboard: what its Execution and Test Health tabs show, where the numbers come from, and which tab to use for which question. - [Execution](https://docs.smartestqa.ai/en/insight-execution.md): The Execution tab: period, run environment, six summary cards, pipeline run strip, failure clusters, flaky and slow test cases, requirements, open tasks, weekly trend and downloads. - [Test Health](https://docs.smartestqa.ai/en/insight-test-health.md): The Test Health tab: four coverage pillars and maturity, Fix these first, funnels, modules, pipeline maturity, trust issues, gaps, traceability, stale tests, progress and saved reports. - [How the numbers work](https://docs.smartestqa.ai/en/insight-numbers.md): Formulas and worked examples for every InSight number: success rate, runs, flaky score, run time, time saved, clusters, p95, pillars, maturity, funnels, levels and the classic view. - [Troubleshooting](https://docs.smartestqa.ai/en/insight-troubleshooting.md): Every InSight message and surprising number, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/insight-faq.md): Questions and answers about InSight, how AI assistants use Test Health through MCP, and every list size and time window. ## Reference - **Step reference** (whole section: https://docs.smartestqa.ai/en/automate-steps-section.md) - [Step reference](https://docs.smartestqa.ai/en/automate-steps.md): Every step type you can add to a test case, grouped by family, with project types, where to add it and what stops a run. - [Browser actions](https://docs.smartestqa.ai/en/automate-steps-browser.md): The web action steps: Click, Double Click, Right Click, Hover, Type, Clear & Type, Select, Navigate, Get, Visibility Check and Wait. - [Checks and assertions](https://docs.smartestqa.ai/en/automate-steps-assertions.md): The Assertion step and its types, how values are compared, and which check to use when: Assertion, Visibility Check, AI Check, Network Check and the mobile and desktop Assert actions. - [Waits, conditions and templates](https://docs.smartestqa.ai/en/automate-steps-flow.md): Fixed and conditional waits, how long a step waits for its element, IF / ELIF / ELSE / END blocks, and template steps that reuse a whole sequence. - [Data and variables](https://docs.smartestqa.ai/en/automate-steps-variables.md): Pass values between steps: the Global parameter step, the Get step and its transforms, which steps produce variables, and the {{tc:}}, {{ds:}} and {{excel:}} reference syntax. - [Code steps: Python and JavaScript](https://docs.smartestqa.ai/en/automate-steps-code.md): Write Python or JavaScript in a step, return a value or a pass/fail result, insert ready commands, and build IF / ELSE blocks. - [AI steps](https://docs.smartestqa.ai/en/automate-steps-ai.md): Ask about the screen, check something visible, act in plain words, or chat with the AI as a step: the four AI modes, their fields and outputs. - [API Request step](https://docs.smartestqa.ai/en/automate-steps-api.md): Call an HTTP API inside a test case, try it with Send, save response values with JSON paths, and check the status code. - [Network step](https://docs.smartestqa.ai/en/automate-steps-network.md): Check, read or list the calls the browser makes during a web test: status codes, response fields, durations, JS errors. - [Database step](https://docs.smartestqa.ai/en/automate-steps-database.md): Run an SQL query against your database inside a test case and save column values as variables. - [Mail steps](https://docs.smartestqa.ai/en/automate-steps-mail.md): Read a one-time code or a link from an email, wait for a message, count messages, or send an email during a test. - [Kafka steps](https://docs.smartestqa.ai/en/automate-steps-kafka.md): Publish a message to a Kafka topic and wait for a matching message, to test event-driven flows inside a test case. - [Load test steps: JMeter and k6](https://docs.smartestqa.ai/en/automate-steps-load.md): Add a JMeter or k6 load test as a step: upload a .jmx or .js file, or generate one with AI from the API steps of a test case. - [Mobile actions](https://docs.smartestqa.ai/en/automate-steps-mobile.md): Every Android and iOS action step: touch and gestures, input, app lifecycle, navigation, reading values, waits and assertions, plus the ready-made Global actions. - [Desktop actions](https://docs.smartestqa.ai/en/automate-steps-desktop.md): Every Windows and macOS action step: mouse, input and keys, scrolling, waits, assertions, reading values, app and window control, plus Global desktop actions. - [Step troubleshooting](https://docs.smartestqa.ai/en/automate-steps-troubleshooting.md): Every step-level message and surprise, from element not found to mail timeouts, with why it happens, what to check and how to fix it. ## AI - **Autonomous Agents** (whole section: https://docs.smartestqa.ai/en/ai-agents-section.md) - [Autonomous Agents](https://docs.smartestqa.ai/en/ai-agents.md): What autonomous agents do, the agent catalog, how a run works and how you stay in control of every change. - [Install an agent](https://docs.smartestqa.ai/en/ai-agents-catalog.md): The fourteen ready-made agents, what each one needs, how to install one and how to start a custom agent. - [Agent settings](https://docs.smartestqa.ai/en/ai-agents-settings.md): Every tab of the agent settings dialog: instructions, tools, trigger and where it runs, report targets and limits. - [Runs and proposals](https://docs.smartestqa.ai/en/ai-agents-runs.md): Start a run, follow it, read its report and steps, and apply or dismiss what the agent proposed. - [How the numbers work](https://docs.smartestqa.ai/en/ai-agents-numbers.md): Formulas and worked examples for the four KPI cards, run cost, the limits, the budget meter, the run bars and the overdue warning. - [Troubleshooting](https://docs.smartestqa.ai/en/ai-agents-troubleshooting.md): Every Autonomous Agents message and symptom, with why it happens, what to check and how to fix it. - [FAQ & limits](https://docs.smartestqa.ai/en/ai-agents-faq.md): Questions and answers about autonomous agents, how agents relate to MCP, and the limits. - **MCP & AI assistants** (whole section: https://docs.smartestqa.ai/en/mcp-section.md) - [MCP & AI assistants](https://docs.smartestqa.ai/en/mcp.md): What the SmartestQA MCP server is, the ways to connect Claude and other assistants, what they can do and how changes stay safe. - [Connect an assistant](https://docs.smartestqa.ai/en/mcp-connect.md): Connect claude.ai, Claude Desktop, Claude Code, Cursor or another MCP client to SmartestQA, and handle the API key safely. - [Tools, prompts & commands](https://docs.smartestqa.ai/en/mcp-tools.md): The 18 SmartestQA MCP tools in plain language, the four ready-made prompts, the work keys, and the commands that buttons in the app copy for you. - [Safe changes](https://docs.smartestqa.ai/en/mcp-safe-changes.md): How an assistant changes SmartestQA records: a diff first, your approval, then the write; which actions need an Admin or a click; and what keeps passwords out of the chat. - [Example prompts](https://docs.smartestqa.ai/en/mcp-workflows.md): What to ask an assistant connected to SmartestQA, stage by stage: status, modules, requirements, scenarios, pipelines, red runs, heals, defects and integrations. - [Troubleshooting](https://docs.smartestqa.ai/en/mcp-troubleshooting.md): Every MCP connection, sign-in and tool message, with why it happens, what to check and how to fix it. - [FAQ & limits](https://docs.smartestqa.ai/en/mcp-faq.md): Questions and answers about connecting AI assistants to SmartestQA, privacy and access, and the MCP limits. ## Resources - **Data Source** (whole section: https://docs.smartestqa.ai/en/data-source-section.md) - [Data Source](https://docs.smartestqa.ai/en/data-source.md): What Data Source is for, its three tabs, who can do what, and how tests read keys, datasets and connections. - [Variables (keys)](https://docs.smartestqa.ai/en/data-source-variables.md): Create keys, choose where their value comes from, add environment variants, connect actions, and copy, move or delete safely. - [Datasets (Excel / CSV)](https://docs.smartestqa.ai/en/data-source-datasets.md): Upload or type a dataset, edit its rows, read its cells in steps, and let a pipeline run once per row. - [Connections (DB and Kafka)](https://docs.smartestqa.ai/en/data-source-connections.md): Create, test, edit and delete database (JDBC) and Kafka connections, and see which keys and tests use them. - [Use it in tests](https://docs.smartestqa.ai/en/data-source-in-tests.md): How steps reference keys and datasets, how DB and Kafka steps use connections, how a run resolves values, and where connections are opened from. - [Secrets and credentials](https://docs.smartestqa.ai/en/data-source-secrets.md): Where passwords and tokens belong, how to encrypt a key, who can see an encrypted value, and how runs keep secrets out of logs. - [How the numbers work](https://docs.smartestqa.ai/en/data-source-numbers.md): Formulas and worked examples for the tab counts, the summary cards, Kind, Used by, Size and the Database column. - [Troubleshooting](https://docs.smartestqa.ai/en/data-source-troubleshooting.md): Every Data Source message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/data-source-faq.md): Questions and answers about Data Source, how AI assistants use it through MCP, and its limits. - **API Requests** (whole section: https://docs.smartestqa.ai/en/api-requests-section.md) - [API Requests](https://docs.smartestqa.ai/en/api-requests.md): What the API library is for, its three panels, who can do what, and how saved requests become API steps. - [The API library](https://docs.smartestqa.ai/en/api-requests-library.md): Create requests, collections and folders, rename, duplicate, move and delete them, and import from Postman, Swagger / OpenAPI or curl. - [Edit and send](https://docs.smartestqa.ai/en/api-requests-editor.md): Method, URL, body, authorization, params and headers; what Save checks, what Send really sends, and how to read the response. - [Use requests in tests](https://docs.smartestqa.ai/en/api-requests-in-tests.md): Add a saved request as an API step, create one from curl, understand the step’s own copy, and what a run sends differently from Send. - [Troubleshooting](https://docs.smartestqa.ai/en/api-requests-troubleshooting.md): Every API Requests message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/api-requests-faq.md): Questions and answers about API Requests, AI assistants through MCP, and the limits. - **Agent Pool & Device Farm** (whole section: https://docs.smartestqa.ai/en/agent-pool-section.md) - [Agent Pool & Device Farm](https://docs.smartestqa.ai/en/agent-pool.md): Where tests run: test agents on your machines, the Smartest Server, and Device Farm nodes, devices, runs and apps. - [Test Agents](https://docs.smartestqa.ai/en/agent-pool-agents.md): The agent list, Online and Offline, shared agents, API keys, downloads, CLI install, live performance and the MCP tab. - [Local device setup](https://docs.smartestqa.ai/en/agent-pool-local-setup.md): Prepare your own computer for mobile and desktop tests: Android emulator, Appium, the Windows or Mac2 driver, and the Connected Devices check. - [Nodes, devices & runs](https://docs.smartestqa.ai/en/agent-pool-devices.md): Device Farm nodes and their health, device cards and filters, device details and controls, and the Recent runs list. - [Live device sessions](https://docs.smartestqa.ai/en/agent-pool-live-device.md): See and control a phone or emulator in the browser: local devices through your agent, farm devices with Take device. - [App Library](https://docs.smartestqa.ai/en/agent-pool-app-library.md): Upload your APK, AAB, IPA and simulator builds once, keep them up to date, and install them on Device Farm devices. - [How the numbers work](https://docs.smartestqa.ai/en/agent-pool-numbers.md): Formulas and worked examples for online rules, agent performance, device counts, run minutes, telemetry, App Library counts and live session timings. - [Troubleshooting](https://docs.smartestqa.ai/en/agent-pool-troubleshooting.md): Every Device Farm and Test Agents message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/agent-pool-faq.md): Questions and answers about agents and Device Farm, AI assistant use and the module’s limits. - **Deploys & Repos** (whole section: https://docs.smartestqa.ai/en/deployments-section.md) - [Deploys & Repos](https://docs.smartestqa.ai/en/deployments.md): What Deploys & Repos is for, its two tabs, what you need, and the typical flow from repository to tested deploy. - [Connect a repository](https://docs.smartestqa.ai/en/deployments-repos.md): Add, change and delete code repositories: provider, service name, token or notification only, test connection and environment mapping. - [Send deploys from CI](https://docs.smartestqa.ai/en/deployments-ci.md): The deploy token, the webhook URL and payload, ready-made CI steps, and what SmartestQA does with each notification. - [Versions, history and deploy detail](https://docs.smartestqa.ai/en/deployments-overview.md): Read the Currently running versions grid, filter the Deploy history and open a deploy to see its commits and the runs that tested it. - [How the numbers work](https://docs.smartestqa.ai/en/deployments-numbers.md): Formulas and worked examples for the KPI cards, the tested-after window, the cell states, the untested streak, commit counts and relative times. - [Troubleshooting](https://docs.smartestqa.ai/en/deployments-troubleshooting.md): Every Deploys & Repos message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/deployments-faq.md): Questions and answers, what AI assistants and agents can do with deploys, and the module’s limits. - **Tasks** (whole section: https://docs.smartestqa.ai/en/tasks-section.md) - [Tasks](https://docs.smartestqa.ai/en/tasks.md): What Tasks is for, the board and list views, where tasks come from, and the typical flow from a failed run to a closed task. - [Board, list and filters](https://docs.smartestqa.ai/en/tasks-board.md): Work with the Kanban board and the list: read cards, move tasks between statuses, filter and search, and delete tasks. - [Create and work on a task](https://docs.smartestqa.ai/en/tasks-detail.md): Create a task, fill its fields, add members, attachments and tags, and discuss it in Comments & Activity. - [Tasks from failed runs](https://docs.smartestqa.ai/en/tasks-from-runs.md): Automatic tasks when a pipeline run fails, the Task button in Report, Go to Report, Jira and Azure DevOps sync, and notifications. - [Statuses and Task Settings](https://docs.smartestqa.ai/en/tasks-statuses.md): The default statuses, adding your own in Task Settings or on the board, renaming, colours, order and deleting safely. - [How the numbers work](https://docs.smartestqa.ai/en/tasks-numbers.md): Formulas and worked examples for column counts, results found, card counts, task numbers and the Step Summary of automatic tasks. - [Troubleshooting](https://docs.smartestqa.ai/en/tasks-troubleshooting.md): Every Tasks message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/tasks-faq.md): Questions and answers, what AI assistants can do with tasks through MCP, and the module’s limits. ## Administration - **Project settings** (whole section: https://docs.smartestqa.ai/en/project-settings-section.md) - [Project settings](https://docs.smartestqa.ai/en/project-settings.md): What the Project Panel controls, who can open it, which sections each project type has, and how settings reach a run. - [Project, start pages & export](https://docs.smartestqa.ai/en/project-settings-project.md): Rename or delete a project, manage start page URLs and the default, and export the project as JSON, Selenium or Playwright. - [Test Management](https://docs.smartestqa.ai/en/project-settings-test-management.md): Every run setting of a project: engine, parallel threads, retries, browser, display, logging, video, timeouts and report emails, with defaults. - [AI Options](https://docs.smartestqa.ai/en/project-settings-ai.md): Turn AI on or off for a project, use the SmartestQA AI account or your own provider key, and choose which AI capabilities run. - [Selenium & Playwright](https://docs.smartestqa.ai/en/project-settings-engines.md): Browser options of WEB projects for the Selenium and the Playwright engine: incognito, certificates, user agent, proxy, timezone, geolocation and more. - [Mobile Config](https://docs.smartestqa.ai/en/project-settings-mobile.md): Where a mobile project’s app runs (your device, SmartTest Device Farm, AWS Device Farm, BrowserStack) and every field of each mode. - [Desktop Configuration](https://docs.smartestqa.ai/en/project-settings-desktop.md): Platform, Appium server and the list of desktop applications a DESKTOP project tests, with the default app and how a test picks its app. - [Troubleshooting](https://docs.smartestqa.ai/en/project-settings-troubleshooting.md): Every Project Panel message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/project-settings-faq.md): Questions about project settings, what AI assistants can change through MCP, and the limits of every field. - **Company settings** (whole section: https://docs.smartestqa.ai/en/company-settings-section.md) - [Company settings](https://docs.smartestqa.ai/en/company-settings.md): What Company Settings controls for the whole company: users, roles, task statuses, Active Directory sign-in, run capacity and billing. - [Users](https://docs.smartestqa.ai/en/company-settings-users.md): Add users, change their role, deactivate them, give them projects, resend their password email and copy their agent API key. - [Roles & permissions](https://docs.smartestqa.ai/en/company-settings-roles.md): The three fixed roles and, item by item, what Admin and User can and cannot do in projects, the archive and the company. - [Task Settings](https://docs.smartestqa.ai/en/company-settings-task-settings.md): The statuses tasks and defects can have: the four defaults, adding your own with a colour, editing and deleting them. - [Active Directory](https://docs.smartestqa.ai/en/company-settings-active-directory.md): Let people sign in with their Active Directory password: servers, service account, groups to roles and projects, user tests and security options. - [Network and capacity](https://docs.smartestqa.ai/en/company-settings-network.md): The IP addresses Run on Server uses to reach your app, how many server runs your company can have at once, and why a run waits. - [Billing](https://docs.smartestqa.ai/en/company-settings-billing.md): See your company’s current licence and its usage limits, choose or change the licence, pay by card, and cancel the automatic renewal. - [Troubleshooting](https://docs.smartestqa.ai/en/company-settings-troubleshooting.md): Every Company Settings message and symptom, with why it happens, what to check and how to fix it. - [FAQ & limits](https://docs.smartestqa.ai/en/company-settings-faq.md): Questions about users, seats, roles, Active Directory, task statuses, capacity and the licence, and the limits of the section. - **Integrations** (whole section: https://docs.smartestqa.ai/en/integrations-section.md) - [Integrations](https://docs.smartestqa.ai/en/integrations.md): Which outside systems SmartestQA connects to, what each one sends, who can set them up and how the status chips work. - [Jira & Azure DevOps](https://docs.smartestqa.ai/en/integrations-issue-trackers.md): Connect tasks to Jira issues or Azure DevOps work items, map statuses and priorities, and publish runs to Test Plans. - [Xray & Zephyr Scale](https://docs.smartestqa.ai/en/integrations-test-management.md): Sync test cases with Xray Cloud or Zephyr Scale, bring Jira requirements in, and write pipeline results back. - [Confluence](https://docs.smartestqa.ai/en/integrations-confluence.md): Publish run reports and test case documentation to Confluence Cloud pages under parent pages you choose. - [Slack, Teams & WhatsApp](https://docs.smartestqa.ai/en/integrations-notifications.md): Post pipeline results, task alerts and a daily summary to a Slack or Teams channel or to WhatsApp phones. - [Email (IMAP/SMTP)](https://docs.smartestqa.ai/en/integrations-email.md): Connect a test mailbox so mail steps can wait for emails, read one-time codes and links, and send mail during a test. - [Webhooks](https://docs.smartestqa.ai/en/integrations-webhooks.md): Send signed JSON events for pipelines, tasks and deploys to any HTTP endpoint, and verify them on the receiving side. - [CI/CD](https://docs.smartestqa.ai/en/integrations-cicd.md): Start a SmartestQA pipeline from your CI, wait for it, get a JUnit report and fail the build when tests fail. - [Datadog & Dynatrace (APM)](https://docs.smartestqa.ai/en/integrations-apm.md): Show your servers’ CPU, memory and response times next to load test results, and mark test runs in your APM dashboards. - [How the numbers work](https://docs.smartestqa.ai/en/integrations-numbers.md): Every status chip, counter and figure on the integration pages and in their messages, with its formula and a worked example. - [Troubleshooting](https://docs.smartestqa.ai/en/integrations-troubleshooting.md): Every integration message and symptom, with why it happens, what to check and how to fix it. - [FAQ, MCP & limits](https://docs.smartestqa.ai/en/integrations-faq.md): Questions and answers about integrations, what AI assistants can do through MCP, and every limit. - **Logs** (whole section: https://docs.smartestqa.ai/en/logs-section.md) - [Logs](https://docs.smartestqa.ai/en/logs.md): The audit log of your company: every change, who made it, from the app, MCP or an API key, on which record, and whether it went through. - [Audit log](https://docs.smartestqa.ai/en/logs-audit-log.md): Filter, read and export audit records: what each column and detail means, what is recorded, and how actions, results and sources are decided. - [Troubleshooting](https://docs.smartestqa.ai/en/logs-troubleshooting.md): Every Logs message and symptom, with why it happens, what to check and how to fix it. - [FAQ & limits](https://docs.smartestqa.ai/en/logs-faq.md): Questions about the audit log: retention, editing, MCP and API key changes, compliance exports, and its limits. ## Help - [Troubleshooting](https://docs.smartestqa.ai/en/troubleshooting.md): Find your problem by symptom: the exact message or behaviour, its usual cause in one line, and a link to the detailed fix. - [Glossary](https://docs.smartestqa.ai/en/glossary.md): Every term you meet on a SmartestQA screen, A to Z, in one or two plain sentences with a link to the page that explains it. ## Optional - [Everything in one file](https://docs.smartestqa.ai/llms-full.txt): all pages concatenated, for loading into an assistant or an MCP resource.