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
Licença
MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_tiflux é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.