tiflux-mcp

Tiflux

Tiflux para Claude, ChatGPT e agentes de IA

Wrapper da API oficial v2 do Tiflux (help desk e service desk): chamados com respostas ao solicitante, notas internas, anexos, histórico de estágios e SLAs, apontamentos de horas, clientes e solicitantes, mesas com estágios, prioridades e catálogo de serviços, base de conhecimento, contratos e relatórios de faturamento e satisfação. Consulta e operação. Autenticação por token de Sessão API do usuário.

• 📊 30 ferramentas
• ✏️ Leitura e escrita
• 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
• 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

---

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Tiflux e URL https://api.mcp.ai/p_tiflux.

Cursor

➕ Instalar Tiflux no Cursor

VS Code (Copilot Chat)

➕ Instalar Tiflux no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_tiflux

Detalhes por cliente: INSTALL.md.

---

Exemplos de uso

Liste os chamados abertos com SLA vencendo nas próximas 4 horas
Abra um chamado na mesa de Suporte para o cliente X sobre a impressora fora do ar
Responda o chamado 1234 avisando que a correção foi aplicada e encerre
Quantas horas foram apontadas por atendente no mês passado

---

30 ferramentas disponíveis

Tool	Descrição
tiflux_me	Dados do usuário dono do token (nome, e-mail, perfil, feature flags).
tiflux_list_tickets	Lista chamados com filtros (situação, mesa, cliente, estágio, responsável, solicitante, período, SLA a vencer).
tiflux_get_tickets	Detalha um ou vários chamados pelos números, numa única chamada.
tiflux_create_ticket	Abre um novo chamado. Resolva desk_id e client_id antes com tiflux_list_desks e tiflux_list_clients. Identifique o solicitante por requestor_id, ou pelos campos requestor_name e requestor_email quando ele ainda não ex…
tiflux_update_ticket	Atualiza um chamado existente.
tiflux_close_ticket	Encerra um chamado, marcando-o como resolvido.
tiflux_cancel_ticket	Cancela um chamado, encerrando-o SEM tratá-lo como atendido (duplicado, aberto por engano, fora de escopo).
tiflux_list_ticket_answers	Lista as respostas (comunicações visíveis ao solicitante) de um chamado.
tiflux_create_ticket_answer	Responde um chamado. Esta resposta É VISÍVEL PARA O SOLICITANTE e dispara notificação. Para uma nota que só a equipe vê, use tiflux_create_internal_communication.
tiflux_list_internal_communications	Lista as comunicações internas de um chamado (notas visíveis só para a equipe, nunca para o solicitante).
tiflux_create_internal_communication	Cria uma comunicação interna num chamado.
tiflux_list_ticket_files	Lista os arquivos anexados a um chamado.
tiflux_get_ticket_stages_slas	Histórico de estágios e SLAs de um chamado (quando entrou em cada estágio e como ficou o SLA).
tiflux_list_ticket_appointments	Lista os apontamentos de horas de um chamado.
tiflux_create_appointment	Lança um apontamento de horas num chamado, em nome do usuário dono do token.
tiflux_list_appointments	Lista apontamentos de horas de toda a organização por período, atendente e mesa.
tiflux_list_clients	Lista clientes da organização, com busca parcial por nome.
tiflux_get_clients	Detalha um ou vários clientes pelos ids, numa única chamada.
tiflux_list_requestors	Busca solicitantes por nome, e-mail ou telefone.
tiflux_list_desks	Lista as mesas de atendimento, com busca parcial por nome.
tiflux_list_desk_stages	Lista os estágios (etapas do fluxo) de uma mesa.
tiflux_list_desk_priorities	Lista as prioridades configuradas numa mesa, com os respectivos SLAs.
tiflux_list_desk_services_catalogs	Lista os catálogos de serviços de uma mesa (a classificação do chamado).
tiflux_list_technical_users	Lista os atendentes, com filtro por nome, e-mail, mesa ou cliente.
tiflux_list_technical_groups	Lista os grupos de atendentes da organização.
tiflux_list_departments	Lista os departamentos da organização.
tiflux_list_knowledges	Busca artigos da base de conhecimento por texto e por pasta.
tiflux_list_contracts	Lista os contratos de atendimento, com filtro por cliente, tipo e situação.
tiflux_billings_history	Histórico de faturamentos. Os pares de data são obrigatórios em conjunto: billing_start_date com billing_end_date, e due_start_date com due_end_date. Bulk support: accepts client_ids for batched execution.
tiflux_tickets_feedback_report	Relatório de satisfação (feedback) dos chamados por período, com recorte por responsável, departamento ou grupo de atendentes.

Detalhe de cada tool: docs/ferramentas.md

---

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

---

Privacidade & LGPD

• Sub-processadores: Tiflux Sistema de Gestão, o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
• Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

---

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_tiflux.

---

Suporte

• 📧 tiflux@mcp.ai
• 🐛 GitHub Issues
• 📄 docs/

---

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_tiflux é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.