mcp-tomticket

Name: mcp-tomticket
Author: glira

本地服务

github.com/glira商业与营销010 周前更新

代码仓库

关于 mcp-tomticket

mcp-tomticket 是连接 TomTicket v2 API 的 MCP 服务，面向需要通过 AI 工作流管理帮助台的团队。它涵盖工单处理以及客户、组织、聊天、部门和知识库操作。

主要功能

01列出和查看工单
02回复、评论与创建工单
03记录工时并关闭工单
04管理客户、组织与聊天
05访问部门和知识库

适用场景

01查看待处理工单并回复客户
02记录工单处理时间并结束工单
03创建工单或转派给客服人员
04查询客户、聊天或知识库内容

MCP 相关

它通过 MCP 工具向客户端开放 TomTicket v2 API 的工单及相关帮助台操作。使用时需通过环境变量提供 TomTicket Bearer Token。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "glira-mcp-tomticket": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-tomticket"
      ],
      "env": {
        "TOMTICKET_TOKEN": "<TOMTICKET_TOKEN>",
        "TOMTICKET_BASE_URL": "<TOMTICKET_BASE_URL>"
      }
    }
  }
}

启动命令npx -y mcp-tomticket

需要配置的环境变量

TOMTICKET_TOKEN密钥Bearer Token created in TomTicket (Administração → Configurações da Conta → API)

TOMTICKET_BASE_URLAPI base URL. Default: https://api.tomticket.com/v2.0

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmmcp-tomticket1.0.0stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
page	integer	否	页码。每页最多 50 项。默认值：1。
priority	string	否	以逗号分隔的优先级：1 低，2 普通，3 高，4 紧急。
show_tags	integer	否	1 表示包含标签。
operator_id	string	否	按客服人员筛选。留空可查找未分配客服人员的工单。
department_id	string	否	按部门筛选。
show_stopwatch	integer	否	1 表示包含计时记录。

详细介绍

mcp-tomticket

用于 TomTicket v2 API 的 MCP 服务。可列出、回复、登记工时和结束工单，还涵盖客户、组织、聊天、部门和知识库。

没有登录端点。Bearer Token 在控制面板中创建：管理 → 账户设置 → API → 新建 Token。若要回复、登记工时和结束工单，请勾选 可以创建和修改数据。

Token 仅通过环境变量传入。切勿将其提交到代码库。

要求

Node.js >= 18
TomTicket API Token（Premium/Enterprise 账户）

安装

通过 npm 安装（推荐）：

npx mcp-tomticket

在 Cursor 中（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "tomticket": {
      "command": "npx",
      "args": ["-y", "mcp-tomticket"],
      "env": {
        "TOMTICKET_TOKEN": "cole-o-token-aqui"
      }
    }
  }
}

本地克隆：

git clone https://github.com/glira/mcp-tomticket.git
cd mcp-tomticket
npm install
cp .env.example .env
# edite .env e cole o TOMTICKET_TOKEN
npm run build

快速验证（只读）：

npm run smoke

可选 — 创建、评论、回复并结束一个测试工单，主题为 [MCP TESTE]：

npx tsx scripts/smoke.ts --write

在 Settings → MCP 中重新加载 MCP。本地示例见 .cursor/mcp.json.example。

主要工具

工具	操作
`tomticket_list_open_tickets`	打开的工单
`tomticket_list_tickets`	所有工单，可使用筛选条件
`tomticket_get_ticket`	详情 + 回复 + 工时
`tomticket_reply_ticket`	客服回复（`start_date`/`end_date` 用于登记工时）
`tomticket_comment_ticket`	内部评论
`tomticket_finish_ticket`	结束工单（`time_work` 以分钟为单位）
`tomticket_start_status` / `tomticket_close_status`	状态计时器
`tomticket_create_ticket`	创建工单
`tomticket_transfer_ticket` / `tomticket_assign_operator`	转移工单 / 指派客服