> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/integracoes/api-tiflux/mcp-tiflux.md). # MCP Tiflux ## 🤖 Guia de Uso do MCP do Tiflux ```markdown 📍 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** {% hint style="success" %} **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**](https://github.com/tiflux/tiflux-mcp) {% endhint %} #### **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: 1. No painel do Tiflux, clique na sua foto de perfil no canto superior direito e selecione **Minha Conta**. 2. Navegue até à aba **Sessões** e clique na subaba **Sessões API**. 3. Clique no botão azul **"Criar Nova Sessão"**. 4. Atribua um nome claro à sessão (Ex: *MCP Claude Desktop*). 5. 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: 1. Vá até o menu superior e clique em **Arquivo > Configurações > Conectores**. 2. No canto superior, clique em **Adicionar > Adicionar conector personalizado**. 3. Preencha as propriedades requeridas conforme os dados abaixo: * **Nome:** `MCP Tiflux` * **URL do servidor MCP remoto:** `https://mcp.tiflux.com/mcp` 4. Clique no botão **"Adicionar"**. 5. 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** ```markdown mcp tiflux model context protocol integração claude desktop configurar ia externa token sessões api mcp servers json npx tiflux mcp server limitações mcp tickets ```