摘要
Atera RMM 与服务台：客户、联系人、带硬件和补丁信息的受监控代理、无代理设备、警报、含评论和工时的工单、合同和知识库。通过 API 令牌使用 Atera REST API v3。
引导式设置
2 分钟将 Atera 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 Atera，再把你的 MCP URL 添加到 Microsoft Copilot。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Atera 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Atera、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
Atera + Microsoft Copilot
Atera RMM 与服务台：客户、联系人、带硬件和补丁信息的受监控代理、无代理设备、警报、含评论和工时的工单、合同和知识库。通过 API 令牌使用 Atera REST API v3。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
ATERA_API_KEY
步骤 1 — 获取凭证
- 在 Atera 中打开 Admin → Data management → API。只有 Atera 管理员能看到这个页面。
- 点击 New token，选择过期日期（最长一年）、允许使用该令牌的 IP 地址（保留 Allow all，或添加你的 AnythingMCP 服务器的出站地址）以及权限：Full access，或 Custom access 并对 AI 需要查看的领域授予 Read；如果要使用写入工具，再对 Tickets 和 Alerts 授予 Write。
- 立即把令牌复制到
ATERA_API_KEY：Atera 只显示一次。连接器以 Bearer 令牌的形式发送它。 - 安装连接器并运行
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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（
https://cloud.anythingmcp.com/mcp/…）。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器：把 AnythingMCP 作为工具添加到智能体，然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接，AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体（或新建一个），进入 Tools，选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name（例如
AnythingMCP）、说明连接器用途的 Server description，以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key，把 Type 设为 Header，请求头名称填
X-API-Key，然后选择 Create。 - 在 Add tool 中选择 Create a new connection，粘贴 AnythingMCP 的 MCP API 密钥（MCP Servers → 你的服务器 → API keys），然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试：提出需要用到
Atera的工具的请求。 - 选择 Publish，然后进入 Channels → Microsoft 365 and Microsoft Teams，保持勾选 Make agent available in Microsoft Copilot，再选择 Add channel。See agent in Teams 会为你安装该智能体；在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录？请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥：每个用户会在智能体首次调用时登录 AnythingMCP。
自托管？请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接，因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
atera_list_customers | List the customers (client companies) in Atera with id, name, domain, address and phone |
atera_get_customer | Get one customer by CustomerID: name, business number, domain, address, phone, notes and links |
atera_list_contacts | List end-user contacts with EndUserID, customer, name, email, phone, job title and department |
atera_get_contact | Get one contact by EndUserID: customer, name, email, phones, job title, department and whether it is the customer's main contact person |
atera_list_agents | List all monitored devices (agents) across customers: machine name, customer, online state, last seen, OS, IP and MAC addresses, hardware… |
atera_list_customer_agents | List the agents (monitored devices) of one customer with online state, OS, hardware and last-seen time |
atera_get_agent | Get one agent by AgentID with full hardware and OS inventory: processor, memory, disks, BIOS, serial number, Office version, last reboot… |
atera_find_agents_by_machine | Find agents by machine (computer) name, for example DESKTOP-4F2K |
atera_list_installed_patches | List the patches (Windows updates) installed on one agent, identified by its DeviceGuid |
atera_list_available_patches | List the patches available but not yet installed on one agent, identified by its DeviceGuid |
atera_list_devices | List agentless monitored devices of one type (generic ping, SNMP, HTTP or TCP) with name, DeviceID, customer and monitoring agent |
atera_get_device | Get one agentless monitored device (generic, SNMP, HTTP or TCP) by DeviceID with its monitoring settings, customer and monitoring agent |
atera_list_alerts | List monitoring alerts with title, severity (Information, Warning, Critical), device, customer, creation time and linked ticket |
atera_get_alert | Get one alert by AlertID: title, message, severity, category, thresholds, device, customer, snooze end date and linked ticket |
atera_resolve_alert | Mark one open alert as resolved |
atera_list_tickets | List help desk tickets with number, title, status, priority, type, customer, end user, technician, SLA dates and durations |
atera_get_ticket | Get one ticket by TicketID with status, priority, impact, type, customer, end user, technician, first and last comments, SLA due dates and… |
atera_list_modified_tickets | List tickets modified since a date (UTC), optionally with their last comments |
atera_list_closed_tickets | List tickets whose status changed to resolved or closed, with their comments by default |
atera_list_ticket_comments | List the comments of one ticket in order: text, date, author (end user or technician, with email and name) and whether the comment is… |
atera_list_ticket_work_hours | List the work-hour records logged on one ticket: technician, start and end time, duration, billable flag and on-site or remote |
atera_get_ticket_billable_duration | Get the billable time totals of one ticket (on-site and off-site) as Atera computes them for invoicing |
atera_list_contracts | List customer contracts with type (retainer, hourly, block hours, block money, remote monitoring, project), active and default flags and… |
atera_list_customer_contracts | List the contracts of one customer with type, rates, active flag and dates |
atera_get_contract | Get one contract by ContractID with its type-specific details (hourly rates, block hours, retainer fee, monitored device rates) and dates |
atera_list_knowledge_base | List the knowledge base articles in Atera with title, content, keywords and visibility |
atera_create_ticket | Create a help desk ticket |
atera_update_ticket | Update a ticket's title, status, type, priority, impact or assigned technician |
atera_add_technician_comment | Add a technician comment to a ticket |
atera_add_enduser_comment | Add a comment to a ticket on behalf of the end-user contact, for example to log a reply that arrived by phone |
示例提示
- “现在还有哪些严重警报未解决？分别出现在哪些客户的机器上？”
- “显示客户 Northwind 的未关闭工单，以及负责的技术员和 SLA 截止时间。”
- “上个月关闭的工单中，我们记录了多少可计费工时？请按客户汇总。”
- “为工单 1234 起草一封给最终用户的回复，发布前先给我看。”
FAQ
这适用于哪个 Copilot？ 适用于工作中的 Microsoft 365 Copilot，通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么？ 一个可以使用 Copilot Studio 的工作账户（许可证或试用版），用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限：把它共享给他们，或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略，这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key，密钥是否属于与 URL 相同的 MCP 服务器，并把 Server description 写得具体：Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体；在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?