AI导哈

Atera帮助台管理服务器

一个包装Atera REST API v3的模型上下文协议（MCP）服务器，允许AI助手管理Atera帮助台、客户、代理、警报等。

  • by Deklan-van-de-Laarschot
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 Deklan-van-de-Laarschot/Atera-MCP

使用说明

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 <repo-url>
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 tools

API 参考

此服务器实现 开放API v3。身份验证是通过 X-API-KEY 使用中提供的密钥 ATERA_API_KEY 环境变量。

所有列表端点都支持分页 page （默认值1）和 itemsInPage （默认20个，最大50个）参数。

许可证

麻省理工学院

相关 MCP