Atomicwork MCP服务器
集成了模型上下文协议（MCP）的服务器 原子工作 Claude Desktop和其他MCP客户端。这允许像Claude这样的人工智能助手直接与您的Atomicwork工单、请求和工作流进行交互。
什么是Atomicwork？
Atomicwork是一个企业服务管理平台，可帮助IT团队管理工单、请求、更改和事件。此MCP服务器将该功能引入您的AI工作流程。
特性
- 📋 列出门票 -查看分配给您的所有门票
- 🔍 搜索门票 -按关键字或条件查找门票
- 📊 获取门票详细信息 -检索任何门票的完整信息
- 🌐 工作区访问 -列出工作区中的所有请求
需求
- Node.js 18.0或更高
- Atomicwork帐户 具有API访问权限
- Claude桌面版 或另一个MCP兼容客户端
安装
选项1：从源代码克隆和构建```bash
Clone the repository
git clone https://github.com/keller-a16z/public-atomicwork-mcp.git
cd public-atomicwork-mcp
Install dependencies
npm install # or: bun install
Build the project
npm run build # or: bun run build
## 配置
### 步骤1：获取Atomicwork API密钥
1. 登录您的Atomicwork实例
1. 导航至 **设置→ API** （通常在 `https://your-company.atomicwork.com/settings/api`)
1. 生成新的API密钥
1. 复制密钥-您需要它进行配置
### 步骤2：查找您的用户ID和工作区ID
**查找您的用户名：**
1. 打开浏览器的开发者工具（F12）
1. 转到“网络”选项卡
1. 导航到Atomicwork中的任何页面
1. 查找API请求 `/api/v1/users/me` 或类似
1. 您的用户ID将出现在响应中（通常是一个类似以下的数字 `113542`)
**查找您的工作区ID:**
1. 在同一网络选项卡中
1. 查找API请求 `/api/v1/workspaces/`
1. 您的工作区ID将在URL中（通常是一个类似以下的数字 `730`)
### 步骤3：配置Claude桌面
将MCP服务器添加到Claude Desktop配置文件中：
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**视窗**: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"atomicwork": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/public-atomicwork-mcp/dist/index.js"
],
"env": {
"ATOMICWORK_API_KEY": "your_api_key_here",
"ATOMICWORK_BASE_URL": "https://your-company.atomicwork.com/api/v1",
"ATOMICWORK_USER_ID": "your_user_id",
"ATOMICWORK_WORKSPACE_ID": "your_workspace_id"
}
}
}
}
替换：
/ABSOLUTE/PATH/TO/public-atomicwork-mcp/dist/index.js具有指向内置服务器的实际路径your_api_key_here使用您的Atomicwork API密钥your-company使用Atomicwork实例子域your_user_id使用您的用户IDyour_workspace_id使用您的工作区ID
步骤4:重新启动克劳德桌面
关闭并重新打开Claude Desktop以加载新的MCP服务器。
用法
配置后，您可以在Claude Desktop中通过自然语言与Atomicwork交互：
查询示例
列出您的门票：```
Show me my current Atomicwork tickets
**获取门票详细信息：**```
Get details for Atomicwork ticket ITREQ-1234
搜索门票：```
Search for tickets about "password reset"
**列出所有工作区请求：**```
Show me all open requests in the workspace
可用工具
list_my_tickets
列出分配给您的所有门票。
参数：
status（可选）：按状态筛选(open,in_progress,resolved,closed)limit（可选）：返回的最大票数（默认值：50）
例子：```
List my in-progress tickets
### `get_ticket_details`
获取特定票证的详细信息。
**参数：**
- `ticket_id` （必填）：票的ID
**例子：**```
Show me ticket ITREQ-2522
search_tickets
按关键字搜索门票。
参数：
query（必填）：搜索查询字符串assigned_to_me（可选）：仅显示分配给您的门票（默认值：true）
例子：```
Find tickets mentioning "GitHub"
### `list_all_requests`
列出工作区中的所有请求（不仅仅是您的请求）。
**参数：**
- `status` （可选）：按状态筛选
- `limit` （可选）：最大请求数（默认值：50）
**例子：**```
Show all open requests in the workspace
故障排除
MCP服务器未出现
- 检查配置文件路径 -确保编辑正确
claude_desktop_config.json - 验证dist路径 -确保路径
dist/index.js绝对正确 - 重新启动克劳德桌面 -更改需要完全重新启动
- 检查日志 -在Claude Desktop的日志中查找错误
API连接错误
“无法连接到Atomicwork”
- 验证您的API密钥是否正确
- 检查您的基本URL是否与Atomicwork实例匹配
- 确保您对Atomicwork实例具有网络访问权限
- 尝试访问
https://your-company.atomicwork.com/api/v1/users/me在浏览器中使用API键
“访问令牌X-Api-Key丢失/无效”
- 在配置中双击API键
- 确保API密钥未过期
- 尝试在Atomicwork中重新生成一个新的API密钥
没有退票
“错误：未设置ATOMICWORK_USER_ID”
- 确保您已将用户ID添加到配置中
- 验证用户ID是否正确（它应该是一个数字）
“错误：未设置ATOMICWORK_WORKSPACE_ID”
- 将您的工作区ID添加到配置中
- 验证工作区ID是否正确（它应该是一个数字）
构建错误
如果您从源代码构建并遇到错误：```bash
Clean and rebuild
rm -rf node_modules dist
npm install # or: bun install
npm run build # or: bun run build
## 发展
### 本地运行```bash
# Install dependencies
bun install
# Build the project
bun run build
# Test the MCP server
node dist/index.js
项目结构```
public-atomicwork-mcp/
├── src/
│ └── index.ts # Main MCP server implementation
├── dist/ # Compiled JavaScript output
├── package.json # Project dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── .env.example # Environment variable template
├── .gitignore # Git ignore rules
└── README.md # This file
```
安全
- 永远不要提交API密钥 -使用环境变量
- 确保API密钥的安全 -不要公开分享
- 重新生成泄露的密钥 -如果您的密钥已暴露，请立即在Atomicwork中重新生成它
贡献
欢迎投稿！请随时提交拉取请求。
许可证
MIT许可证-有关详细信息，请参阅许可证文件
链接
- 原子工作
- Atomicwork API文档
- 模型上下文协议
- Claude桌面版
支持
对于问题和疑问：
- 错误报告: GitHub 问题
- 讨论: GitHub讨论
致谢
灵感源自于 点击MCP服务器 作者taazkareem。
