MCP Integration Overview
Transform your testing workflow by integrating Testr with AI assistants through the Model Context Protocol (MCP).
What is MCP?
The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external tools and data sources. Testr's MCP integration allows AI assistants like Claude to:
- Create and manage tests using natural language
- Execute tests on demand with intelligent prompts
- Monitor test results and provide insights
- Analyze testing patterns for optimization recommendations
Why Use MCP with Testr?
🤖 Natural Language Testing
"Create a test to verify the checkout flow on our e-commerce site"Instead of manually clicking through the UI, describe your testing needs in plain English.
⚡ Instant Test Creation
Skip the form-filling process. AI understands your requirements and creates appropriately configured tests automatically.
📊 Intelligent Analysis
"Show me why our login tests have been failing this week"Get AI-powered insights into test failures and performance patterns.
🔄 Workflow Automation
Integrate testing directly into your development workflow through AI assistant conversations.
Key Benefits
For Developers
- Faster Test Creation: Describe tests in natural language
- Contextual Testing: AI understands your application context
- Automated Insights: Get intelligent analysis of test results
- Workflow Integration: Test directly from your development environment
For QA Teams
- Exploratory Testing: AI can discover edge cases and user flows
- Regression Automation: Automatically create tests for new features
- Pattern Recognition: Identify testing gaps and optimization opportunities
- Collaborative Testing: Share and discuss test results through AI conversations
For Product Teams
- User Journey Validation: Verify complex user flows with simple prompts
- Feature Testing: Quickly validate new features before release
- Performance Monitoring: Track testing metrics through natural language queries
- Cross-functional Collaboration: Bridge technical and non-technical team members
Available MCP Tools
Testr provides 5 powerful MCP tools:
📋 list-test-definitions
View all your reusable test templates with filtering and pagination.
🔍 get-test-definition
Retrieve detailed information about specific test definitions.
✨ create-test-definition
Create new test templates using natural language descriptions.
🚀 start-test-run
Execute tests from existing definitions and monitor progress.
📊 get-test-run-status
Check execution status, results, and detailed analytics.
Integration Examples
Quick Test Creation
AI: I'd like to create a test for our contact form submission
Testr: I'll create an explorer test to verify the contact form works correctly.Batch Testing
AI: Run all our authentication-related tests
Testr: I'll execute the login, registration, and password reset tests for you.Results Analysis
AI: Why did our checkout test fail yesterday?
Testr: The test failed at step 5 because the payment button wasn't found. The page layout appears to have changed.Supported AI Assistants
✅ Cursor IDE
Perfect for developers who want testing integrated into their coding workflow.
✅ Claude Desktop
Ideal for non-technical team members who need testing capabilities.
✅ Custom MCP Clients
Build your own integrations using the standard MCP protocol.
Getting Started
1. Generate API Key
Create an API key from your Testr dashboard for secure MCP access.
2. Configure Your Client
Add Testr to your MCP client configuration with your API key.
3. Start Testing
Begin creating and running tests through natural language conversations.
Common Use Cases
Development Workflow
- Feature Development: Test new features as you build them
- Bug Verification: Quickly verify fixes with targeted tests
- Refactoring Safety: Ensure changes don't break existing functionality
CI/CD Integration
- Deployment Validation: Automatically test critical paths after deployments
- Environment Verification: Confirm staging environments work correctly
- Release Readiness: Validate features before production release
Team Collaboration
- Cross-team Testing: Enable non-technical team members to create tests
- Knowledge Sharing: Document test scenarios through AI conversations
- Issue Investigation: Collaboratively debug test failures
Security & Privacy
🔒 Secure Authentication
- API key-based authentication
- Session management with automatic expiration
- No permanent storage of sensitive data
🛡️ Data Protection
- All test data encrypted in transit and at rest
- Secure browser automation in isolated environments
- No access to your source code or internal systems
🔍 Audit Trail
- Complete logs of all MCP interactions
- Test execution history and results
- API usage tracking and monitoring
Best Practices
Effective Prompting
- Be Specific: "Test the checkout flow with a $50 purchase"
- Include Context: "Test login with valid credentials on the staging environment"
- Define Success: "Verify the welcome message appears after successful login"
Credit Management
- Set Budgets: Configure appropriate credit limits for explorer tests
- Monitor Usage: Track credit consumption through analytics
- Optimize Tests: Review and refine test efficiency regularly
Team Adoption
- Start Simple: Begin with basic navigation and form tests
- Share Success: Demonstrate value to encourage team adoption
- Iterate: Continuously improve test quality based on results
Next Steps
Ready to integrate MCP with your workflow?
- Setup & Configuration - Configure MCP with your AI assistant
- Usage Guide - Learn common patterns and commands
- Tool Reference - Complete API documentation for all MCP tools
Transform your testing workflow today with AI-powered automation!