Freshserviceda permite que as ferramentas de IA leiam os seus tickets, ativos e base de conhecimento. Isto significa menos alternância entre ferramentas, pesquisas de detalhes e menos reinserção da mesma informação. Parece um sonho para qualquer gestor de suporte informático que procure otimizar processos, não é?
Bem, este sonho vem com duas ressalvas. Em primeiro lugar, o gateway, ainda em versão beta, tem um limite de 5.000 chamadas por mês. Segundo, funciona melhor quando os dados a que acede são limpos e fiáveis.
Se não está disposto a passar uma eternidade a organizar toda a sua central de serviços — apenas para ver o seu orçamento de chamadas desaparecer num piscar de olhos — uma abordagem gradual faz mais sentido. Ligue as categorias de dados uma a uma, começando por aquelas que podem gerar o maior valor com o mínimo esforço. Esta é exatamente a mesma abordagem que se aplica à migração de dados para a IA.
Neste guia,plain o que ligar primeiro, o que pode esperar e porque é que a ordem é importante.
O que é o Freshservice MCP Gateway?
A Freshworks apresentou o seu Gateway na Refresh 2026 em San Mateo, no dia 14 de maio, juntamente com o seu Freddy AI Agent Studio. Como explicou Srini Raghavan, CPO da empresa: "As ferramentas de IA podem ser boas no raciocínio, mas muitas vezes não têm acesso aos dados de serviço em tempo real de uma organização. Preencher esta lacuna é o problema que o MCP Gateway foi concebido para resolver.".
O MCP Gateway da Freshworks funciona em duas direções. O MCP de entrada permite que as ferramentas externas de IA acedam aos dados Freshservice , enquanto o MCP de saída permite que os agentes de IA Freshservice executem ações em plataformas empresariais conectadas.
A Freshworks não é o único fornecedor de ITSM a implementar a conectividade MCP. O seu lançamento faz parte de uma tendência mais ampla. ServiceNow, por exemplo, possui o seu próprio MCP – ServiceNow MCP Server Console. Portanto, se estiver a escolher entre estas duas plataformas de ITSM, o suporte MCP é o que têm em comum: ambas trabalham para tornar os dados de serviço mais acessíveis para além da plataforma.
Modo MCP de entrada: ferramentas de IA que lêem e atuam sobre os dados Freshservice
O modo MCP de entrada permite que ferramentas externas de IA, como o Cursor, o Claude e o Microsoft Copilot, acedam aos dados Freshservice . Um programador que trabalhe no Cursor pode facilmente verificar o estado de um ticket em curso sem sair do IDE, enquanto um agente que utilize o Claude pode rever o histórico de um item de configuração antes de responder a um pedido.
O endpoint suporta mais de 30 funções, abrangendo tickets, ativos, agentes e requisitantes, integração e desligamento de colaboradores, catálogo de serviços e artigos de soluções.
Dito isto, uma vez que o modo MCP de entrada depende diretamente dos dados da central de assistência, este artigo irá focar-se na preparação e configuração da ligação de entrada, em vez do modo MCP de saída.
Modo MCP de saída: Freshservice Freddy AI a ler e a agir com base em dados externos
O modo MCP de saída funciona no sentido oposto. Permite que os agentes de IA Freshservice Freddy executem tarefas no Atlassian, Notion, Linear e ClickUp.
Por exemplo, um agente da Freddy AI que lida com um pedido de integração pode criar um ticket no Linear e atualizar a página correspondente no Notion como parte do mesmo fluxo de trabalho.
Quem pode utilizar o servidor Freshservice MCP e como?
Ambas as funcionalidades permanecem em Acesso Antecipado até setembro de 2026. Até lá, o modo Inbound MCP requer o plano Enterprise, enquanto o modo Outbound MCP está disponível nos planos Growth, Pro e Enterprise com uma subscrição ativa do Freddy AI Agent Studio.
Durante o período de acesso antecipado (EAP), o Freshworks limita a utilização a aproximadamente 100 chamadas de ferramentas por minuto e 5.000 por mês para ambos os modos. A partir de setembro, o servidor MCP passará a ser uma funcionalidade completa disponível nos planos Growth, Pro e Enterprise para ambos os modos, com novos limites de utilização:
- Crescimento — 25 ações por minuto; 100 ações por conta por mês
- Plano Pro — 50 ações por minuto; 500 ações por conta por mês
- Empresarial — 100 ações por minuto; 1.000 ações por conta por mês
Quando uma conta ultrapassa o seu limite mensal, a Freshworks cobra 15 dólares por cada 1.000 ações adicionais.
É importante ter em conta estas limitações antes de ligar o gateway a fluxos de trabalho que são executados com frequência. Este planeamento deve começar com os dados dos quais estes fluxos de trabalho dependerão.
Como a IA amplifica os problemas de dados
Seja a criar um chamado, a atualizar o registo de um ativo ou a responder a uma pergunta utilizando a base de conhecimento, os agentes de IA dependem dos dados disponíveis. Se estes dados contiverem lacunas, duplicados ou informações desatualizadas, um agente poderá levar estes problemas diretamente para a ação seguinte.
Imagine que o seu CMDB contém dois registos para o mesmo portátil. Um agente de suporte pode abrir um chamado de reparação para o registo errado, enquanto o histórico correto do ativo permanece noutro local. Se o campo do requerente ainda apontar para um funcionário que já deixou a empresa, um pedido de integração poderá ser encaminhado para uma caixa de correio inativa, deixando o pedido do portátil do novo funcionário sem um responsável definido.
Uma pessoa que reveja os mesmos registos pode notar que algo parece errado e parar para investigar. Um agente de IA pode recuperar um registo através do gateway MCP e agir imediatamente.
Por isso, antes de perguntar com que tarefas o servidor MCP pode ajudar, pergunte-se para que é que os seus dados estão realmente preparados.
Antes de ligar qualquer coisa: uma lista de verificação de prontidão em cinco pontos
Existem cinco áreas onde um problema de dados pode rapidamente transformar-se num erro do agente de IA. Verifique-as antes de conceder o acesso. Ou, se estiver a migrar de outro centro de serviços para Freshservice, reveja estes itens — e o resto da Freshservice lista de verificação de migração de dados — antes de migrar para a plataforma.
- Histórico de chamadas. Certifique-se de que o histórico de chamadas está completo. Um atendedor que responde à pergunta "Como é que isto foi resolvido da última vez?" necessita das notas da resolução para trabalhar. Se o chamado original foi fechado sem estas anotações, há pouco contexto útil para recuperar.
- Campos do ticket. Verifique se os campos obrigatórios contêm valores corretos e se não existem registos duplicados. As relações também devem estar corretas: um ticket deve apontar para o ativo correto e esse ativo para o proprietário correto.
- Usuários. Confirmem se os registos de requerente e agente pertencem a pessoas que ainda estão ativas. Caso contrário, as aprovações e atribuições podem acabar na conta de um ex-funcionário em vez da pessoa responsável atualmente.
- Base de conhecimento. Os artigos de solução devem refletir o processo atual do início ao fim. Remova ou atualize artigos sobrepostos para que um agente não tenha de escolher entre duas respostas conflituantes.
- Ativos circulantes. O seu inventário deve corresponder ao que está efetivamente em uso. Os registos de ativos desativados, obsoletos e duplicados devem ser eliminados antes de um agente começar a consultá-los.
A limpeza dos dados elimina uma das principais fontes de risco, mas não resolve tudo. É ainda necessário detetar problemas precocemente e evitar o consumo excessivo da franquia de dados.
A ligação das categorias de dados uma a uma permite validar cada ligação, iniciar a formação de agentes de IA externos antes da conclusão da implementação completa, utilizar o gateway MCP mais cedo e obter mais valor do seu pacote de chamadas. Então, a próxima questão é: o que deve ligar primeiro?
A Estrutura de Priorização de Ligações: O que ligar primeiro
Cada categoria de dados por detrás do MCP transporta uma quantidade diferente de contexto por chamada de API. Os tickets são os que geram o maior retorno para um agente de IA. De seguida, vêm os artigos da base de conhecimento e, por fim, os ativos. Ligue os restantes apenas depois desses três obterem acesso.
1.º Os bilhetes, ou o mecanismo de contexto
Os tickets contêm o contexto mais completo por chamada. Um único registo inclui normalmente o problema original, o seu contexto, histórico de resolução de problemas, resolução e data/hora. Isto fornece ao agente tanto o problema como o caminho para o resolver.
Antes de ligar os tickets, certifique-se de que o histórico está completo. Isto é especialmente importante se também estiver a migrar dados para o Freshservice. CSV podem deixar para trás conversas, anexos ou relações entre campos. Uma ferramenta de migração dedicada com mapeamento de campos, como Help Desk Migration preserva todo o contexto que o MCP irá expor.
2. Artigos da base de conhecimento, ou a camada de respostas
Uma vez que os chamados estão ligados, os artigos da base de conhecimento alargam o alcance do agente de IA. Em vez de reunir uma resposta a partir de vários chamados relacionados, o agente pode obter uma solução documentada numa única chamada. Isto significa menos chamadas e uma resposta mais rápida para o colaborador que aguarda do outro lado da linha.
Se estiver a migrar para Freshservice, Help Desk Migration preserva toda a sua base de conhecimento, transferindo todo o conteúdo, incluindo artigos, categorias e secções.
3.º Ativos e CMDB, ou a camada "o que correu mal"
Os registos de ativos respondem a uma questão diferente. Os bilhetes e os artigosplain o que aconteceu e como problemas semelhantes foram resolvidos; os registos de ativos mostram o que está realmente envolvido.
Um agente que esteja a resolver problemas, por exemplo, com um portátil, pode ter de confirmar o modelo, o estado da garantia e o proprietário atual antes de decidir se um histórico de chamadas ou um artigo da base de dados de conhecimento se aplica ao caso.
4. Utilizadores e requerentes, ou personalização e permissões
Os dados do utilizador e do requerente acrescentam contexto ao que o agente já aprendeu com os tickets, artigos e recursos. Isto permite ligar um pedido ao departamento, funcionário ou cadeia de aprovação corretos.
Esta quarta camada surge porque a personalização funciona melhor quando já existe algo concreto para personalizar.
5. Catálogo de serviços e alterações, ou ligar por último
Os dados do catálogo de serviços e de gestão de mudanças são geralmente mais estruturados e deixam menos espaço para ambiguidades. Normalmente baseiam-se em campos mais específicos e processos predefinidos, fornecendo a um agente de IA informações mais previsíveis para trabalhar. Isto torna estas categorias candidatas adequadas para a fase final da implementação.
Como resultado, coloca primeiro em funcionamento os dados de maior valor e com maior contexto, e depois adiciona camadas mais estruturadas por cima.
Configurando a ligação
Em agosto de 2026, a integração do Freshworks MCP ainda estava em versão Beta. Para solicitar o acesso, contacte o seu gestor de contas técnicas.
Após a ativação da integração com o Freshservice MCP, cada agente liga a ferramenta de IA de que necessita a partir da sua própria conta.
Opções de autenticação
Freshservice oferece duas formas de autenticar ligações MCP: OAuth 2.0 e uma chave API. Recomendamos o OAuth 2.0 como a opção mais segura.
Uma chave API funciona como uma palavra-passe única partilhada em todas as sessões. Qualquer pessoa que obtenha esta chave poderá utilizá-la até que seja revogada manualmente. O OAuth 2.0 funciona de forma diferente, emitindo um token que se renova automaticamente. Se este token for roubado, permanece válido durante um curto período antes de deixar de funcionar.
Se optar pelo método da chave API, crie a chave no Portal de Suporte:
- Clique na sua fotografia de perfil.
- Abra as definições do perfil.
- Encontre a sua chave API Freshservice abaixo da secção Aprovações de Delegados.
Em seguida, insira a chave no ficheiro de configuração do agente de IA ao qual se está a ligar.
Ligar Claude, Cursor e Copilot Studio
Ligar um agente de IA através Freshservice MCP Gateway é simples. Vamos usar como exemplo o Claude, o Cursor e o Copilot Studio.
Conectando Claude
Para ligar o Claude, precisará de:
- A aplicação Claude Desktop/a aplicação Claude Code (caso esteja a ligar as aplicações correspondentes, e não o Claude baseado no browser)
- Uma conta ativa do Claude
- O URL do servidor Freshservicefreshservice(https://seu-subdomínio.freshservice.com/mcp)
Cursor de ligação
Para ligar o Cursor, necessitará de:
- O aplicativo Cursor foi instalado.
- Uma conta Cursor ativa.
- URL do servidor Freshservice MCP.
Ligar o Copilot Studio
Para ligar o Copilot Studio, necessitará de:
- Acesso ao Microsoft Copilot Studio.
- Uma conta Microsoft Copilot Studio ativa.
- Um agente existente criado no Microsoft Copilot Studio.
- URL do servidor Freshservice MCP.
Após configurar tudo isto, siga as instruções passo a passo na Freshservice página de suporte.
Erros comuns na implementação do MCP
Embora a ligação ao MCP seja relativamente simples, isso não significa que deva ser ativado em todo o lado ao mesmo tempo. Uma série de más decisões de implementação podem rapidamente transformar-se em problemas desnecessários, chamadas desperdiçadas ou resultados de IA não fiáveis. Eis os três principais erros a evitar.
Ligando tudo no primeiro dia
Ligar todos os dados na mesma implementação pode parecer eficiente, mas não o recomendamos. Se algo correr mal, será mais difícil identificar a causa, uma vez que qualquer uma das categorias de dados recentemente ligadas pode ser a responsável.
Ignorando os limites de taxa
Um limite de 100 chamadas por minuto e 5.000 por mês pode parecer generoso — até que um agente de IA se torne parte de um fluxo de trabalho que é acionado a cada atualização de ticket.
Ao criar automatizações sem ter em conta estas limitações, pode não atingir o limite máximo até que os pedidos comecem a falhar. Antes de colocar um fluxo de trabalho em utilização regular, estime a frequência com que será acionado e quantas chamadas serão necessárias.
Ignorando a etapa de limpeza de dados
O MCP apresenta os seus dados exatamente como estão, incluindo erros.
Ligar primeiro e limpar depois pode acabar por resultar na resolução de problemas causados por erros de IA. Uma resposta incorreta devido a um registo de ativos duplicado, informações de tickets desatualizadas ou um artigo obsoleto na base de conhecimento pode demorar mais tempo a ser rastreada e corrigida do que a limpeza prévia dos dados subjacentes.
Conclusão
O Freshservice MCP Gateway permite que as ferramentas de IA acedam a uma vasta gama de dados de help desk de TI, pelo que ligar tudo de uma vez pode ser tentador. Na prática, porém, os limites de utilização e a qualidade dos dados tornam necessária uma abordagem mais gradual. Uma implementação faseada, combinada com uma limpeza completa, permite validar cada ligação, trabalhar com conjuntos de dados mais pequenos e de alta qualidade antes da conclusão da implementação completa e tirar melhor partido do seu limite mensal de chamadas.
Se a implementação do seu MCP também envolver a migração de outro centro de atendimento para Freshservice, Help Desk Migration pode automatizar a transferência, dando prioridade à sua base de conhecimento e aos tickets de maior qualidade. Isto disponibiliza dados importantes para as ferramentas de IA mais rapidamente, sem a necessidade de esperar pela conclusão de toda a migração.
Execute uma migração de demonstração gratuita e veja os seus dados chegarem prontos para o MCP.
Seção de perguntas frequentes
- Freddy AI Agent: responde a perguntas e atende a pedidos através de serviço conversacional, integrações com ferramentas de colaboração, Freddy AI Agent Studio (fornece kits de ferramentas de personalização), etc.
- Freddy AI Copilot: assistência na escrita (sugere respostas adequadas), criação de resumos de tópicos de tickets, rascunhos de novos artigos para a base de conhecimento, etc.
- Freddy AI Insights: insights inovadores e análises de negócios através de conversas simples.
Freshservice e Salesforce abordam os servidores MCP de duas formas distintas: a primeira como solução ITSM e a segunda como solução empresarial.
Construída como uma central de serviços de TI com foco em dados de suporte, Freshservice especializa-se na gestão de incidentes, rastreio de ativos e processamento de chamadas. A plataforma permite que as ferramentas de IA exibam e consultem dados (incluindo pesquisa, filtragem e extração de chamadas de uma database). Também executa tarefas e fluxos de trabalho da central de serviços diretamente a partir de interfaces de chat externas, eliminando a necessidade de alternar entre software.
Já Salesforce, foca-se nas operações de desenvolvimento, na lógica de negócio automatizada (Flows/Apex) e nas interações com o cliente (gere o estado das encomendas, o rastreio de envios, o encaminhamento de casos e as devoluções). No geral, foi concebido para servir ambientes corporativos e necessidades centradas no desenvolvimento.