Как подключить Atera к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Atera, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Atera + Gemini

RMM и служба поддержки Atera: клиенты, контакты, отслеживаемые агенты с оборудованием и патчами, безагентные устройства, оповещения, тикеты с комментариями и рабочим временем, договоры и база знаний. Atera REST API v3 с API-токеном.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

ATERA_API_KEY

Шаг 1 — Получите учётные данные

1. В Atera откройте Admin → Data management → API. Эту страницу видят только администраторы Atera.
2. Нажмите New token и выберите срок действия (не больше года), IP-адреса, которым разрешено использовать токен (оставьте Allow all или добавьте исходящий адрес вашего сервера AnythingMCP), и права: Full access или Custom access с Read на разделах, которые должен видеть ИИ, плюс Write на Tickets и Alerts, если вам нужны инструменты записи.
3. Сразу скопируйте токен в ATERA_API_KEY: Atera показывает его только один раз. Коннектор отправляет его как Bearer-токен.
4. Установите коннектор и запустите atera_list_customers. Он выводит ваших клиентов с CustomerID, который нужен большинству остальных инструментов.

Токен, а не устаревший ключ: в старых аккаунтах ещё может быть статический API-ключ (короткий ключ, который не начинается с eyJ). Atera заменяет такие ключи токенами, а этот коннектор отправляет только форму Bearer, поэтому создайте новый токен.

Срок действия токена: токен действует не больше года. Atera уведомляет администраторов за 7 дней и за 1 день до окончания срока; после этого создайте новый токен и вставьте его в ATERA_API_KEY.

Кто что видит: с Full access токен получает права всего аккаунта Atera, поэтому любой, кто пользуется этим коннектором, может читать всех клиентов, все устройства и тикеты. Custom access ограничивает ИИ разделами, которые вы разрешили.

Что он читает: клиентов и их контакты, отслеживаемые агенты с полной инвентаризацией оборудования и установленными или недостающими патчами, безагентные устройства (ping, SNMP, HTTP, TCP), оповещения, тикеты с комментариями, рабочим и оплачиваемым временем, договоры и базу знаний. Удобно начинать с atera_list_tickets, atera_list_customer_agents и atera_list_alerts со статусом Open.

Сначала подтверждение: ИИ может создавать и обновлять тикеты (atera_create_ticket, atera_update_ticket), добавлять комментарии (atera_add_technician_comment, atera_add_enduser_comment) и закрывать оповещения (atera_resolve_alert). Комментарий техника, который не помечен как внутренний, уходит конечному пользователю по почте, поэтому ИИ показывает вам текст перед публикацией. Названия статусов тикетов в Atera задаются свободным текстом, поэтому ИИ берёт их из существующих тикетов.

Ограничения: Atera допускает около 700 запросов в минуту на аккаунт. Списки приходят страницами не больше 50 записей, поэтому в больших аккаунтах ИИ фильтрует по клиенту или статусу и для недавних изменений использует atera_list_modified_tickets, а не листает все тикеты.

Удаление клиентов, контактов, агентов и тикетов не предусмотрено, а патчи только перечисляются, но не устанавливаются.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Atera.

Доступные инструменты

Примеры запросов

• «Какие критические оповещения сейчас всё ещё открыты и на компьютерах каких клиентов?»
• «Покажи открытые тикеты клиента Northwind с ответственным техником и сроком по SLA.»
• «Сколько оплачиваемых часов мы записали на тикеты, закрытые в прошлом месяце, по каждому клиенту?»
• «Подготовь ответ конечному пользователю по тикету 1234 и покажи его мне перед публикацией.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT