SuperOps.ai MCP服务器V2🚀
SuperOps.ai和您最喜欢的ai之间的官方非官方桥梁。
开源 模型上下文协议（MCP） 服务器，使AI代理（如Claude、Gemini、ChatGPT）能够直接与您的 SuperOps.ai MSP平台。
现在特色 完整写入功能--把谈话变成行动。
______________________________________________________________________
🎯 为何这很重要
问题： 管理MSP意味着上下文切换。您不断在票证、客户文档和资产之间切换，手动关联数据。
解决方案： 一 自治代理 它和你一起工作。
- *不要单击：* “为Acme创建票证。”
- *只需说：* “加入Acme公司，为他们的打印机问题创建高优先级的工单。”
没有点击。没有搜索。只是行动。
______________________________________________________________________
✨ 主要功能（V2）
🛠️ 核心能力
- 📝 完全写入权限： 创建和更新工单、客户、联系人和任务。
- ⏱️ 智能时间跟踪： 直接从聊天记录工作日志(
add_ticket_worklog). - 🏢 即时入职： 一次性客户端创建(
create_client)自动处理复杂的总部站点逻辑。 - 🎫 票务管理： 无需离开AI界面即可回复、添加注释和更新状态。
🛡️ 企业级
- 🔒 隐私第一： 运行100%本地-您的API密钥永远不会离开您的机器。
- 🧩 可扩展架构： 采用Zod验证的模块化设计，实现稳健的类型安全。
- 🔍 自我修复： 动态模式自省(
fetch_schema)允许AI适应API的变化。
______________________________________________________________________
🚀 快速开始
1.先决条件
- Node.js v18+ 安装。
- Git 安装。
- MCP兼容客户端（例如，Claude Desktop、Gemini CLI）。
2.安装
# Clone the repository
git clone https://github.com/Sborgi/superops-mcp.git
cd superops-mcp
# Install dependencies
npm install
# Build the server
npm run build3.配置
将服务器添加到MCP配置文件中（例如。， claude_desktop_config.json 或 gemini_config.json).
Windows示例：
{
"mcpServers": {
"superops": {
"command": "node",
"args": ["C:\\Users\\YOUR_USERNAME\\superops-mcp\\dist\\index.js"],
"env": {
"SUPEROPS_API_KEY": "YOUR_API_TOKEN",
"SUPEROPS_SUBDOMAIN": "your-subdomain"
}
}
}
}注： 替换C:\Users\YOUR_USERNAME你的实际路径。使用双反睫毛\\在Windows上。
______________________________________________________________________
💡 用法示例
🆕 客户入职培训
“创建一个位于纽约的新客户‘Stark Industries’，并添加‘Tony Stark’作为主要联系人。”
🎫 票务工作流程
“总结1024号工单，然后回复客户说我们正在调查。此外，记录15分钟的‘初步分类’工作。”
🔍 深度分析
“列出今天创建的所有高优先级票证，并确定是否有属于VIP客户的票证。”
______________________________________________________________________
🐛 故障排除
常见问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 401未经授权 | 无效的API密钥 | 在SuperOps设置中重新生成令牌→ API令牌。 |
| 404域名未找到 | 错误的子域 | 仅使用 acme，不 acme.superops.ai. |
| 未找到字段“xyz” | API架构更改 | 要求AI运行 fetch_schema 以更新其知识。 |
| 变量“$input”无效 | 缺少字段 | 检查服务器日志。V2现在记录特定的验证错误。 |
验证脚本
想要在没有人工智能的情况下测试连接性吗？运行附带的集成测试：
# Windows (PowerShell)
$env:SUPEROPS_API_KEY="your_key"
$env:SUPEROPS_SUBDOMAIN="your_subdomain"
npx tsx src/tests/integration.ts______________________________________________________________________
📜 更新日志
v2.0.0（“Action”版本）
- 新 完整写入功能（票、客户端、任务、工作日志）。
- 新 Zod输入验证，用于稳健的错误处理。
- 新 集成测试套件。
- 改进： 错误日志现在可以清理敏感数据。
- 改变： 解耦Pax8集成（现在是一个单独的模块）。
v1.0.0
- 初始版本（只读）。
______________________________________________________________________
🤝 贡献
欢迎投稿！请打开问题或提交PR。
- 分叉回购。
- 创建分支(
git checkout -b feature/cool-thing). - 承诺并推动。
- 打开PR。
______________________________________________________________________
📄 许可证
MIT许可证-请参阅 许可证 了解详情。
______________________________________________________________________
建于❤️ 通过 萨贝尔·博吉\ *解决方案工程师和人工智能自动化爱好者*
⭐ 觉得这个有用吗？将回购标上星号，以帮助其他人发现它！