Atera MCP服务器
模型上下文协议（MCP）服务器，包装完整的Atera REST API v3，允许Claude等人工智能助手管理您的Atera服务台、客户、代理、警报等。
特性
54个MCP工具，涵盖整个Atera API：
| 域 | 工具 | 操作 |
|---|---|---|
| 门票 | 4 | 列表、获取、创建、删除 |
| 客户 | 5 | 列表、获取、创建、更新、删除 |
| 联系人 | 5 | 列表、获取、创建、更新、删除 |
| 代理 | 4 | 列表、获取、按客户获取、删除 |
| 警报 | 5 | 列表、获取、创建、解析、删除 |
| 合同 | 5 | 列出、获取、按客户列出、创建、更新 |
| 计费 | 2 | 列出发票，获取发票 |
| 知识库 | 1 | 列出文章 |
| 部门 | 5 | 列表、获取、创建、更新、删除 |
| 产品 | 5 | 列表、获取、创建、更新、删除 |
| 费用 | 5 | 列表、获取、创建、更新、删除 |
| 自定义值 | 8 | 获取字段定义，获取/设置门票、客户、联系人 |
先决条件
- Node.js 18+
- 具有API访问权限的Atera帐户
- 您的Atera API密钥（位于 管理>面向客户>API)
安装
git clone
cd AteraMCP
npm install
npm run build配置
克劳德代码
增添 ~/.claude/settings.json:
{
"mcpServers": {
"atera": {
"command": "node",
"args": ["/path/to/AteraMCP/dist/index.js"],
"env": {
"ATERA_API_KEY": "your-api-key-here"
}
}
}
}克劳德桌面版
添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：
{
"mcpServers": {
"atera": {
"command": "node",
"args": ["/path/to/AteraMCP/dist/index.js"],
"env": {
"ATERA_API_KEY": "your-api-key-here"
}
}
}
}发展
直接使用TypeScript运行服务器（无构建步骤）：
ATERA_API_KEY=your-key npm run dev生产建设：
npm run build
npm start用法示例
连接后，您可以问Claude以下问题：
- “给我看所有未结的票”
- “为Acme公司的约翰创建一张关于打印机问题的工单”
- “列出客户42的所有代理”
- “解决警报123”
- “我们有什么客户？”
- “更新客户5的电话号码”
- “显示所有打开的警报”
- “列出知识库文章”
项目结构
src/
├── index.ts # Entry point — MCP server + stdio transport
├── client.ts # Atera API client (auth, HTTP methods, error handling)
├── types.ts # TypeScript interfaces for Atera DTOs
└── tools/
├── tickets.ts # Ticket management tools
├── customers.ts # Customer management tools
├── contacts.ts # Contact management tools
├── agents.ts # Agent management tools
├── alerts.ts # Alert management tools
├── contracts.ts # Contract management tools
├── billing.ts # Invoice/billing tools
├── knowledgebase.ts # Knowledge base tools
├── departments.ts # Department management tools
├── products.ts # Product management tools
├── expenses.ts # Expense management tools
└── custom-values.ts # Custom field value toolsAPI 参考
此服务器实现 开放API v3。身份验证是通过 X-API-KEY 使用中提供的密钥 ATERA_API_KEY 环境变量。
所有列表端点都支持分页 page （默认值1）和 itemsInPage （默认20个，最大50个）参数。
许可证
麻省理工学院