Getting Started

Connect AI coding assistants to your AirOps workspace using MCP

The AirOps MCP server provides a standardized interface that allows any compatible AI assistant to access your AirOps workspace data. Your assistant can retrieve Brand Kit information, find content opportunities, access competitor data, and pull insights without leaving your development environment.

Authentication uses OAuth 2.0. You sign in with your AirOps account through your browser. No tokens to copy or manage.

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

Setup

Claude Desktop

1. Open Settings → Developer → Edit Config

2. Add the server configuration:

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

1. Restart Claude Desktop

2. Complete the OAuth flow when prompted

Claude Code

Run in your terminal:

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

Then run /mcp in Claude Code, select the server, and choose Authenticate to complete sign-in.

Cursor

1. Open Cursor Settings → Tools & MCP → New MCP server

2. Add the configuration:

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

1. Click the Connect button that appears to authenticate

VS Code (Copilot)

1. Open Settings (Ctrl/Cmd + ,)

2. Search for "mcp" and click Edit in settings.json

3. Add the server:

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

Windsurf

1. Open Windsurf Settings → Cascade → Model Context Protocol (MCP) Servers

2. Click Add Server → Add custom server

3. Add the configuration:

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

Other Clients

Most MCP clients support HTTP transport. Use these settings:

• Transport: HTTP (sometimes called "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 Issues

The server shows "needs authentication"

Run /mcp in Claude Code and select Authenticate, or click Connect in Cursor. If authentication keeps failing, try removing and re-adding the server.

How do I clear cached authentication?

Remove the server from your client configuration and add it again. This clears any stored OAuth tokens.

Connection Issues

Connection refused or timeout

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

Tools not appearing after setup

Restart your AI assistant after adding the server. In Claude Code, run /mcp to verify connection status.

Platform-Specific Issues

WSL users

Browser-based OAuth may not work directly from WSL. Try running your MCP client from Windows instead, or use the Internal MCP Servers with token authentication.

Next Steps

• Tools & Skills — Explore available tools for accessing your workspace data

• Usage Examples — See how to query your data with natural language prompts