{
  "markdown": "# mcp-tomticket\n\n[![npm](https://img.shields.io/npm/v/mcp-tomticket.svg)](https://www.npmjs.com/package/mcp-tomticket)\n[![MCP Registry](https://img.shields.io/badge/MCP-io.github.glira%2Fmcp-tomticket-blue)](https://registry.modelcontextprotocol.io)\n[![Glama](https://glama.ai/mcp/servers/glira/mcp-tomticket/badges/score.svg)](https://glama.ai/mcp/servers/glira/mcp-tomticket)\n\nServidor [MCP](https://modelcontextprotocol.io) para a [API TomTicket v2](https://tomticket.tomticket.com/kb/api). Lista, responde, lança horário e finaliza chamados e também cobre clientes, organizações, chats, departamentos e base de conhecimento.\n\nNã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.\n\nO token vai só em variável de ambiente. Nunca o commite.\n\n## Requisitos\n\n- Node.js >= 18\n- Token de API do TomTicket (conta Premium/Enterprise)\n\n## Instalação\n\nVia npm (recomendado):\n\n```bash\nnpx mcp-tomticket\n```\n\nNo Cursor (`~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"tomticket\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"mcp-tomticket\"],\n      \"env\": {\n        \"TOMTICKET_TOKEN\": \"cole-o-token-aqui\"\n      }\n    }\n  }\n}\n```\n\nClone local:\n\n```bash\ngit clone https://github.com/glira/mcp-tomticket.git\ncd mcp-tomticket\nnpm install\ncp .env.example .env\n# edite .env e cole o TOMTICKET_TOKEN\nnpm run build\n```\n\nValidação rápida (somente leitura):\n\n```bash\nnpm run smoke\n```\n\nOpcional — cria, comenta, responde e finaliza **um chamado de teste** com assunto `[MCP TESTE]`:\n\n```bash\nnpx tsx scripts/smoke.ts --write\n```\n\nRecarregue os MCPs em **Settings → MCP**. Exemplo local em [`.cursor/mcp.json.example`](.cursor/mcp.json.example).\n\n## Tools principais\n\n| Tool | Ação |\n| --- | --- |\n| `tomticket_list_open_tickets` | Chamados abertos |\n| `tomticket_list_tickets` | Todos, com filtros |\n| `tomticket_get_ticket` | Detalhe + respostas + horários |\n| `tomticket_reply_ticket` | Resposta do atendente (`start_date`/`end_date` lançam horário) |\n| `tomticket_comment_ticket` | Comentário interno |\n| `tomticket_finish_ticket` | Finaliza (`time_work` em minutos) |\n| `tomticket_start_status` / `tomticket_close_status` | Cronômetro de status |\n| `tomticket_create_ticket` | Abre chamado |\n| `tomticket_transfer_ticket` / `tomticket_assign_operator` | Transferir / vincular atendente |\n\nHá 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`).\n\n## Rate limit\n\nA API aceita **3 requisições por segundo**. O client aplica intervalo mínimo de 350 ms.\n\n## Variáveis\n\n| Variável | Obrigatória | Descrição |\n| --- | --- | --- |\n| `TOMTICKET_TOKEN` | sim | Bearer Token do painel |\n| `TOMTICKET_BASE_URL` | não | Padrão `https://api.tomticket.com/v2.0` |\n\n## Licença\n\n[MIT](LICENSE)\n",
  "bytes": 2991,
  "sha": "7bfbeff41936436b57f25d36b2be95ca4d98f2ad463a082a96d5e437c253dda9",
  "repo_slug": "glira/mcp-tomticket",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_glira_mcp_tomticket_cbd12a37/readme"
}