vsax mcp服务器
MCP（模型上下文协议）服务器 VSex（共10个） 由Kaseya撰写。使Claude（或任何MCP客户端）能够完全访问VSAX REST API v3。
快速开始
无需安装--使用 npx 直接在MCP客户端配置中：
{
"mcpServers": {
"vsax": {
"command": "npx",
"args": ["-y", "vsax-mcp-server"],
"env": {
"VSAX_SERVER_NAME": "your-server.vsax.net",
"VSAX_TOKEN_ID": "your-token-id",
"VSAX_TOKEN_SECRET": "your-token-secret"
}
}
}
}或全局安装：
npm install -g vsax-mcp-server获取您的API代币
- 登录您的VSAX实例
- 导航至 设置>API令牌
- 创建新令牌-您将收到 令牌ID 和 令牌密钥
- 记下您的服务器主机名（例如。，
mycompany.vsax.net)
有关完整详细信息，请参阅 VSAX API文档.
配置
服务器需要三个环境变量：
| 变量 | 描述 | 示例 |
|---|---|---|
VSAX_SERVER_NAME | 您的VSAX服务器主机名 | mycompany.vsax.net |
VSAX_TOKEN_ID | API令牌ID | abc123 |
VSAX_TOKEN_SECRET | API令牌机密 | secret456 |
克劳德桌面版
添加到您的配置文件中：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vsax": {
"command": "npx",
"args": ["-y", "vsax-mcp-server"],
"env": {
"VSAX_SERVER_NAME": "your-server.vsax.net",
"VSAX_TOKEN_ID": "your-token-id",
"VSAX_TOKEN_SECRET": "your-token-secret"
}
}
}
}克劳德代码
运行：
claude mcp add vsax -e VSAX_SERVER_NAME=your-server.vsax.net -e VSAX_TOKEN_ID=your-token-id -e VSAX_TOKEN_SECRET=your-token-secret -- npx -y vsax-mcp-server从源代码安装
git clone https://github.com/your-org/vsax-mcp-server.git
cd vsax-mcp-server
npm install
npm run build然后在MCP配置中引用本地构建：
{
"mcpServers": {
"vsax": {
"command": "node",
"args": ["/path/to/vsax-mcp-server/dist/index.js"],
"env": {
"VSAX_SERVER_NAME": "your-server.vsax.net",
"VSAX_TOKEN_ID": "your-token-id",
"VSAX_TOKEN_SECRET": "your-token-secret"
}
}
}
}特性
67种工具，涵盖每个VSAX API v3端点：
| 类别 | 工具 | 操作 |
|---|---|---|
| 设备 | 8 | 发布、移动、列表、获取、通知、防病毒、自定义字段、策略 |
| 资产 | 2 | 列出所有，按设备获取 |
| 工作流 | 5 | 运行、执行、列表、获取 |
| 任务 | 7 | 运行、执行状态、设备、脚本、脚本输出、列表、获取 |
| 脚本 | 5 | 运行、执行、列表、获取 |
| 通知 | 4 | 创建、列出、获取、删除 |
| Webhooks | 6 | 创建、更新、重新生成密钥、列表、获取、删除 |
| 组织 | 5 | 创建、更新、列出、获取、自定义字段 |
| 网站 | 5 | 创建、更新、列出、获取、自定义字段 |
| 组 | 6 | 创建、更新、列表、获取、自定义字段、包 |
| 自定义字段 | 6 | 列表、获取、使用、分配、更新、取消分配 |
| 范围 | 3 | 列表、获取、用法 |
| 补丁管理 | 2 | 获取策略、全局规则 |
| 端点保护 | 1 | 获取策略 |
| 环境 | 1 | 获取信息 |
| 审核日志 | 1 | 获取日志 |
用法示例
配置后，您可以向Claude询问以下问题：
- *“列出我的VSAX实例中的所有设备”*
- *“显示设备X的防病毒状态”*
- *“在这3台设备上运行工作流ABC”*
- *“最近执行了哪些脚本？”*
- *“创建一个名为Acme Corp的新组织”*
- *“显示按用户筛选的审核日志admin@company.com"*
OData查询支持
所有列表终结点都支持OData查询参数：
| 参数 | 说明 | 示例 |
|---|---|---|
$top | 要返回的记录数 | 10 |
$skip | 要跳过的记录数 | 20 |
$filter | OData筛选器表达式 | Name eq 'Server01' |
$orderby | 排序表达式 | Name asc |
$count | 包括总计数 | true |
故障排除
服务器无法启动
- 验证是否已设置所有三个环境变量(
VSAX_SERVER_NAME,VSAX_TOKEN_ID,VSAX_TOKEN_SECRET) - 检查是否安装了Node.js 18+：
node --version
身份验证错误（401）
- 确认您的令牌ID和令牌密钥正确
- 确保API令牌在VSAX设置中未过期
- 验证服务器名称是否与您的VSAX实例完全匹配（否
https://前缀，无尾随/)
连接错误
- 检查您的VSAX实例是否可以从您的计算机访问
- 确保HTTPS（端口443）未被防火墙阻止
- 验证服务器主机名是否正确解析：
nslookup your-server.vsax.net
空结果或意外结果
- 尝试使用
$top=5限制结果并验证端点是否有效 - 检查筛选器语法是否匹配 OData约定
- 使用
vsax_get_environment确认API连接
api参考
完整的VSAX API文档：https://api.vsax.net/#introduction
许可证
麻省理工学院