# Getting Started

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

{% hint style="info" %}
**Claude Web or Desktop?** Use the [Claude Connector](https://docs.airops.com/mcp/claude-connector) for one-click setup and Interactive Apps.
{% endhint %}

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

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

## Claude Code

Run in your terminal:

```bash
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:

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

3. Click **Connect** to authenticate

## VS Code (Copilot)

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

```json
{
  "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:

```json
{
  "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:

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

## Troubleshooting

### Authentication

<details>

<summary>"Needs authentication" error</summary>

**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.

</details>

<details>

<summary>OAuth not working (WSL/corporate network)</summary>

**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`.

</details>

### Connection

<details>

<summary>Connection refused or timeout</summary>

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

</details>

<details>

<summary>Tools not appearing</summary>

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

</details>

### Clear Cached Authentication

Remove the server and add it again:

**Claude Code:**

```bash
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](https://docs.airops.com/mcp/use-cases) — Reporting and optimization examples
* [Tools Reference](https://docs.airops.com/mcp/tools) — All available tools
* [FAQ](https://docs.airops.com/mcp/faq) — Common questions