Getting Started

Setup instructions for AI assistants using MCP

Connect your AI assistant to AirOps using the MCP server. This guide covers setup for Codex, Claude Code, Cursor, VS Code, Windsurf, and other MCP clients.

Claude Web or Desktop? Use the Claude Connector for one-click setup and Interactive Apps.

Server URL: https://app.airops.com/mcp

Authentication uses OAuth 2.0—sign in with your AirOps account through your browser.

Codex

Use the AirOps MCP plugin for one-click setup in Codex.

Claude Code

Run in your terminal:

claude mcp add --transport http airops https://app.airops.com/mcp

Then authenticate:

1. Run /mcp in Claude Code
2. Select the AirOps server
3. Choose Authenticate
4. Complete sign-in in your browser

Cursor

1. Open Cursor Settings → Tools & MCP → New MCP server
2. Add the configuration:

{
  "mcpServers": {
    "airops": {
      "url": "https://app.airops.com/mcp"
    }
  }
}

1. Click Connect to authenticate

VS Code (Copilot)

1. Open Settings (Ctrl/Cmd + ,)
2. Search for "mcp" and click Edit in settings.json
3. Add:

{
  "mcp": {
    "servers": {
      "airops": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
      }
    }
  }
}

Windsurf

1. Open Windsurf Settings → Cascade → MCP Servers
2. Click Add Server → Add custom server
3. Add:

{
  "mcpServers": {
    "airops": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.airops.com/mcp"]
    }
  }
}

Other Clients

Most MCP clients support HTTP transport:

• Transport: HTTP (streamable HTTP)
• URL: https://app.airops.com/mcp

For clients requiring SSE transport, use mcp-remote as a proxy:

npx -y mcp-remote https://app.airops.com/mcp

Troubleshooting

Authentication

"Needs authentication" error

Claude Code: Run /mcp, select AirOps, choose Authenticate.

Cursor: Click Connect button in MCP settings.

Other clients: Remove and re-add the server to clear cached tokens.

OAuth not working (WSL/corporate network)

WSL users: Browser OAuth may fail from WSL. Run your client from Windows instead.

Corporate networks: Your network may block OAuth redirects. Try a personal network or contact IT to whitelist app.airops.com.

Connection

Connection refused or timeout

Check that you can reach https://app.airops.com in your browser. Some corporate networks block MCP connections.

Tools not appearing

1. Restart your AI assistant
2. Claude Code: Run /mcp to verify connection
3. Remove and re-add the server

Clear Cached Authentication

Remove the server and add it again:

Claude Code:

claude mcp remove airops
claude mcp add --transport http airops https://app.airops.com/mcp

Other clients: Delete the server from your configuration and re-add it.

Next Steps

• Use Cases — Reporting and optimization examples
• Tools Reference — All available tools
• FAQ — Common questions