Freshservice

Interaja com os módulos do Freshservice para operações de gerenciamento de serviços de TI.

Documentação

Freshservice MCP Server

Visão Geral

Uma implementação poderosa de servidor MCP (Model Context Protocol) que se integra perfeitamente ao Freshservice, permitindo que modelos de IA interajam com os módulos do Freshservice e executem diversas operações de gerenciamento de serviços de TI. Esta ponte de integração capacita seus assistentes de IA a gerenciar e resolver tickets de serviço de TI, otimizando seu fluxo de trabalho de suporte.

Principais Recursos

Integração Freshservice de Nível Empresarial: Comunicação direta e segura com os endpoints da API do Freshservice
Compatibilidade com Modelos de IA: Permite que Claude e outros modelos de IA executem operações de service desk através do Freshservice
Gerenciamento Automatizado de ITSM: Lida eficientemente com criação, atualização e respostas de tickets, além do gerenciamento de ativos
Aceleração do Fluxo de Trabalho: Reduz a intervenção manual em tarefas rotineiras de serviços de TI

Módulos Freshservice Suportados

Este servidor MCP atualmente suporta operações em uma ampla gama de módulos do Freshservice:

Tickets
Changes
Conversations
Products
Requesters
Agents
Agent Groups
Requester Groups
Canned Responses
Canned Response Folders
Workspaces
Solution Categories
Solution Folders
Solution Articles

Componentes e Ferramentas

O servidor fornece um kit de ferramentas abrangente para operações do Freshservice:

Gerenciamento de Tickets

Ferramenta	Descrição	Parâmetros Principais
`create_ticket`	Criar novos tickets de serviço	`subject`, `description`, `source`, `priority`, `status`, `email`
`update_ticket`	Atualizar tickets existentes	`ticket_id`, `updates`
`delete_ticket`	Remover tickets	`ticket_id`
`filter_tickets`	Encontrar tickets que correspondem aos critérios	`query`
`get_ticket_fields`	Recuperar definições de campos de tickets	Nenhum
`get_tickets`	Listar todos os tickets com paginação	`page`, `per_page`
`get_ticket_by_id`	Recuperar detalhes de um único ticket	`ticket_id`

Gerenciamento de Mudanças

Ferramenta	Descrição	Parâmetros Principais
`get_changes`	Listar todas as mudanças com paginação	`page`, `per_page`, `query`
`filter_changes`	Filtrar mudanças com consultas avançadas	`query`, `page`, `per_page`
`get_change_by_id`	Recuperar detalhes de uma única mudança	`change_id`
`create_change`	Criar nova solicitação de mudança	`requester_id`, `subject`, `description`, `priority`, `impact`, `status`, `risk`, `change_type`
`update_change`	Atualizar mudança existente	`change_id`, `change_fields`
`close_change`	Fechar mudança com explicação do resultado	`change_id`, `change_result_explanation`
`delete_change`	Remover mudança	`change_id`
`get_change_tasks`	Obter tarefas de uma mudança	`change_id`
`create_change_note`	Adicionar nota à mudança	`change_id`, `body`

🚨 Importante: Sintaxe de Consulta para Filtragem

Ao usar get_changes ou filter_changes com o parâmetro query, a string de consulta deve estar entre aspas duplas para que a API do Freshservice funcione corretamente:

✅ CORRETO: "status:3", "approval_status:1 AND status:<6"
❌ ERRADO: status:3 (causará erro 500 Internal Server Error)

Exemplos Comuns de Consulta:

"status:3" - Mudanças aguardando aprovação
"approval_status:1" - Mudanças aprovadas
"approval_status:1 AND status:<6" - Mudanças aprovadas que não estão fechadas
"planned_start_date:>'2025-07-14'" - Mudanças iniciando após data específica
"status:3 AND priority:1" - Mudanças de alta prioridade aguardando aprovação

Começando

Instalação via Smithery

Para instalar o freshservice_mcp automaticamente via Smithery:

npx -y @smithery/cli install @effytech/freshservice_mcp --client claude

Pré-requisitos

Uma conta Freshservice (cadastre-se em freshservice.com)
Chave de API do Freshservice
uvx instalado (pip install uv ou brew install uv)

Configuração

Gere sua chave de API do Freshservice no painel administrativo:
- Navegue até Configurações de Perfil → Configurações de API
- Copie sua chave de API para configuração
Configure seu domínio e detalhes de autenticação conforme mostrado abaixo

Uso com Claude Desktop

Instale o Claude Desktop no site oficial
Adicione a seguinte configuração ao seu claude_desktop_config.json:

"mcpServers": {
  "freshservice-mcp": {
    "command": "uvx",
    "args": [
        "freshservice-mcp"
    ],
    "env": {
      "FRESHSERVICE_APIKEY": "<YOUR_FRESHSERVICE_APIKEY>",
      "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>"
    }
  }
}

Importante: Substitua <YOUR_FRESHSERVICE_APIKEY> pela sua chave de API real e <YOUR_FRESHSERVICE_DOMAIN> pelo seu domínio (ex.: yourcompany.freshservice.com)

Exemplos de Operações

Após a configuração, você pode pedir ao Claude para executar operações como:

Tickets:

"Criar um novo ticket de incidente com o assunto 'Problema de conectividade de rede no departamento de Marketing' e descrição 'Usuários não conseguem se conectar ao Wi-Fi na área de Marketing', definir prioridade como alta"
"Listar todos os incidentes críticos relatados nas últimas 24 horas"
"Atualizar o status do ticket #12345 para resolvido"

Mudanças:

"Criar uma solicitação de mudança para manutenção programada do servidor na próxima terça-feira às 2h"
"Atualizar o status da solicitação de mudança #45678 para 'Aprovada'"
"Fechar a mudança #5092 com explicação do resultado 'Implantado com sucesso em produção. Todos os testes passaram.'"
"Listar todas as mudanças pendentes"

Outras Operações:

"Mostrar detalhes do ativo para o laptop com etiqueta de ativo 'LT-2023-087'"
"Criar um artigo de solução sobre procedimentos de redefinição de senha"

Testes

Para fins de teste, você pode iniciar o servidor manualmente:

uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>

Solução de Problemas

Verifique se sua chave de API e domínio do Freshservice estão corretos
Garanta conectividade de rede adequada aos servidores do Freshservice
Verifique os limites de taxa e cotas da API
Verifique se o comando uvx está disponível no seu PATH

Licença

Este servidor MCP é licenciado sob a Licença MIT. Consulte o arquivo LICENSE no repositório do projeto para obter detalhes completos.

Recursos Adicionais

Feito com ❤️ por effy