Prerequisites
- An Autosana account (book a demo to get access)
- A mobile app or website that you want to test (duh)
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.
Copy
Ask AI
my-project/ ← run setup here
├── frontend/
├── backend/
└── .mcp.json
<YOUR_API_KEY> with your key from Settings → Integrations → API Key.- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Codex
- OpenClaw
Run this command in your terminal:
Copy
Ask AI
claude mcp add --transport http autosana https://mcp.autosana.ai/mcp --header "x-api-key: <YOUR_API_KEY>"
Add this to:
~/claude_desktop_config.jsonCopy
Ask AI
{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
Add this to:
~/.cursor/mcp.jsonCopy
Ask AI
{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
Run this command in your terminal:Or add this to your
Copy
Ask AI
gemini mcp add --transport http autosana https://mcp.autosana.ai/mcp --header "x-api-key: <YOUR_API_KEY>"
~/.gemini/settings.json:Copy
Ask AI
{
"mcpServers": {
"autosana": {
"httpUrl": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
Add this to:
~/.codex/config.tomlCopy
Ask AI
[mcp_servers.autosana]
url = "https://mcp.autosana.ai/mcp"
http_headers = { "x-api-key" = "<YOUR_API_KEY>" }
Add this to: Or via mcporter, add this to:
~/.openclaw/openclaw.jsonCopy
Ask AI
{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
~/.mcporter/mcporter.jsonCopy
Ask AI
{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
2. Onboard
Tell your agent:Copy
Ask AI
Onboard me to Autosana
Step 1: Add Your App or Website
- Mobile
- Web
CI/CD Pipeline Integration (Recommended)
- Go to Settings → Integrations and generate/copy your API key
- 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
.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)
- Go to Settings → Integrations and copy your API key
- Follow the setup guide to integrate with your pipeline (Vercel, Netlify, etc.)
- Your preview URL will automatically be registered with Autosana on every deploy
- 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:
CopyAsk AI
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
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