Mcp Tomticket

io.github.glira由 GitHub 账号 glira 发布v1.0.0更新于 Oct 25, 2026

TomTicket helpdesk MCP: tickets, replies, time, customers, chats, and KB

已验证STDIO仅桌面效率与工作流商业与电商

概览

AI 生成的概览

面向 TomTicket 服务台 API 的本地 MCP 服务器，让助手列出、回复、计时和结束工单，并浏览客户、聊天和知识库

可以做什么
列出开放或按条件筛选的工单，查看工单详情、回复和已登记工时。回复工单、添加内部备注、启动和关闭状态计时器，并按工时结束工单。创建工单、转交工单和指派客服人员。浏览客户、组织、部门、聊天、知识库和自定义字段。
适用场景
适合使用 TomTicket 的客服团队，让助手在不打开网页后台的情况下分拣工单队列、起草或发送回复、登记工时并关闭工单。
运行要求
通过 npx 在本地运行，需要 Node.js 18 或更高版本。需要在 TOMTICKET_TOKEN 中提供在账户后台创建的 TomTicket API Bearer Token，并需要 Premium 或 Enterprise 账户。TOMTICKET_BASE_URL 可选，默认指向公开 API 地址。需要能访问 TomTicket API 的网络。
安装前请注意
为支持回复、登记工时和结束工单，令牌需具备创建和修改数据的权限，因此助手可以改动生产环境中的服务台数据。写操作会提示其影响生产环境。结束工单前必须先指派客服人员。令牌只应放在环境变量中，切勿提交到代码库。API 限制每秒 3 次请求。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Tomticket，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

mcp-tomticket

[npm] [MCP Registry] [Glama]

Servidor MCP para a API TomTicket v2. Lista, responde, lança horário e finaliza chamados e também cobre clientes, organizações, chats, departamentos e base de conhecimento.

Não existe endpoint de login. O Bearer Token é criado no painel: Administração → Configurações da Conta → API → Novo Token. Marque Pode criar e modificar dados para respostas, horário e finalização.

O token vai só em variável de ambiente. Nunca o commite.

Requisitos

  • Node.js >= 18
  • Token de API do TomTicket (conta Premium/Enterprise)

Instalação

Via npm (recomendado):

bash
npx mcp-tomticket

No Cursor (~/.cursor/mcp.json):

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

Clone local:

bash
git clone https://github.com/glira/mcp-tomticket.gitcd mcp-tomticketnpm installcp .env.example .env# edite .env e cole o TOMTICKET_TOKENnpm run build

Validação rápida (somente leitura):

bash
npm run smoke

Opcional — cria, comenta, responde e finaliza um chamado de teste com assunto [MCP TESTE]:

bash
npx tsx scripts/smoke.ts --write

Recarregue os MCPs em Settings → MCP. Exemplo local em .cursor/mcp.json.example.

Tools principais

ToolAção
tomticket_list_open_ticketsChamados abertos
tomticket_list_ticketsTodos, com filtros
tomticket_get_ticketDetalhe + respostas + horários
tomticket_reply_ticketResposta do atendente (start_date/end_date lançam horário)
tomticket_comment_ticketComentário interno
tomticket_finish_ticketFinaliza (time_work em minutos)
tomticket_start_status / tomticket_close_statusCronômetro de status
tomticket_create_ticketAbre chamado
tomticket_transfer_ticket / tomticket_assign_operatorTransferir / vincular atendente

Há também tools de clientes, organizações, chats, departamentos, KB e campos personalizados. Operações de escrita avisam que alteram produção. Finalizar um chamado exige atendente vinculado (tomticket_assign_operator).

Rate limit

A API aceita 3 requisições por segundo. O client aplica intervalo mínimo de 350 ms.

Variáveis

VariávelObrigatóriaDescrição
TOMTICKET_TOKENsimBearer Token do painel
TOMTICKET_BASE_URLnãoPadrão https://api.tomticket.com/v2.0

Licença

MIT

来源：README.md，提交 4602c77

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分