📖 Setup Guide · v12.21

Get started in 5 minutes

Step-by-step guides to set up your API keys and integrations. Everything is free to start — no credit card required.

🤖
Add Shuddhi QA to Microsoft 365 Copilot (~5 min)

Prerequisite: Active Microsoft 365 Copilot license, and your tenant admin allows custom Copilot Studio agents with MCP server connectors.

  1. Open copilotstudio.microsoft.com with your work account
  2. Click Create → New agent → choose Declarative Agent
  3. Name it Shuddhi QA and add the description: "AI test case generator for 14 enterprise platforms"
  4. In the agent's Knowledge / Actions panel, click Add → MCP server
  5. Paste this URL: https://shuddhiqa-mcp.ramya9-b.workers.dev/mcp
  6. Authentication: None (v0.1)
  7. Click Test — Copilot Studio should discover all 5 tools
  8. Publish and invoke from any Copilot surface: @Shuddhi-QA generate D365 vendor invoice test cases
🟣
Add to Claude Desktop (~30 sec)

Open your Claude Desktop config file at %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add this:

{
  "mcpServers": {
    "shuddhi-qa": {
      "transport": {
        "type": "streamable-http",
        "url": "https://shuddhiqa-mcp.ramya9-b.workers.dev/mcp"
      }
    }
  }
}

Restart Claude Desktop. Type "Generate D365 vendor invoice test cases with workflow approval" — you'll see the tool fire and the table render inline.

Add to Cursor / Continue / other MCP clients

In Cursor: Settings → Cursor Settings → MCP Servers → Add. Server type: Streamable HTTP. URL: https://shuddhiqa-mcp.ramya9-b.workers.dev/mcp. No auth.

In Continue: edit ~/.continue/config.json, add an mcpServers entry pointing at the URL above. Same shape as Claude Desktop.

For any other MCP-capable client: paste the URL into whatever "Add MCP server" form they expose. Authentication is not required in v0.1.

🛠️
Five tools exposed

Once added, your AI client can invoke any of:

  • generateTestCases — production-grade test cases for 14 platforms
  • fetchJiraIssue — pull a Jira ticket's content into the conversation
  • pushToADO — push generated test cases to an Azure DevOps Test Plan
  • listTemplates — browse the 110-template library by platform/domain
  • detectPlatform — identify platform/domain/module from any requirement text

Full API reference, source code, and the OpenAPI 3.0 spec: github.com/ramya9b/shuddhiqacloud

Groq API Key

Llama 3.3 70B · Fastest response · Recommended for new users

Free Forever ★ Recommended
💡 Why Groq? Groq is the fastest AI in the world — 30 requests/minute, 14,400 requests/day, completely free. No credit card ever. Perfect for generating test cases all day.

Open Groq Console

Go to the Groq API key management page in your browser.

🔗 console.groq.com/keys

Sign in with Google

Click "Sign in" → choose "Continue with Google" → select your Google account. No form filling needed — just one click.

Create a new API key

Once logged in, click the "Create API Key" button (blue button, top right of the page).

Give it a name like "Shuddhi QA" → click "Submit".

Copy the key

Your key appears once — it starts with gsk_. Click the copy icon next to it.

