Atomicwork MCP服务器
集成了模型上下文协议（MCP）的服务器 原子工作 Claude Desktop和其他MCP客户端。这允许像Claude这样的人工智能助手直接与您的Atomicwork工单、请求和工作流进行交互。
什么是Atomicwork？
Atomicwork是一个企业服务管理平台，可帮助IT团队管理工单、请求、更改和事件。此MCP服务器将该功能引入您的AI工作流程。
特性
- 📋 列出门票 -查看分配给您的所有门票
- 🔍 搜索门票 -按关键字或条件查找门票
- 📊 获取门票详细信息 -检索任何门票的完整信息
- 🌐 工作区访问 -列出工作区中的所有请求
需求
- Node.js 18.0或更高
- Atomicwork帐户 具有API访问权限
- Claude桌面版 或另一个MCP兼容客户端
安装
选项1：从源代码克隆和构建
# 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密钥
- 登录您的Atomicwork实例
- 导航至 设置→ API （通常在
https://your-company.atomicwork.com/settings/api) - 生成新的API密钥
- 复制密钥-您需要它进行配置
步骤2：查找您的用户ID和工作区ID
查找您的用户名：
- 打开浏览器的开发者工具（F12）
- 转到“网络”选项卡
- 导航到Atomicwork中的任何页面
- 查找API请求
/api/v1/users/me或类似 - 您的用户ID将出现在响应中（通常是一个类似以下的数字
113542)
查找您的工作区ID:
- 在同一网络选项卡中
- 查找API请求
/api/v1/workspaces/ - 您的工作区ID将在URL中（通常是一个类似以下的数字
730)
步骤3：配置Claude桌面
将MCP服务器添加到Claude Desktop配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.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 ticketsget_ticket_details
获取特定票证的详细信息。
参数：
ticket_id（必填）：票的ID
例子：
Show me ticket ITREQ-2522search_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是否正确（它应该是一个数字）
构建错误
如果您从源代码构建并遇到错误：
# Clean and rebuild
rm -rf node_modules dist
npm install # or: bun install
npm run build # or: bun run build发展
本地运行
# 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许可证-有关详细信息，请参阅许可证文件
链接
支持
对于问题和疑问：
- 错误报告:
- 讨论:
致谢
灵感源自于 点击MCP服务器 作者taazkareem。