---
title: Quick Start
description: Get mcnanovna running in 5 minutes
---

import { Steps, Tabs, TabItem, Aside } from '@astrojs/starlight/components';

## Prerequisites

- An MCP client (Claude Code, Cursor, Zed, or any MCP-compatible app)
- NanoVNA-H connected via USB
- Python 3.11+ (handled automatically by uvx)

## Installation

<Steps>
1. **Add the MCP server to your client**

   For Claude Code:
   ```bash
   claude mcp add mcnanovna -- uvx mcnanovna
   ```

   For other clients, configure `uvx mcnanovna` as an MCP server per your client's documentation.

2. **Start a new session**

3. **Ask your assistant to use your VNA**

   Try these prompts:
   - "Scan my antenna from 144 to 148 MHz"
   - "What's the SWR at 145 MHz?"
   - "Analyze this filter's frequency response"
   - "Capture a screenshot of the VNA display"

</Steps>

<Aside type="tip">
The VNA auto-connects on first tool call. No configuration needed if using default USB settings.
</Aside>

## Verify Connection

Try: *"Get VNA info"*

You should see device details like firmware version, serial number, and frequency range.

## Next Steps

- [Install mcpositioner](/mcpositioner/overview/) for automated antenna measurements
- [Run a calibration](/tutorials/calibration/) for accurate measurements
- [Explore all 78 tools](/mcnanovna/tools/)

## Troubleshooting

### VNA not detected

1. Check USB connection
2. Verify device appears as `/dev/ttyACM0` (Linux) or COM port (Windows)
3. Check permissions: `sudo usermod -aG dialout $USER` (Linux)

### Permission denied

On Linux, add your user to the dialout group:

```bash
sudo usermod -aG dialout $USER
# Log out and back in for changes to take effect
```