Documentation Index Fetch the complete documentation index at: https://docs.autosana.ai/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
Getting Started
Automated (Recommended)
Manual
1. Add the MCP Server We highly recommend adding the MCP to the root of your project to give the agent optimal context. my-project/ ← run setup here
├── frontend/
├── backend/
└── .mcp.json
Replace <YOUR_API_KEY> with your key from the welcome quickstart or Settings → Integrations → API Key . Claude Code
Claude Desktop
Cursor
Gemini CLI
Codex
OpenClaw
Run this command in your terminal: claude mcp add --transport http autosana https://mcp.autosana.ai/mcp --header "x-api-key: <YOUR_API_KEY>"
Add this to : ~/claude_desktop_config.json{
"mcpServers" : {
"autosana" : {
"url" : "https://mcp.autosana.ai/mcp" ,
"headers" : {
"x-api-key" : "<YOUR_API_KEY>"
}
}
}
}
Add this to : ~/.cursor/mcp.json{
"mcpServers" : {
"autosana" : {
"url" : "https://mcp.autosana.ai/mcp" ,
"headers" : {
"x-api-key" : "<YOUR_API_KEY>"
}
}
}
}
Run this command in your terminal: gemini mcp add --transport http autosana https://mcp.autosana.ai/mcp --header "x-api-key: <YOUR_API_KEY>"
Or add this to your ~/.gemini/settings.json: {
"mcpServers" : {
"autosana" : {
"httpUrl" : "https://mcp.autosana.ai/mcp" ,
"headers" : {
"x-api-key" : "<YOUR_API_KEY>"
}
}
}
}
Add this to : ~/.codex/config.toml[ mcp_servers . autosana ]
url = "https://mcp.autosana.ai/mcp"
http_headers = { " x-api-key " = "<YOUR_API_KEY>" }
Add this to : ~/.openclaw/openclaw.json{
"mcpServers" : {
"autosana" : {
"url" : "https://mcp.autosana.ai/mcp" ,
"headers" : {
"x-api-key" : "<YOUR_API_KEY>"
}
}
}
}
Or via mcporter, add this to : ~/.mcporter/mcporter.json {
"mcpServers" : {
"autosana" : {
"url" : "https://mcp.autosana.ai/mcp" ,
"headers" : {
"x-api-key" : "<YOUR_API_KEY>"
}
}
}
}
After adding the configuration, restart your agent for the changes to take effect. 2. Onboard Tell your agent: It’ll handle CI/CD setup, test planning and creation, and more. Step 1: Add Your App or Website CI/CD Pipeline Integration (Recommended)
Copy your API key from the welcome quickstart after checkout, or later from Settings → Integrations
Follow the setup guide to integrate with your pipeline (GitHub Actions, Fastlane, Expo EAS, etc.)
Your first build will automatically create the app in Autosana
Learn more about our CI/CD Integration → Manual Upload Get your build file ready (iOS: .zip containing your .app bundle, Android: .apk). Learn how to build your app →
Navigate to the Apps page from the sidebar
Click Create New App
Fill in app name, bundle ID, platform, and optionally an environment
Drag and drop your build file, then click Upload
CI/CD Pipeline Integration (Recommended)
Copy your API key from the welcome quickstart after checkout, or later from Settings → Integrations
Follow the setup guide to integrate with your pipeline (Vercel, Netlify, etc.)
Your preview URL will automatically be registered with Autosana on every deploy
Learn more about our CI/CD Integration → Manual Setup
Navigate to the Apps page from the sidebar
Click Create New App
Enter your app name, URL, select Web as the platform, and click Create
Step 2: Create Your First Flow A Flow is a test written in natural language that describes what you want to test.
Navigate to the Flows page
Click Create Flow
Write your flow instructions in natural language:
Open the app
Tap on the login button
Enter "test@example.com" in the email field
Enter "password123" in the password field
Tap the submit button
Verify that the home screen appears
Click Create Flow
Step 3: Run Your First Flow
Find your flow in the Flows table
Click the Play button (▶️) next to your flow
Select your app from the dropdown
Click Run Flow
Your flow will now execute on our cloud infrastructure. You’ll see real-time status updates as the flow progresses. Step 4: View Results Once your flow completes:
Click on the status badge (Passed/Failed) in the Flows table
View detailed results including:
Screenshots at each step
Actions performed by the agent
Any errors encountered
Next Steps
Suites Group related flows and run them together
Automations Schedule flows to run on builds, daily, or weekly
CI/CD Upload builds automatically from your pipeline