Atera MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Atera klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Atera + Microsoft Copilot

Atera RMM und Helpdesk: Kunden, Kontakte, überwachte Agents mit Hardware und Patches, agentenlose Geräte, Alerts, Tickets mit Kommentaren und Arbeitszeiten, Verträge und Knowledge Base. Atera REST API v3 mit einem API-Token.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

ATERA_API_KEY

Schritt 1 — Zugangsdaten holen

1. Öffne in Atera Admin → Data management → API. Diese Seite sehen nur Atera-Admins.
2. Klicke auf New token und wähle ein Ablaufdatum (höchstens ein Jahr), die IP-Adressen, die das Token nutzen dürfen (Allow all beibehalten oder die ausgehende Adresse deines AnythingMCP-Servers eintragen), und die Berechtigungen: Full access oder Custom access mit Read auf den Bereichen, die die KI sehen soll, plus Write auf Tickets und Alerts, wenn du die schreibenden Tools nutzen willst.
3. Kopiere das Token sofort in ATERA_API_KEY: Atera zeigt es nur ein einziges Mal an. Der Connector sendet es als Bearer-Token.
4. Installiere den Connector und führe atera_list_customers aus. Das Tool listet deine Kundenfirmen mit der CustomerID auf, die die meisten anderen Tools brauchen.

Token statt Legacy-Key: Ältere Konten haben eventuell noch einen statischen API-Key (ein kurzer Key, der nicht mit eyJ beginnt). Atera ersetzt diese Keys durch Tokens, und der Connector sendet nur die Bearer-Form. Erstelle also ein neues Token.

Ablauf des Tokens: Ein Token gilt höchstens ein Jahr. Atera benachrichtigt Admins 7 Tage und 1 Tag vor dem Ablauf; erstelle dann ein neues Token und füge es in ATERA_API_KEY ein.

Wer was sieht: Mit Full access hat das Token die Rechte des gesamten Atera-Kontos. Jeder, der diesen Connector nutzt, kann also alle Kunden, Geräte und Tickets lesen. Custom access beschränkt die KI auf die Bereiche, die du freigibst.

Was sie liest: Kunden und ihre Kontakte, überwachte Agents mit vollständigem Hardware-Inventar und installierten oder fehlenden Patches, agentenlose Geräte (Ping, SNMP, HTTP, TCP), Alerts, Tickets mit Kommentaren, Arbeitszeiten und abrechenbarer Zeit, Verträge und die Knowledge Base. Gute Einstiegspunkte sind atera_list_tickets, atera_list_customer_agents und atera_list_alerts mit dem Status Open.

Erst bestätigen: Die KI kann Tickets anlegen und ändern (atera_create_ticket, atera_update_ticket), Kommentare hinzufügen (atera_add_technician_comment, atera_add_enduser_comment) und Alerts auflösen (atera_resolve_alert). Ein Techniker-Kommentar, der nicht intern ist, geht per E-Mail an den Endbenutzer, deshalb zeigt dir die KI den Text, bevor sie ihn postet. Ticket-Status sind in Atera freier Text, die KI liest sie daher aus bestehenden Tickets.

Limits: Atera erlaubt etwa 700 Anfragen pro Minute und Konto. Listen kommen in Seiten mit höchstens 50 Einträgen. Bei großen Konten filtert die KI deshalb nach Kunde oder Status und nutzt atera_list_modified_tickets für aktuelle Änderungen, statt alle Tickets durchzublättern.

Kunden, Kontakte, Agents oder Tickets löschen ist nicht vorgesehen, und Patches werden nur aufgelistet, nicht installiert.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Atera-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Welche kritischen Alerts sind gerade noch offen, und auf den Rechnern welcher Kunden?“
• „Zeig mir die offenen Tickets des Kunden Northwind mit Techniker und SLA-Fälligkeit.“
• „Wie viele abrechenbare Stunden haben wir auf Tickets erfasst, die letzten Monat geschlossen wurden, pro Kunde?“
• „Entwirf eine Antwort an den Endbenutzer zu Ticket 1234 und zeig sie mir, bevor du sie postest.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden