deskmcp

DeskMCP

功能

• 全面支持 Teamwork Desk API 资源：
• 工单（Tickets）
• 客户（Customers）
• 公司（Companies）
• 用户（Users）
• 标签（Tags）
• 工单类型（Ticket Types）
• 工单状态（Ticket Statuses）

• 所有列表操作均支持高级过滤功能

• JSON 响应格式，便于解析

• 支持 Docker，便于部署

安装

选项 1：直接安装

选项 2：Docker 安装

1. 构建 Docker 镜像：

1. 运行容器（建议使用密钥管理器或环境文件来保护敏感数据）：

1. 查看日志：

1. 停止容器：

配置

• DESK_API_URL: 你的 Teamwork Desk API URL

• DESK_API_TOKEN: 你的 Teamwork Desk API 令牌

快速开始

这是什么工具？

• 创建和管理工单

• 查找客户信息

• 管理公司和用户

• 生成报告和洞察

如何与 AI 助手一起使用

1. 安装工具
• 确保你的计算机上已安装 Go
• 运行上述安装命令
• 设置你的 Teamwork Desk API 凭证

2. 启动服务器
• 打开终端窗口
• 运行 mcp 命令
• 使用工具时保持此终端窗口打开

3. 与 Claude 一起使用
• 在浏览器中打开 Claude
• 在对话中，你可以让 Claude 执行以下操作：
• “显示所有未处理的工单”
• “为客户 John Smith 创建新工单”
• “查找公司 Acme Inc 的所有工单”
• “列出 30 天内未联系的客户”

4. 最佳实践提示
• 请求时尽量具体
• 使用自然语言（例如，“显示”而不是技术命令）
• 如果不确定可用信息，可以请求澄清
• 请求特定格式的数据（例如，“以表格形式”或“按日期排序”）
• 需要时请求数据解释

5. 安全性与隐私
• 该工具仅能访问你的 API 令牌允许的内容
• 所有操作都会记录在你的 Teamwork Desk 账户中
• 你可以随时通过更改 API 令牌来撤销访问权限
• 该工具在本地运行，确保数据安全

可用工具

工单

• list_tickets: 列出所有工单，支持过滤

• get_ticket: 根据 ID 获取特定工单

• create_ticket: 创建新工单

客户

• list_customers: 列出所有客户，支持过滤

• get_customer: 根据 ID 获取特定客户

• create_customer: 创建新客户

公司

• list_companies: 列出所有公司，支持过滤

• get_company: 根据 ID 获取特定公司

• create_company: 创建新公司

用户

• list_users: 列出所有用户，支持过滤

• get_user: 根据 ID 获取特定用户

• create_user: 创建新用户

标签

• list_tags: 列出所有标签，支持过滤

• get_tag: 根据 ID 获取特定标签

• create_tag: 创建新标签

工单类型

• list_ticket_types: 列出所有工单类型，支持过滤

• get_ticket_type: 根据 ID 获取特定工单类型

• create_ticket_type: 创建新工单类型

工单状态

• list_ticket_statuses: 列出所有工单状态，支持过滤

• get_ticket_status: 根据 ID 获取特定工单状态

• create_ticket_status: 创建新工单状态

过滤功能使用

简单等值过滤

多条件过滤

常用过滤字段

工单

• status: "open", "pending", "closed" 等

• priority: "low", "medium", "high", "urgent"

• customer_id: 客户 ID

• agent_id: 代理 ID

• company_id: 公司 ID

• created_at: 日期范围

• updated_at: 日期范围

客户

• email: 客户邮箱

• company_id: 公司 ID

• created_at: 日期范围

• updated_at: 日期范围

公司

• name: 公司名称

• created_at: 日期范围

• updated_at: 日期范围

用户

• email: 用户邮箱

• role: 用户角色

• created_at: 日期范围

• updated_at: 日期范围

标签

• name: 标签名称

• created_at: 日期范围

• updated_at: 日期范围

工单类型

• name: 工单类型名称

• created_at: 日期范围

• updated_at: 日期范围

工单状态

• name: 工单状态名称

• created_at: 日期范围

• updated_at: 日期范围

使用场景

1. 客户支持自动化

• 自动从客户邮件创建工单

• 根据内容将工单分配给合适的代理

• 使用 AI 生成回复

• 跟踪客户满意度指标

2. 客户关系管理

• 跟踪客户在多渠道的互动

• 识别高价值客户

• 监控客户满意度趋势

• 生成客户报告

3. 团队管理

• 监控代理绩效

• 跟踪工单解决时间

• 识别培训机会

• 平衡团队成员的工作量

4. 商业智能

• 生成自定义报告

• 跟踪关键绩效指标

• 分析客户支持趋势

• 识别改进领域

5. 与其他系统集成

• 连接 CRM 系统

• 与项目管理工具集成

• 同步营销自动化平台

• 链接会计软件

6. AI 驱动功能

• 自动工单分类

• 客户消息的情感分析

• 智能工单分配

• 预测性回复建议

• 自动跟进安排

Claude Desktop 配置

1. 确保 DeskMCP 在本地运行（通过直接安装或 Docker）

2. 打开 Claude Desktop

3. 进入设置（齿轮图标）

4. 导航到“工具”部分

5. 添加一个新的 MCP 服务器，配置如下：

1. 保存配置

2. 重启 Claude Desktop

• “显示所有未处理的工单”

• “为客户 John Smith 创建新工单”

• “查找公司 Acme Inc 的所有工单”

故障排除

服务器断开连接错误

1. 查找 mcp 可执行文件的位置：

2. 在配置中验证 mcp 的完整路径：

3. 如果 which mcp 未返回结果，说明可执行文件不在 PATH 中。将 Go 的 bin 目录添加到 PATH：
然后重启终端和 Claude Desktop。

4. 或者，重新安装工具：

5. 对于 Docker 用户：

许可证