Freshservice MCP Server

Vue d'ensemble

Une puissante implémentation de serveur MCP (Model Control Protocol) qui s'intègre de manière transparente avec Freshservice, permettant aux modèles d'IA d'interagir avec les modules Freshservice et d'effectuer diverses opérations de gestion des services informatiques. Ce pont d'intégration permet à vos assistants IA de gérer et de résoudre les tickets de service informatique, rationalisant ainsi votre flux de travail de support.

Caractéristiques principales

• Intégration Freshservice de niveau entreprise: Communication directe et sécurisée avec les points d'extrémité de l'API Freshservice
• Compatibilité des modèles d'IA: Permet à Claude et à d'autres modèles d'IA d'exécuter des opérations de service desk à travers Freshservice
• Gestion ITSM automatisée: Gestion efficace de la création de tickets, des mises à jour, des réponses et de la gestion des actifs
• Accélération du flux de travail: Réduire l'intervention manuelle dans les tâches de service informatique de routine

Modules Freshservice pris en charge

Ce serveur MCP supporte actuellement les opérations à travers une large gamme de modules Freshservice:

• Tickets
• Conversations
• Produits
• Demandeurs
• Agents
• Groupes d'agents
• Groupes de demandeurs
• Réponses préenregistrées
• Dossiers de réponses préenregistrées
• Espaces de travail
• Catégories de solutions
• Dossiers de solutions
• Articles de solution

Composants et outils

Le serveur fournit une boîte à outils complète pour les opérations de Freshservice :

Gestion des tickets

Commencer

Installation via Smithery

Pour installer automatiquement freshservice_mcp via Smithery :

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

Pré-requis

• Un compte Freshservice (s'inscrire sur freshservice.com)
• Une clé API Freshservice
• uvx installé(pip install uv ou brew install uv)

Configuration de l'application

1. Générez votre clé API Freshservice depuis le panneau d'administration :

   • Naviguez vers Paramètres du profil → Paramètres API
   • Copiez votre clé API pour la configuration

2. Configurez votre domaine et les détails d'authentification comme indiqué ci-dessous

Utilisation avec Claude Desktop

1. Installez Claude Desktop depuis le site officiel
2. Ajoutez la configuration suivante à votre claude_desktop_config.json:

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

Important: Remplacez <YOUR_FRESHSERVICE_APIKEY> par votre clé API réelle et <YOUR_FRESHSERVICE_DOMAIN> par votre domaine (par exemple, yourcompany.freshservice.com)

Exemple d'opérations

Une fois configuré, vous pouvez demander à Claude d'effectuer des opérations telles que :

• "Créer un nouveau ticket d'incident avec le sujet 'Problème de connectivité réseau dans le département Marketing' et la description 'Les utilisateurs ne peuvent pas se connecter au Wi-Fi dans la zone Marketing', mettre la priorité à élevée"
• "Mettre à jour le statut de la demande de changement #45678 en 'Approuvé'"
• "Liste de tous les incidents critiques signalés au cours des dernières 24 heures
• "Afficher les détails du bien pour l'ordinateur portable avec l'étiquette de bien 'LT-2023-087'"
• "Créer une demande de changement pour la maintenance programmée du serveur mardi prochain à 2 heures du matin

Tests

À des fins de test, vous pouvez démarrer le serveur manuellement :

uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<votre_clé_api> --env FRESHSERVICE_DOMAIN=<votre_domaine>

Résolution des problèmes

• Vérifiez que votre clé d'API Freshservice et votre domaine sont corrects
• Assurez-vous que la connectivité réseau aux serveurs Freshservice est correcte
• Vérifier les limites de débit et les quotas de l'API
• Vérifiez que la commande uvx est disponible dans votre PATH

Licence d'utilisation

Ce serveur MCP est sous licence MIT. Voir le fichier LICENSE dans le référentiel du projet pour plus de détails.

Ressources supplémentaires

• Documentation de l'API Freshservice
• Guide d'intégration Claude Desktop
• Spécification du protocole MCP