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

• Opsera account at agent.opsera.ai (sign in with Google)

• One of the supported terminals installed (Claude Desktop, Cursor, or VS Code)

• Network access to agent.opsera.ai

• Repository access credentials (GitHub, GitLab, etc.) if needed

• Appropriate permissions for your role

---

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:

1. Visit agent.opsera.ai

2. Sign in with your Google account

3. 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 [email protected] 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

node --version  # Should show v18.0.0 or higher
npm --version   # Should show v9.0.0 or higher

2. Test Git Provider Access

# Test GitHub access (if using GitHub)
curl -H "Authorization: token YOUR_GITHUB_TOKEN" https://api.github.com/user

# Test GitLab access (if using GitLab)
curl -H "PRIVATE-TOKEN: YOUR_GITLAB_TOKEN" https://gitlab.com/api/v4/user

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:

1. Choose your terminal: Claude Desktop | Cursor | VS Code

2. Follow the setup guide for your chosen terminal

3. 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: [email protected]

Enterprise customers: Contact your dedicated Customer Success Manager for personalized setup assistance.