> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Atera MSP Integration

> Connect ArgentOS to your Atera RMM/PSA platform — tickets, devices, alerts, and reports through natural language.

## Overview

The Atera plugin connects ArgentOS to your [Atera](https://www.atera.com) RMM/PSA platform. Your agent can query tickets, manage devices, monitor alerts, and run reports -- all through natural conversation.

Built for MSPs and IT teams that use Atera as their primary helpdesk and remote management tool.

## Quick Start

<Steps>
  <Step title="Add your Atera API key">
    In **Dashboard > Settings > API Keys** (variable: `ATERA_API_KEY`)
  </Step>

  <Step title="Enable the plugin">
    Add `"atera"` to `plugins.allow` in `~/.argentos/argent.json`
  </Step>

  <Step title="Set your technician name">
    Set `technicianName` in `plugins.entries.atera.config`
  </Step>

  <Step title="Restart the gateway" />

  <Step title="Run setup">
    Ask the agent to run setup -- she'll link your technician ID automatically
  </Step>
</Steps>

## Tools

| Tool              | Description                                                            |
| ----------------- | ---------------------------------------------------------------------- |
| `atera_tickets`   | List and search tickets by status, customer, or assignee               |
| `atera_ticket`    | Get ticket detail or create new tickets                                |
| `atera_devices`   | List devices, filter by customer or online status                      |
| `atera_customers` | List and search customers                                              |
| `atera_alerts`    | View active monitoring alerts by severity                              |
| `atera_report`    | Run reports: my tickets, open tickets, customer summary, device health |
| `atera_setup`     | Self-service technician identity linking                               |

## What You Can Ask

* "Show me my open tickets"
* "Any critical alerts right now?"
* "List offline devices for Acme Corp"
* "Create a high priority ticket for the printer issue at Smith & Co"
* "Give me a customer summary report"
* "How's our device health looking?"

## Agent Context

<Info>
  The plugin injects a live summary into the agent's context before every conversation -- your open ticket count and overall queue status. The agent always knows your current workload without you having to ask.
</Info>

## Requirements

* Atera account with API access
* API key from Atera Admin > API

## Configuration

| Key                   | Description                                  |
| --------------------- | -------------------------------------------- |
| `technicianName`      | Your display name in Atera                   |
| `technicianId`        | Auto-detected by `atera_setup`               |
| `excludedCustomerIds` | Customer IDs to hide (e.g., system accounts) |

## Source

```
~/.argentos/extensions/atera/
  argent.plugin.json
  index.ts
  README.md
```

See [Building Plugins](/tools/building-plugins) for how this extension was built.