Freshservice MCP 서버

개요

Freshservice와 완벽하게 통합되는 강력한 MCP(모델 제어 프로토콜) 서버 구현으로, AI 모델이 Freshservice 모듈과 상호 작용하고 다양한 IT 서비스 관리 작업을 수행할 수 있도록 지원합니다. 이 통합 브릿지를 통해 AI 어시스턴트가 IT 서비스 티켓을 관리하고 해결하여 지원 워크플로를 간소화할 수 있습니다.

주요 특징

엔터프라이즈급 Freshservice 통합 : Freshservice API 엔드포인트와의 직접적이고 안전한 통신
AI 모델 호환성 : Claude 및 기타 AI 모델이 Freshservice를 통해 서비스 데스크 작업을 실행할 수 있도록 합니다.
자동화된 ITSM 관리 : 티켓 생성, 업데이트, 응답 및 자산 관리를 효율적으로 처리합니다.
워크플로 가속화 : 일상적인 IT 서비스 작업에서 수동 개입을 줄입니다.

지원되는 Freshservice 모듈

이 MCP 서버는 현재 다양한 Freshservice 모듈에 걸친 작업을 지원합니다 .

티켓
대화
제품
요청자
자치령 대표
에이전트 그룹
요청자 그룹
통조림 답변
통조림 응답 폴더
작업 공간
솔루션 카테고리
솔루션 폴더
솔루션 기사

구성 요소 및 도구

이 서버는 Freshservice 운영을 위한 포괄적인 툴킷을 제공합니다.

티켓 관리

도구	설명	주요 매개변수
`create_ticket`	새로운 서비스 티켓 만들기	`subject` , `description` , `source` , `priority` , `status` , `email`
`update_ticket`	기존 티켓 업데이트	`ticket_id` , `updates`
`delete_ticket`	티켓 제거	`ticket_id`
`search_tickets`	조건에 맞는 티켓 찾기	`query`
`get_ticket_fields`	티켓 필드 정의 검색	없음
`get_tickets`	모든 티켓을 페이지별로 나열합니다	`page` , `per_page`
`get_ticket`	단일 티켓 세부 정보 검색	`ticket_id`

시작하기

Smithery를 통해 설치

Smithery를 통해 freshservice_mcp를 자동으로 설치하려면:

지엑스피1

필수 조건

Freshservice 계정( freshservice.com 에서 가입)
Freshservice API 키
uvx 설치됨( pip install uv 또는 brew install uv )

구성

관리자 패널에서 Freshservice API 키를 생성하세요.
- 프로필 설정 → API 설정으로 이동합니다.
- 구성을 위해 API 키를 복사하세요
아래에 표시된 대로 도메인 및 인증 세부 정보를 설정하세요.

Claude Desktop과 함께 사용

공식 웹사이트 에서 Claude Desktop을 설치하세요
claude_desktop_config.json 에 다음 구성을 추가하세요.

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

중요 : <YOUR_FRESHSERVICE_API_KEY> 실제 API 키로, <YOUR_FRESHSERVICE_DOMAIN> 도메인(예: yourcompany.freshservice.com )으로 바꾸세요.

예제 작업

구성이 완료되면 Claude에게 다음과 같은 작업을 수행하도록 요청할 수 있습니다.

"제목이 '마케팅 부서의 네트워크 연결 문제'이고 설명이 '마케팅 구역에서 사용자가 Wi-Fi에 연결할 수 없음'인 새로운 인시던트 티켓을 만들고 우선순위를 높음으로 설정합니다."
"변경 요청 #45678의 상태를 '승인됨'으로 업데이트"
"지난 24시간 동안 보고된 모든 중요 사건을 나열하세요"
"자산 태그 'LT-2023-087'이 있는 노트북의 자산 세부 정보 표시"
"다음 화요일 오전 2시에 예정된 서버 유지 관리를 위한 변경 요청을 생성하세요"

테스트

테스트 목적으로 서버를 수동으로 시작할 수 있습니다.

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

문제 해결

Freshservice API 키와 도메인이 올바른지 확인하세요
Freshservice 서버에 대한 적절한 네트워크 연결을 보장합니다.
API 속도 제한 및 할당량 확인
PATH에서 uvx 명령을 사용할 수 있는지 확인하세요.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

Freshservice MCP server