如何通过 MCP 将 Atera 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Atera、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Atera + Gemini

Atera RMM 与服务台：客户、联系人、带硬件和补丁信息的受监控代理、无代理设备、警报、含评论和工时的工单、合同和知识库。通过 API 令牌使用 Atera REST API v3。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

ATERA_API_KEY

步骤 1 — 获取凭证

1. 在 Atera 中打开 Admin → Data management → API。只有 Atera 管理员能看到这个页面。
2. 点击 New token，选择过期日期（最长一年）、允许使用该令牌的 IP 地址（保留 Allow all，或添加你的 AnythingMCP 服务器的出站地址）以及权限：Full access，或 Custom access 并对 AI 需要查看的领域授予 Read；如果要使用写入工具，再对 Tickets 和 Alerts 授予 Write。
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 会把 AI 限制在你授权的领域内。

可读取的内容：客户及其联系人，带完整硬件清单和已安装或缺失补丁的受监控代理，无代理设备（ping、SNMP、HTTP、TCP），警报，含评论、工时和可计费时间的工单，合同和知识库。可以从 atera_list_tickets、atera_list_customer_agents 以及状态为 Open 的 atera_list_alerts 开始。

先确认：AI 可以创建和更新工单（atera_create_ticket、atera_update_ticket），添加评论（atera_add_technician_comment、atera_add_enduser_comment）以及解决警报（atera_resolve_alert）。非内部的技术员评论会通过邮件发送给最终用户，因此 AI 会在发布前先给你看内容。Atera 中的工单状态名称是自由文本，所以 AI 会从现有工单中读取。

限制：Atera 允许每个账户每分钟约 700 个请求。列表按每页最多 50 条返回，因此在大型账户中，AI 会按客户或状态筛选，并用 atera_list_modified_tickets 查看最近的变更，而不是翻遍所有工单。

不支持删除客户、联系人、代理或工单，补丁只会列出，不会安装。

步骤 2 — 安装 adapter

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 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 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