1. Docs
  2. Build tests
  3. Analyze
  4. FAQ, MCP & limits

FAQ, MCP & limits

Answers to common questions about Analyze, how AI assistants use this module, and its limits.

5 min read Updated CustomersAdmins

In short

On this page you can

  • Get quick answers about requirements, AI, links, roles and data.
  • Filter the questions for customers or admins.
  • Let an AI assistant write requirements through MCP, with your approval.
  • Look up the limits that apply to imports, AI and requirements.

How to use it

  1. Pick your audience with the filter above the questions.
  2. Open a question to read the answer and its links.
  3. For assistants, connect one from Device Farm › Test Agents › Connect to Claude.
  4. Check the limits table before importing a large document.

Questions and answers#

What is the difference between a main requirement and a sub-requirement?Customers

A main requirement is a feature or user flow and sits in the tree. A sub-requirement is one condition with an expected result inside it, and that is where test cases are linked. See building blocks and a good example.

Can I use Analyze without AI?Customers

Yes. Folders, requirements, sub-requirements, links, documents and comments work without AI. The AI wizard, Generate, Automate on a sub and Assessment (AI) need Enable AI (and the wizard also AI Document Analysis) in Project Panel › AI Options.

Which files can I import, and how big can they be?Customers

Word, PDF with text, text, Markdown, HTML, JSON, CSV, YAML, XML, Excel and common image formats, several at once; see Import. There is no fixed document size, but the browser waits at most 3 minutes for the outline, so split long documents by chapter or module.

Does the AI read the documents in the Documents folder?Customers

Not the in-app AI: it reads only the files you attach on the Import tab. An AI assistant connected through MCP can read and write those documents.

Does a high Quality Score mean the requirement is tested?Customers

No. The score rates how clear and complete the requirement text is. Whether it is tested shows in its linked test cases and in InSight › Test Health. See Quality Score and What counts as covered.

Does the Status change when the tests pass?Customers

No. Status (New, Assigned, Implemented, Closed) is set only by people. Test results show in Report and Test Health.

Does Analyze work for mobile and desktop projects?Customers

Yes, the same way. Two parts of the AI wizard assume a web app: Record Actions uses the browser extension, and the optional pipeline needs a Start Page URL. For mobile and desktop, capture missing controls in Discover and create pipelines in Schedule.

Can I get back a sub-requirement I deleted?Customers

No. A sub removed in the list and saved is deleted for good, with its links. Main requirements and folders go to the Archive and can be restored. See Archive and restore.

Can I import requirements from Jira or Confluence?Customers

From Confluence, only through an AI assistant: the Confluence page shows Requirements Import as Coming soon, with no button. An assistant connected through MCP can start the import, which creates main requirements in a Confluence Import folder. Analyze has no Jira import. You can export the issues to a file and use the AI wizard, or let an AI assistant write them through MCP.

Do requirements count toward our licence?Admins

Yes. Your company’s licence can limit how many requirements you create. Creating a requirement or a document from the tree adds one to the company’s requirement counter, and archiving does not take it back. At the limit you see “Company license limit has been reached…”. An Admin sees the licence in Company Settings › Billing.

Who can delete requirements, folders and modules?Admins

Deleting moves items to the Archive. Users can archive what they created entirely; Admins can archive anything, including modules, and only Admins can delete for good. See Who can do what.

What does Analyze send to the AI provider?Admins

The wizard sends the attached documents and images, the actions and App Map descriptions of the scope (with up to 6 screenshots), template test cases, similar existing requirements and active Notes. The assessment sends the names, descriptions and severities of a main requirement and its subs. Everything goes to the provider configured in AI Options. Use test data in documents.

Which AI Options does Analyze use?Admins

Enable AI for every AI feature here, plus AI Document Analysis for the Import wizard. The AI account (SmartestQA’s or your own key), the provider and the model come from the same settings.

For AI assistants (MCP)#

An assistant connected through the SmartestQA MCP server works on Analyze with two calls: smartest_propose returns a diff and writes nothing; after you approve, smartest_apply writes exactly that preview. Connect an assistant from Device FarmTest AgentsConnect to Claude.

LevelParentWhat the assistant can do
mainA moduleCreate, enrich, update, remove main requirements; reorganise them between modules
subA main requirementCreate, enrich, update, remove sub-requirements, with their source and a status line (Verified, Inferred, Conflict, Not in code); mark a sub as not automatable with a reason
documentDocumentsWrite project documents; smartest_discover with kind=documents reads them
  • smartest_context with a main or sub as target tells the assistant where things stand; smartest_status shows what is missing project-wide.
  • A sub-requirement marked not automatable is left out of Test Health coverage. The reason can be up to 1,000 characters; only subs can be marked.
  • An assistant can delete a requirement only if it created it, and only when the connected user is an Admin.
Example prompts
Read the checkout code in /web/src/checkout and propose main requirements for the module Payments, with sub-requirements for every validation rule.

Which sub-requirements in Payments have no test case yet? Propose one scenario for each.

Mark the sub-requirement "Bank settlement file is received" as not automatable: it needs the bank's batch system.

Limits#

ItemLimit
Requirement name255 characters
Sub-requirement description written by an MCP assistant255 characters
Not-automatable reason (MCP)1,000 characters
Browser wait: outline · step generation3 min · 10 min
Server budget for one step generation420 s, batches of 4 scenarios
App Map screenshots per analysis (with scope)6
Similar requirements sent to avoid duplicates10
Proposals from Generate Sub Requirements3–5
Proposals from Automate on a sub1–3 test cases
Sub description for Automateat least 10 characters

Didn’t find your answer?Write to support with your project name and what you see on screen.

info@smartestqa.ai
© 2026 Selenity Technology · SmartestQAsmartestqa.aiThis page as MarkdownChecked against smarttest-fe predev 2a8c79cc, smarttest-be 633c2a03, smartest-mcp-server, research/analyze.md