Prerequisites
Before you start using Opsera AI Agents, ensure you have the following requirements in place. This page covers everything you need to successfully set up and run agents in your development environment
Quick Checklist
Platform Requirements
Opsera Platform Access
Required:
Active Opsera account (sign up at agent.opsera.ai)
Internet connection for agent communication
Access to Opsera Agent portal
To verify your access:
Visit agent.opsera.ai
Sign in with your Google account
Confirm you can see the Getting Started page and agent list
Don't have access? Sign up at agent.opsera.ai using your corporate Google account, or contact hi@opsera.io for assistance.
Authentication
Opsera Agents use automatic authentication through the MCP (Model Context Protocol) configuration. No API keys required!
How it works:
You sign into the Opsera portal with your Google account
Your terminal connects to Opsera's MCP server using a simple configuration
Authentication is handled automatically when you use agents
💡 No secrets to manage - Authentication happens through your browser session, making setup simple and secure.
Terminal & IDE Requirements
Choose one of the following terminals to run Opsera Agents. Each has different setup requirements:
Option 1: Claude Desktop (Recommended for First-Time Users)
System Requirements:
macOS: macOS 11 (Big Sur) or later
Windows: Windows 10 (64-bit) or later
Linux: Ubuntu 20.04+ or equivalent
Additional Requirements:
Node.js 18+ (for MCP server)
npm or npx package manager
2GB free disk space
Installation:
Download from: claude.ai/download
Claude account required (free or Pro)
Option 2: Cursor IDE
System Requirements:
macOS: macOS 11 or later
Windows: Windows 10 (64-bit) or later
Linux: Ubuntu 20.04+ or equivalent
Additional Requirements:
Node.js 18+
4GB free disk space
Active Cursor subscription (free or Pro)
Installation:
Download from: cursor.sh
Option 3: VS Code
System Requirements:
macOS: macOS 10.15 or later
Windows: Windows 10 (64-bit) or later
Linux: Ubuntu 20.04+ or equivalent
Additional Requirements:
Visual Studio Code 1.80+
Node.js 18+
Opsera Agents extension (available in VS Code Marketplace)
Installation:
VS Code: code.visualstudio.com
Extension: Search "Opsera Agents" in VS Code Extensions
Optional: Pre-Installation Testing
Before full setup, verify your environment meets all requirements:
1. Test Node.js & npm
2. Test Git Provider Access
All tests passed? You're ready to proceed with Terminal Setup!
Troubleshooting Prerequisites
Common Issues
"I don't have access to the Agents section in Opsera Portal"
Your account may not have Agent features enabled
Contact your Opsera administrator or support team
"Node.js is not installed or version is too old"
Download and install from nodejs.org
Or use nvm for version management
"Network connection to Opsera fails"
Check firewall/proxy settings
Verify with IT that Opsera domains are whitelisted
Try from a different network (e.g., mobile hotspot) to isolate issue
"Git provider authentication fails"
Verify your token has correct scopes/permissions
Check token hasn't expired
Ensure token is correctly entered in Opsera Portal
"I'm getting SSL certificate errors"
Your corporate network may use SSL inspection
Contact IT to add Opsera certificates to trusted list
Or disable strict SSL (not recommended for production)
Next Steps
Once you've confirmed all prerequisites are met:
Choose your terminal: Claude Desktop | Cursor | VS Code
Follow the setup guide for your chosen terminal
Run your first agent with our Quick Start Guide
Need Help?
Still having issues with prerequisites?
📚 Check our FAQ
💬 Join our Discord Community
📧 Email support: support@opsera.io
Enterprise customers: Contact your dedicated Customer Success Manager for personalized setup assistance.
Last updated