FAQ, MCP & limits
Answers to common questions about Analyze, how AI assistants use this module, and its limits.
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
- Pick your audience with the filter above the questions.
- Open a question to read the answer and its links.
- For assistants, connect one from Device Farm › Test Agents › Connect to Claude.
- 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.
Why can’t I link a test case to a main requirement?Customers
Links belong to sub-requirements, so every test proves one specific condition. The main requirement shows the test cases of all its subs together. Select a sub to add one: Link a test case.
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.
| Level | Parent | What the assistant can do |
|---|---|---|
main | A module | Create, enrich, update, remove main requirements; reorganise them between modules |
sub | A main requirement | Create, 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 |
document | Documents | Write project documents; smartest_discover with kind=documents reads them |
smartest_contextwith a main or sub as target tells the assistant where things stand;smartest_statusshows 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.
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#
| Item | Limit |
|---|---|
| Requirement name | 255 characters |
| Sub-requirement description written by an MCP assistant | 255 characters |
| Not-automatable reason (MCP) | 1,000 characters |
| Browser wait: outline · step generation | 3 min · 10 min |
| Server budget for one step generation | 420 s, batches of 4 scenarios |
| App Map screenshots per analysis (with scope) | 6 |
| Similar requirements sent to avoid duplicates | 10 |
| Proposals from Generate Sub Requirements | 3–5 |
| Proposals from Automate on a sub | 1–3 test cases |
| Sub description for Automate | at least 10 characters |
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai