MCP Tiflux
🤖 Guia de Uso do MCP do Tiflux
📍 Localização:
📂 Minha Conta > Sessões > Sessões API🎯 Introdução
O Model Context Protocol (MCP) é um protocolo aberto que funciona como uma ponte universal entre assistentes de Inteligência Artificial externos (como Claude Desktop, ChatGPT, entre outros) e a plataforma Tiflux.
Este guia orienta o utilizador passo a passo sobre como gerar as credenciais de acesso e configurar o servidor MCP. Isto permite que o seu assistente de IA preferido consulte informações, crie tickets, liste utilizadores e execute ações diretamente no ecossistema Tiflux, de forma segura e contextualizada.
📚 Sumário
🔧 Pré-requisitos
🧭 Passo a Passo
🛠️ Troubleshooting (Erros Comuns)
⚠️ Avisos importantes
🧾 Resumo
❓ Perguntas Frequentes (FAQ)
🔧 Pré-requisitos
Ter um contrato de API ativo na sua conta Tiflux.
Possuir a aplicação Claude Desktop (ou outro assistente compatível) instalada.
Acesso às credenciais e painel do Tiflux para geração de tokens.
🧭 Passo a Passo
Importante: Dentro do nosso GITHUB temos mais informações técnicas para orientar de como conectar, consultar e visualizar informações sobre o MCP - https://github.com/tiflux/tiflux-mcp
1. 🔑 Gerar o Token de Acesso (API Session)
Para que a IA tenha autorização de ler e escrever dados na sua base do Tiflux, deve gerar um token de autenticação pessoal:
No painel do Tiflux, clique na sua foto de perfil no canto superior direito e selecione Minha Conta.
Navegue até à aba Sessões e clique na subaba Sessões API.
Clique no botão azul "Criar Nova Sessão".
Atribua um nome claro à sessão (Ex: MCP Claude Desktop).
O sistema gerará um Token de Acesso. Copie-o imediatamente e guarde-o num local seguro.
⚠️ Atenção: O token não será exibido novamente após fechar a janela.
2. 🛠️ Configuração Prática no Claude Desktop
Para conectar o servidor MCP ao assistente Claude Desktop, realize os seguintes passos dentro do aplicativo:
Vá até o menu superior e clique em Arquivo > Configurações > Conectores.
No canto superior, clique em Adicionar > Adicionar conector personalizado.
Preencha as propriedades requeridas conforme os dados abaixo:
Nome:
MCP TifluxURL do servidor MCP remoto:
https://mcp.tiflux.com/mcp
Clique no botão "Adicionar".
Na sequência, clique sobre a opção "Vincular" para validar as suas credenciais através do token gerado.
💡 Dica: Certifique-se de preencher a URL exatamente como descrita para evitar falhas de comunicação com o servidor remoto.
3. 🚦 Funcionalidades Disponíveis para a IA
Uma vez conectado, o assistente de IA ganha autonomia para interpretar comandos em linguagem natural e executar ações mapeadas por ferramentas nativas:
Gestão de Chamados: Criar novos tickets, listar chamados abertos, pesquisar históricos por ID e adicionar respostas/interações em tickets existentes.
Inventário de Ativos: Listar e pesquisar recursos (máquinas e servidores) cadastrados na sua base.
Base de Conhecimento: Consultar e pesquisar artigos de KCS criados no Tiflux para responder a dúvidas de clientes.
Controlo de Tempo e Utilizadores: Listar utilizadores cadastrados e registar/listar apontamentos de horas trabalhadas.
🛠️ Troubleshooting (Erros Comuns)
🔹 Erro: A transferência de mesa falhou através do comando da IA
✅ Solução: Verifique se a mesa de destino exige obrigatoriamente um item do Catálogo de Serviço. Caso exija, você deve informar o nome ou ID do catálogo diretamente no comando de texto enviado para a IA.
🔹 Erro: A IA não consegue realizar pesquisas globais ou listar todos os utilizadores
✅ Solução: Certifique-se de que o Token de Acesso utilizado na vinculação foi gerado por um usuário com perfil Administrador. Utilizadores comuns possuem restrições de privacidade e acessam caminhos alternativos automáticos limitados.
⚠️ Avisos importantes
Upload de Ficheiros: A IA consegue anexar ficheiros às respostas, limitando-se a até 10 ficheiros por vez, com tamanho máximo de 25 MB cada (ou até 40 MB especificamente em respostas de tickets). Apontamento de Horas: A criação de apontamentos de horas por comando da IA só é permitida em Mesas de Serviço configuradas sem valorização financeira. A listagem de apontamentos funciona normalmente em qualquer mesa. Alteração de Solicitante: Não é possível alterar o utilizador solicitante de um ticket após ele já estar criado. Essa atribuição só é válida estritamente no momento da abertura do chamado.
🧾 Resumo
O protocolo MCP estende a inteligência analítica de assistentes externos para dentro do ecossistema Tiflux. Ao centralizar as permissões através de tokens de API, a operação ganha agilidade para criar chamados, realizar consultas estruturadas de ativos e alimentar a base de conhecimento de maneira automatizada e contextualizada.
❓ Perguntas Frequentes (FAQ)
🔹 Preciso pagar algum valor adicional para utilizar o MCP do Tiflux? Não. O protocolo MCP é disponibilizado de forma gratuita para integração da sua licença com ferramentas de IA externas, necessitando apenas o contrato de API.
🔹 O assistente de IA nativo do Tiflux já está incluído neste pacote? Não. Este documento cobre estritamente a ligação de assistentes externos (como Claude e ChatGPT) via protocolo MCP. O assistente de IA nativo que roda de forma interna no Tiflux encontra-se em fase de testes internos e não faz parte deste lançamento.
🔹 O meu token de acesso da API expirou ou foi comprometido. O que devo fazer? Por motivos de segurança, deve aceder imediatamente a Minha Conta > Sessões > Sessões API, revogar a sessão antiga e criar um novo token. Lembre-se de atualizar o código da sua IA.
🔍 Palavras-chave para IA, indexação e busca
Atualizado