Freshservice MCP Server
Overview
Una implementació potent de servidor MCP (Model Control Protocol) que s’integra sense fisura amb Freshservice, permetent que els models d’IA interactuïn amb els mòduls de Freshservice i realitzin diverses operacions de gestió de serveis IT. Aquest pont d’integració permet als teus assistents d’IA gestionar i resoldre tiquets de servei IT, optimitzant el flux de treball de suport.
Key Features
- Enterprise-Grade Freshservice Integration: Comunicació directa i segura amb els punts finals de l’API de Freshservice
- AI Model Compatibility: Permet a Claude i altres models d’IA executar operacions de servei desk a través de Freshservice
- Automated ITSM Management: Gestiona eficaçment la creació, actualització, respostes i gestió d’actius de tiquets
- Workflow Acceleration: Redueix la intervenció manual en tasques rutinàries de servei IT
Supported Freshservice Modules
Aquest servidor MCP actualment suporta operacions en una àmplia gamma de mòduls de Freshservice:
- Tickets
- Conversations
- Products
- Requesters
- Agents
- Agent Groups
- Requester Groups
- Canned Responses
- Canned Response Folders
- Workspaces
- Solution Categories
- Solution Folders
- Solution Articles
Components & Tools
El servidor proporciona un conjunt complet d’eines per a operacions de Freshservice:
Ticket Management
create_ticket– Create new service tickets. Key Parameters:subject,description,source,priority,status,emailupdate_ticket– Update existing tickets. Key Parameters:ticket_id,updatesdelete_ticket– Remove tickets. Key Parameters:ticket_idsearch_tickets– Find tickets matching criteria. Key Parameters:queryget_ticket_fields– Retrieve ticket field definitions. Key Parameters: Noneget_tickets– List all tickets with pagination. Key Parameters:page,per_pageget_ticket– Retrieve single ticket details. Key Parameters:ticket_id
Getting Started
Installing via Smithery
Per instal·lar freshservice_mcp automàticament via Smithery:
npx -y @smithery/cli install @effytech/freshservice_mcp --client claude
Prerequisites
- Un compte Freshservice (registreu-vos a freshservice.com)
- Clau API de Freshservice
uvxinstal·lat (pip install uvobrew install uv)
Configuration
- Genera la teva clau API de Freshservice des del panell d’administració:
- Navega a Profile Settings → API Settings
- Copia la clau API per a la configuració
- Configura el domini i les dades d’autenticació com es mostra a sota
Usage with Claude Desktop
- Instal·la Claude Desktop des del lloc oficial
- Afegeix la següent configuració al teu
claude_desktop_config.json:
"mcpServers": { "freshservice-mcp": { "command": "uvx", "args": [ "freshservice-mcp" ], "env": { "FRESHSERVICE_APIKEY": "<YOUR_FRESHSERVICE_APIKEY>", "FRESHSERVICE_DOMAIN": "<YOUR_FRESHSERVICE_DOMAIN>" } }
}
Important: Reemplaça <YOUR_FRESHSERVICE_APIKEY> amb la teva clau real i <YOUR_FRESHSERVICE_DOMAIN> amb el teu domini (p. ex. yourcompany.freshservice.com)
Example Operations
Un cop configurat, pots demanar a Claude que realitzi operacions com ara:
- "Create a new incident ticket with subject 'Network connectivity issue in Marketing department' and description 'Users unable to connect to Wi-Fi in Marketing area', set priority to high"
- "Update the status of change request #45678 to 'Approved'"
- "List all critical incidents reported in the last 24 hours"
- "Show asset details for laptop with asset tag 'LT-2023-087'"
- "Create a change request for scheduled server maintenance next Tuesday at 2 AM"
Testing
Per a proves, pots iniciar el servidor manualment:
uvx freshservice-mcp --env FRESHSERVICE_APIKEY=<your_api_key> --env FRESHSERVICE_DOMAIN=<your_domain>
Troubleshooting
- Verifica que la clau API i el domini de Freshservice siguin correctes
- Assegura't d’una connexió de xarxa adequada als servidors de Freshservice
- Revisa els límits i quotas d’API
- Confirma que el comandament
uvxestigui disponible al teu PATH
License
Aquest servidor MCP està llicenciat sota la MIT License. Consulta el fitxer LICENSE al repositori del projecte per a detalls complets.