Opsera MCP Server Configuration Guide

Connect Opsera DevOps Agent to Claude Code, Claude Desktop, VS Code, and Cursor IDE on macOS, Windows, and Linux

Quick Navigation

1 Prerequisites

Before configuring your MCP client, you'll need an Opsera API token.

Get Your Token

  1. Request access at /request-token
  2. Once approved, sign in to your dashboard
  3. Copy your API token (starts with opsera_)

Server Details

MCP Server URL: http://opseramcp-dev.agent.opsera.dev/mcp Transport Type: streamable-http Authorization: Bearer YOUR_TOKEN_HERE

2 Claude Code (CLI)

Configure Opsera MCP Server for Claude Code command-line interface.

Configuration File Locations

PlatformUser ScopeProject Scope
macOS~/.claude/settings.json.mcp.json in project root
Windows%USERPROFILE%\.claude\settings.json.mcp.json in project root
Linux~/.claude/settings.json.mcp.json in project root

Add via Command Line

# Add Opsera MCP Server (user scope - available across all projects) claude mcp add opsera -s user -e OPSERA_TOKEN=YOUR_TOKEN_HERE -- curl -X POST http://opseramcp-dev.agent.opsera.dev/mcp # Or add to current project only claude mcp add opsera -s project -- curl -X POST http://opseramcp-dev.agent.opsera.dev/mcp
REM Add Opsera MCP Server (user scope) claude mcp add opsera -s user -e OPSERA_TOKEN=YOUR_TOKEN_HERE -- curl -X POST http://opseramcp-dev.agent.opsera.dev/mcp

Manual Configuration (settings.json)

{ "mcpServers": { "opsera": { "type": "streamable-http", "url": "http://opseramcp-dev.agent.opsera.dev/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" } } } }

Useful Commands

# List all configured servers claude mcp list # Remove a server claude mcp remove opsera # Test server connection claude mcp get opsera

3 Claude Desktop

Configure Opsera MCP Server for Claude Desktop application.

Configuration File Locations

PlatformConfiguration Path
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
Linux~/.config/Claude/claude_desktop_config.json

How to Access Settings

  1. Open Claude Desktop
  2. Go to Claude → Settings → Developers → Edit Config
  3. Add the configuration below and save
  1. Open Claude Desktop
  2. Go to File → Settings → Developers → Edit Config
  3. Or press Win + R, type %APPDATA%\Claude, press Enter
  4. Open claude_desktop_config.json with a text editor

Configuration

{ "mcpServers": { "opsera": { "type": "streamable-http", "url": "http://opseramcp-dev.agent.opsera.dev/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" } } } }
Important: Save the file and restart Claude Desktop for changes to take effect.

4 VS Code

Configure Opsera MCP Server for Visual Studio Code with GitHub Copilot.

Prerequisites

Configuration File Locations

PlatformWorkspace ConfigUser Settings
macOS.vscode/mcp.json~/Library/Application Support/Code/User/settings.json
Windows.vscode/mcp.json%APPDATA%\Code\User\settings.json
Linux.vscode/mcp.json~/.config/Code/User/settings.json

Method 1: Workspace Configuration (.vscode/mcp.json)

{ "servers": { "opsera": { "type": "http", "url": "http://opseramcp-dev.agent.opsera.dev/mcp", "headers": { "Authorization": "Bearer ${input:opseraToken}" } } }, "inputs": [ { "id": "opseraToken", "type": "promptString", "description": "Enter your Opsera API token", "password": true } ] }

Method 2: User Settings (settings.json)

{ "mcp": { "servers": { "opsera": { "type": "http", "url": "http://opseramcp-dev.agent.opsera.dev/mcp", "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" } } } } }

Method 3: Command Palette

  1. Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux)
  2. Run MCP: Add Server
  3. Select HTTP transport type
  4. Enter URL: http://opseramcp-dev.agent.opsera.dev/mcp

Recommended Settings

{ "chat.mcp.autostart": true, "chat.mcp.gallery.enabled": true, "chat.mcp.discovery.enabled": true }

5 Cursor IDE

Configure Opsera MCP Server for Cursor IDE.

Configuration File Locations

ScopemacOS/LinuxWindows
Global~/.cursor/mcp.json%USERPROFILE%\.cursor\mcp.json
Project.cursor/mcp.json.cursor/mcp.json

Enable MCP in Cursor

  1. Open Settings → Cursor Settings
  2. Find MCP servers option
  3. Enable it

Configuration

{ "mcpServers": { "opsera": { "url": "http://opseramcp-dev.agent.opsera.dev/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_TOKEN_HERE" } } } }
Note: Cursor supports a maximum of 40 tools active simultaneously. Only tools are supported (resources not yet available).

6 Troubleshooting

Common Issues

IssueSolution
Server not starting Check that your token is valid. Try regenerating from dashboard.
Authentication failed Ensure the Authorization header includes "Bearer " prefix before your token.
Server not appearing Restart your MCP client after saving configuration changes.
JSON syntax errors Validate your JSON at jsonlint.com
Path issues on Windows Use double backslashes (\\) or forward slashes (/) in JSON paths.

Validate Your Configuration

cat ~/.cursor/mcp.json | python3 -m json.tool
type %USERPROFILE%\.cursor\mcp.json | python -m json.tool

Test Connection

curl -X POST http://opseramcp-dev.agent.opsera.dev/mcp \ -H "Authorization: Bearer YOUR_TOKEN_HERE" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Need Help?

Contact support@opsera.io for assistance.

Available Tools

Once connected, you'll have access to these AI-powered DevOps tools:

opsera_cicd_deploy

Deploy containers to AWS EKS with GitOps, Terraform, ArgoCD

opsera_security_scan

Security audits with SOC2, HIPAA, PCI-DSS compliance mapping

opsera_dora_metrics

Calculate DORA metrics from git history with recommendations

opsera_databricks_pipeline_deploy

Deploy Databricks pipelines and manage Lakeflow jobs

opsera_sfdc_analyze

Analyze Salesforce metadata and generate package.xml

opsera_github_insights

GitHub repository analytics and code quality insights

Request Access Go to Dashboard