# Prerequisites

### 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](https://agent.opsera.ai))
* Internet connection for agent communication
* Access to Opsera Agent portal

**To verify your access:**

1. Visit [agent.opsera.ai](https://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](https://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](https://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](https://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](https://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

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

#### 2. Test Git Provider Access

```bash
# 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](https://docs.agents.opsera.ai/terminal-setup/choose-your-environment)!

### 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](https://nodejs.org/)
* Or use [nvm](https://github.com/nvm-sh/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](https://docs.agents.opsera.ai/terminal-setup/claude-desktop) | [Cursor](https://docs.agents.opsera.ai/terminal-setup/cursor-ide) | [VS Code](https://docs.agents.opsera.ai/terminal-setup/vs-code)
2. **Follow the setup guide** for your chosen terminal
3. **Run your first agent** with [our Quick Start Guide](https://docs.agents.opsera.ai/readme)

***

### Need Help?

**Still having issues with prerequisites?**

* 📚 Check our [FAQ](https://claude.ai/chat/4ebb4297-734f-4bb7-a76f-dbf4ccd66dac)
* 💬 Join our [Discord Community](https://claude.ai/chat/4ebb4297-734f-4bb7-a76f-dbf4ccd66dac)
* 📧 Email support: <support@opsera.io>

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.agents.opsera.ai/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.