MCP 服务器

freshservice-mcp

Enables AI models to perform IT service management operations on Freshservice, including managing tickets, changes, problems, releases, assets, projects, and more through a set of MCP tools.

README

Freshservice MCP Server

Overview

A powerful MCP (Model Context Protocol) server that integrates with Freshservice, enabling AI models to perform IT service management operations. This integration bridge empowers your AI assistants to manage tickets, changes, problems, releases, assets, projects, and more.

Key Features

36 tools organized into 13 independently loadable scopes
Dual authentication: per-user OAuth2 (via MCP gateway) with API key fallback
Multiple transports: stdio (local), SSE, and streamable-http
Dynamic form discovery: auto-discover custom fields for any entity type
Scope-based loading: load only the tool modules you need
Docker & Helm: ready for Kubernetes deployment

Architecture

Scope	Tools	Description
`tickets`	`manage_ticket`, `manage_ticket_conversation`, `manage_service_catalog`	Ticket CRUD, conversations, service catalog
`changes`	`manage_change`, `manage_change_note`, `manage_change_task`, `manage_change_time_entry`, `manage_change_approval`	Change requests with full sub-resource support
`problems`	`manage_problem`, `manage_problem_note`, `manage_problem_task`, `manage_problem_time_entry`	Problem management
`releases`	`manage_release`, `manage_release_note`, `manage_release_task`, `manage_release_time_entry`	Release management
`assets`	`manage_asset`, `manage_asset_details`, `manage_asset_relationship`	Assets/CMDB
`status_page`	`manage_status_page`, `manage_maintenance_window`	Status pages, maintenance, incidents
`departments`	`manage_department`, `manage_location`	Departments & locations
`agents`	`get_me`, `manage_agent`, `manage_agent_group`	Identity, agents & groups
`requesters`	`manage_requester`, `manage_requester_group`	Requesters & groups
`solutions`	`manage_solution`	Knowledge base
`projects`	`manage_project`, `manage_project_task`	Project management (NewGen)
`products`	`manage_product`	Product catalog
`misc`	`manage_canned_response`, `manage_workspace`	Canned responses, workspaces

Plus 2 discovery tools always loaded: discover_form_fields and clear_field_cache.

Quick Start

Local Development (API key + stdio)

FRESHSERVICE_APIKEY=<key> FRESHSERVICE_DOMAIN=yourcompany.freshservice.com freshservice-mcp

Kubernetes / Gateway (OAuth2 + SSE)

helm install freshservice-mcp oci://ghcr.io/forterro/charts/freshservice-mcp \
  --version 0.2.0 \
  --set config.FRESHSERVICE_DOMAIN=yourcompany.freshservice.com

No API key needed — the MCP gateway forwards per-user OAuth2 tokens.

Documentation

Document	Description
Authentication	API key setup, OAuth2 via gateway, creating a Freshservice OAuth app, JWT token structure
Deployment	Local, Docker, Helm chart, client configs (Claude Desktop, VS Code), transports, scopes, troubleshooting
Tools Reference	Complete reference for all 36 tools with actions and parameters
Examples	Example prompts for common operations