gsk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️Save this key somewhere safe — Groq only shows it once. If you lose it, just create a new one (it's free).

Paste it in Shuddhi QA

Open Shuddhi QA → Settings (⚙️) → AI Provider. Under "Your Personal API Keys", find the Groq row and paste your key. Click 🔌 Test to verify it works. Done!

Google Gemini API Key

Gemini 2.5 Flash · Best quality output · 15 req/min free

Free Tier
💡 Why Gemini? Gemini 2.5 Flash produces the highest quality test cases of the three free options. Best for large, complex D365 or Salesforce requirement documents.

Open Google AI Studio

Go to Google AI Studio — the official portal to create Gemini API keys.

🔗 aistudio.google.com/app/apikey

Sign in with Google

Sign in with any Google account — the same one you use for Gmail or Google Drive is fine.

Create API key

Click "Create API key" → Select "Create API key in new project" (easiest option). Google creates a project automatically.

Copy the key

Your key appears — it starts with AIzaSy. Click the copy icon.

AIzaSyxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Paste it in Shuddhi QA

Open Settings → AI Provider → Your Personal API Keys → Gemini row. Paste the key and click 🔌 Test.

Free tier limits: 15 requests/minute · 1,500 requests/day · 1 million tokens/minute. More than enough for daily QA work.
🤖

Anthropic Claude API Key

Claude Sonnet 4.6 · Highest QA reasoning quality · Paid

Paid — ~$0.10/run
💡 Why Claude? Claude produces the most accurate, detailed test cases for complex enterprise workflows (D365, Salesforce, SAP). Recommended if you need the highest quality output. Cost: ~₹9 per generation.

Open Anthropic Console

🔗 console.anthropic.com

Create an account

Click "Sign up" → enter your email → verify → set a password.

Add a payment method

Claude requires a credit/debit card to activate the API (even for pay-as-you-go at very low rates). Go to Settings → Billing → Add payment method.

💰Recommended: add $5 credits to start. At ~$0.10/generation, that's 50 generations — more than enough to evaluate quality before committing.

Create API key

Go to Settings → API Keys → Create Key. Name it "Shuddhi QA" → click Create.

Copy the key

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️Claude keys are shown only once. Copy it immediately and save it.

Paste it in Shuddhi QA

Open Settings → AI Provider → Your Personal API Keys → Claude row. Paste the key and click 🔌 Test.

🟢

OpenAI — API Key Setup

GPT-4o mini · High quality · US-hosted · Pay per use

Paid · US-hosted
💡 OpenAI GPT-4o mini delivers excellent test case quality at ~$0.15/M tokens — much cheaper than Claude while maintaining enterprise-grade output. US-hosted, GDPR-compliant.

Open OpenAI Platform

Go to the API keys page in your browser.

🔗 platform.openai.com/api-keys

Create a new secret key

Click + Create new secret key. Give it a name like "Shuddhi QA". Set permissions to "All" or at minimum "Model capabilities".

💳OpenAI requires a billing method. Add a credit card and top up with $5 — this lasts hundreds of generations at GPT-4o mini rates.

Copy the key

Your key starts with sk-proj-… or sk-…. Copy it immediately — OpenAI only shows it once.

sk-proj-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️OpenAI keys are shown only once. Save it immediately.

Paste it in Shuddhi QA

Open Settings → AI Provider → Your Personal API Keys → OpenAI. Paste the key and click 🔌 Test to verify.

🤝

Together AI — API Key Setup

DeepSeek V3 + Llama 3.3 70B · US-hosted · ~20× cheaper than Claude

Best Value · US-hosted
🌟 Together AI hosts the open-source DeepSeek V3 model on US servers — giving you DeepSeek's intelligence at ~$0.20/M tokens with zero China data exposure. Best value option available.

Create a Together AI account

Go to the Together AI platform and sign up (free $1 credit on signup).

🔗 api.together.xyz

Get your API key

Navigate to Settings → API Keys and click Create.

🔗 api.together.xyz/settings/api-keys
💡You get $1 free credit on signup — enough for ~5,000 test case generations at DeepSeek V3 rates.

Copy the key

Your key looks like together_api_…

together_api_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Paste it in Shuddhi QA

Open Settings → AI Provider → Your Personal API Keys → Together. Paste the key and click 🔌 Test to verify.

🛡️Together AI is US-hosted. Your requirement documents are NOT sent to Chinese servers — only to Together's US infrastructure running the open-source model weights.
☁️

Azure OpenAI — Enterprise Setup (BYO)

Your own Azure OpenAI resource · data residency · enterprise compliance

Enterprise · BYO
🏢 Azure OpenAI runs GPT-4o-class models inside your own Azure subscription. Requests stay in the Azure region you choose — ideal for enterprises with data-residency or compliance requirements. Unlike the other providers, Azure needs four values instead of a single key.

Create an Azure OpenAI resource

In the Azure portal, create an Azure OpenAI resource (requires an Azure subscription with OpenAI access).

🔗 portal.azure.com

Copy your Endpoint and API key

Open your resource → Keys and Endpoint. Copy the Endpoint and KEY 1.

https://your-resource.openai.azure.com

Deploy a model

In Azure AI Foundry → Deployments, deploy a current chat model (e.g. gpt-4o, gpt-4.1, or gpt-5-mini — avoid retired versions) and note the deployment name you assign it.

gpt-4o-prod

Paste all four values in Shuddhi QA

Open Settings → AI Provider → Your Personal API Keys → Azure OpenAI (click to expand). Fill in Endpoint, API Key, Deployment, and API Version (defaults to 2024-12-01-preview), then click 🔌 Test connection.

🛡️Your endpoint, key, and deployment stay in your browser only (shuddhi-azure-config). Generations run against your own Azure resource, in your chosen region.
📊

AI Provider Comparison

Choose the right provider for your use case

Provider Cost Quality Free Tier Best For
⚡ Groq Free ⭐⭐⭐ ✅ Yes Quick generations, server fallback
✦ Gemini 2.5 Flash Free / $0.30 ⭐⭐⭐½ ✅ 1,000/day Large FDDs, 1M token context
🤝 Together AI ~$0.20/M ⭐⭐⭐⭐ $1 credit Best value, DeepSeek V3 quality
🟢 OpenAI ~$0.15/M ⭐⭐⭐⭐½ ❌ Paid Enterprise teams with existing OpenAI keys
🤖 Claude $3–$15/M ⭐⭐⭐⭐⭐ ❌ Paid Maximum quality, complex enterprise flows
☁️ Azure OpenAI Your Azure rates ⭐⭐⭐⭐½ ❌ BYO Enterprise teams on Azure · data residency
💰

Claude Haiku — 5× Cheaper Option

Same Claude, fraction of the cost

🔗

Shareable Links

Share generated test cases with a permanent URL

🏷️

Platform Autocomplete & Domain Auto-link

Smart form fields that pre-fill from your requirement

Enterprise Quality Banner

Contextual guidance for enterprise platforms

🔷

Azure DevOps — Personal Access Token (PAT)

Required to push test cases to ADO Test Plans and fetch Work Items

Free with ADO account
A Personal Access Token (PAT) is like a password that lets Shuddhi QA talk to Azure DevOps on your behalf. It is stored only in your browser and is never stored on Shuddhi QA servers; it is sent over HTTPS to our /api/ado proxy only to forward your request to Azure DevOps.

Open Azure DevOps

Go to your Azure DevOps organisation. The URL looks like:

https://dev.azure.com/YOUR-ORGANISATION

If you don't have one, create a free account at:

🔗 dev.azure.com

Open User Settings

Click your profile picture (top right corner) → select "Personal access tokens" from the dropdown menu.

Create a new token

Click "+ New Token" (blue button, top right). Fill in the details:

FieldWhat to enter
NameShuddhi QA
OrganisationAll accessible organisations
Expiration90 days (or custom — longer is more convenient)

Set the required scopes

Under "Scopes", click "Custom defined" and enable these specific permissions:

ScopePermissionRequired for
Test Management Read & WritePush test cases to Test Plans
Work Items Read & WriteFetch Work Items for auto-fill
Project and Team ReadList projects in your org
💡If you only need to fetch Work Items (not push test cases), enabling Work Items Read is sufficient. You can always recreate the token with more permissions later.

Copy the token

Click "Create". Copy the token immediately — ADO shows it only once.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️Save the token in a password manager or secure note. If you lose it, you'll need to create a new one (the old one cannot be recovered).

Configure in Shuddhi QA

Open Settings → Azure DevOps tab. Fill in:

FieldExample value
Organisation URLhttps://dev.azure.com/mycompany
Personal Access TokenPaste your token here
Default ProjectMyProject (optional)

Click "Test Connection" → should show ✅ Connected.

🟦

Jira — API Token

Required to fetch Jira tickets and auto-fill requirement flow

Free with Jira account
A Jira API token lets Shuddhi QA read your Jira tickets. When you enter a ticket ID like PROJ-1234, Shuddhi QA fetches the summary, description, and acceptance criteria to automatically fill your requirement flow.

Open Atlassian Account Settings

Go directly to the API token management page:

🔗 id.atlassian.com → Security → API tokens

Sign in to Atlassian

Sign in with the same account you use for Jira at work. This is typically your work email address.

Create API token

Click "Create API token" → Enter a label like "Shuddhi QA" → click "Create".

Copy the token

The token is displayed once. Click "Copy" immediately.

ATATT3xFfGF0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
⚠️You will not be able to view the token again. If you lose it, create a new one (the old one will be revoked).

Find your Jira Base URL

Your Jira Base URL is the address you use to access Jira in your browser:

https://yourcompany.atlassian.net

Do NOT include the project path — just the base domain.

Configure in Shuddhi QA

Open Settings → Jira tab. Fill in:

FieldExample value
Jira Base URLhttps://yourcompany.atlassian.net
Emailramya@yourcompany.com (your Atlassian login email)
API TokenPaste the token you just copied

Click "Test Connection" → should show ✅ Connected as [your name].

💡Now you can enter any Jira ticket ID (e.g. ERP-567) in the main screen and click Fetch → to auto-fill the requirement flow in seconds.
🚀

🧠 Smart Detect — Auto-Identify Platform & Domain

Smart Detect uses a 4-phase enterprise intelligence engine to automatically identify the platform and business domain from your requirement text.

  1. Paste your requirement in the Business Flow field (at least 40 characters)
  2. The 🧠 Smart Detect Platform button appears below the description
  3. Click it — the AI analyses your text using semantic clue detection and domain ontology mapping
  4. The Platform field auto-fills (e.g. D365 F&O, Guidewire, SAP)
  5. The Industry Domain chip auto-selects (e.g. 🛡️ Insurance, ⚙️ ERP)
  6. The AI Detection badge shows: Platform, Module, Confidence %, Workflow, Evidence chips, Compliance obligations (IRDAI, SOX, HIPAA), Stakeholders, and Risk level

Cost: Smart Detect uses Shuddhi QA's Groq server key — completely free for all users. No API key required.

Keyword auto-detection also runs automatically as you type — 200+ enterprise signals covering Insurance, Banking, Healthcare, ERP, HR, Retail, ITSM, and Web/Mobile.

Generate Your First Test Cases

From zero to 40+ test cases in under 60 seconds

Quick Start

Add your API key (one-time setup)

Click ⚙️ Settings → AI Provider → Your Personal API Keys. Paste your Groq key in the Groq row. Click 🔌 Test to verify. Done — this is saved in your browser permanently.

Choose your platform

In the left panel, click your platform: D365 F&O, Salesforce, Web App, Mobile, etc. Shuddhi QA tailors the test cases to the platform you choose.

Describe the business flow

In the right panel under "Describe the Business Flow", type a plain-English description of the process you want to test. Example:

Vendor submits invoice via portal. AP Clerk performs 3-way match (Invoice, PO, Goods Receipt). If amount > ₹50,000, Finance Manager approves via workflow. Payment is scheduled and GL journal is posted.

You can also upload a PDF/DOCX requirement document — Shuddhi QA reads it automatically.

Or fetch from Jira / ADO

If you have Jira or ADO configured, enter the ticket ID in the Jira Ticket ID or ADO Work Item ID field and click Fetch →. The description auto-fills instantly.

Set output options

OptionChoices
Test PriorityHigh (focus on critical paths) · Medium · Low (comprehensive)
Output FormatEnd to End · Smoke · Integration · Full Suite
LanguageEnglish, German, Spanish, French, Portuguese (BR) — 4 more coming soon

Click Generate

Click the ⚡ Generate Test Cases button (or press Ctrl+Enter). Shuddhi QA generates 30–70 test cases with test steps, expected results, and priority in about 15–30 seconds.

Export or push

Once generated, use the export buttons:

ButtonWhat it does
ExcelDownloads .xlsx with separate sheets per TC type
PDFFormatted PDF document ready to share
MarkdownCopies to clipboard for Confluence/Notion
ADO buttonPushes directly to Azure DevOps Test Plan
More ▾Jira Zephyr CSV, TestRail, Gherkin, Playwright, Postman
🧠

Domain Intelligence

Domain Intelligence (v11.3) automatically detects the enterprise domain of your test scenario and enriches generated test cases with domain-specific context, terminology and risk coverage.

Supported domains: D365 Finance, D365 Supply Chain, Salesforce CRM, Salesforce Service Cloud, Insurance (Guidewire), Healthcare, ITSM (ServiceNow), HR/Payroll, Omni-Channel, API & Integration, Security & Data.

Power BI reports are fully supported — describe your report validation scenario (e.g. Open Aged Orders Report against Azure Synapse) and Shuddhi QA generates data accuracy, refresh, filter and row-level security test cases.
🎯

Free Trial & Sign-In

Shuddhi QA is free to use — no credit card required:

  1. Anonymous users get 3 free generations. No account needed. Use Groq as your AI provider for fully free access.
  2. Signed-in users get 10 free generations plus cross-device preference sync.
  3. Unlimited access — share Shuddhi QA on LinkedIn to unlock unlimited free generations.
🔓Click "Share on LinkedIn" in the free trial prompt → after sharing click "I've Shared — Unlock" to reset your generation count.
⚠️Groq is always free — select Groq as your AI provider to use Shuddhi QA with zero API costs.
👤

Sign In (Google / Microsoft)

Signing in is optional. Benefits: 10 free generations, cross-device sync, saved preferences.

  1. Google Sign-In — OAuth 2.0. Only requests name, email, profile photo. No access to Gmail, Drive or Calendar.
  2. Microsoft Sign-In — OAuth 2.0. Only requests name, email, profile. No access to Microsoft 365 or OneDrive.

Authentication is managed by Firebase Auth (Google LLC). Your API keys are stored in browser local storage only; when you generate test cases they are sent as a POST body over HTTPS to our Cloudflare Functions proxy, which never stores them server-side and uses them only to forward the request to the AI provider.

📚

Template Library — 100 Templates

100 production-ready test generation templates across 10 enterprise domains. Each template pre-fills the entire form in one click.

🔷D365 F&O (10)
☁️Salesforce (10)
🛡️Insurance (10)
🟩ITSM (10)
🌐Web / SaaS (10)
👥HR / Payroll (10)
🏥Healthcare (10)
🔁Omni-Channel (10)
🔌API & Integration (10)
🔒Security & Data (10)
💡Browse the full library at shuddhiqacloud.vercel.app/templates or click "View all →" on the app home screen.
🤖

6 AI Providers

Choose from 6 AI providers. Groq is fully free with no API key required:

🟠Claude (Anthropic)
🔵Gemini (Google)
🟢Groq — FREE ★
OpenAI (GPT-4)
🟣Together AI
☁️Azure OpenAI · BYO
Best quality: Claude Sonnet. Free option: Groq (Llama) — no API key, no cost, no limits.