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.
my-project/ ← run setup here
├── frontend/
├── backend/
└── .mcp.json
<YOUR_API_KEY> with your key from the welcome quickstart or Settings → API Keys. You can also open your client under Settings → Integrations for the matching setup snippet.- Claude Code
- Claude Desktop
- Cursor
- Gemini CLI
- Codex
- Grok Bot
- Devin
- 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>"
Open Claude Desktop → Settings → Developer → Edit Config. Add Save the file, then fully quit and reopen Claude Desktop. Closing its window is not enough.
autosana inside the existing mcpServers object if you already have other servers configured.{
"mcpServers": {
"autosana": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.autosana.ai/mcp",
"--header",
"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:Or add this to your
gemini mcp add --transport http autosana https://mcp.autosana.ai/mcp --header "x-api-key: <YOUR_API_KEY>"
~/.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>" }
Grok Bot has no Settings form for a custom MCP URL, and Autosana is not in the marketplace. Open Settings → Integrations → Grok Bot to create a key, then send this in a Grok Bot chat:Approve the confirm card. Next message:
Add a custom MCP called Autosana at https://mcp.autosana.ai/mcp with header x-api-key: <YOUR_API_KEY>
@ Autosana and ask it to list or run a flow. Adding MCP in Cursor does not set up Grok Bot.Full walkthrough: Grok Bot.In Devin, open Customize → MCPs → Add a custom MCP. Choose HTTP, not STDIO. Open Settings → Integrations → Devin to create a key, then fill in:Save, then use Test listing tools. Adding MCP in Cursor does not set up Devin.Full walkthrough: Devin.
Server name: Autosana
Transport: HTTP
Server URL: https://mcp.autosana.ai/mcp
Authentication: Auth Header
Header key: x-api-key
Header value: <YOUR_API_KEY>
Add this to: Or via mcporter, add this to:
~/.openclaw/openclaw.json{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
~/.mcporter/mcporter.json{
"mcpServers": {
"autosana": {
"url": "https://mcp.autosana.ai/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
2. Onboard
Tell your agent:Onboard me to Autosana
Step 1: Add Your App or Website
- Mobile
- Web
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
.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
- 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
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