Freshservice MCP 서버

개요

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

Related MCP server: Freshdesk MCP Server by CData

주요 특징

• 엔터프라이즈급 Freshservice 통합 : Freshservice API 엔드포인트와의 직접적이고 안전한 통신

• AI 모델 호환성 : Claude 및 기타 AI 모델이 Freshservice를 통해 서비스 데스크 작업을 실행할 수 있도록 합니다.

• 자동화된 ITSM 관리 : 티켓 생성, 업데이트, 응답 및 자산 관리를 효율적으로 처리합니다.

• 워크플로 가속화 : 일상적인 IT 서비스 작업에서 수동 개입을 줄입니다.

지원되는 Freshservice 모듈

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

• 티켓

• 대화

• 제품

• 요청자

• 자치령 대표

• 에이전트 그룹

• 요청자 그룹

• 통조림 답변

• 통조림 응답 폴더

• 작업 공간

• 솔루션 카테고리

• 솔루션 폴더

• 솔루션 기사

구성 요소 및 도구

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

티켓 관리

시작하기

Smithery를 통해 설치

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

지엑스피1

필수 조건

• Freshservice 계정( freshservice.com 에서 가입)

• Freshservice API 키

• uvx 설치됨( pip install uv 또는 brew install uv )

구성

1. 관리자 패널에서 Freshservice API 키를 생성하세요.

   • 프로필 설정 → API 설정으로 이동합니다.

   • 구성을 위해 API 키를 복사하세요

2. 아래에 표시된 대로 도메인 및 인증 세부 정보를 설정하세요.

Claude Desktop과 함께 사용

1. 공식 웹사이트 에서 Claude Desktop을 설치하세요

2. 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 API 문서

• Claude Desktop 통합 가이드

• MCP 프로토콜 사양