Freshdesk MCP 서버

Freshdesk와 통합된 MCP 서버 구현으로, AI 모델이 Freshdesk 모듈과 상호 작용하고 다양한 지원 작업을 수행할 수 있습니다.

특징

• Freshdesk 통합 : Freshdesk API 엔드포인트와의 원활한 상호 작용
• AI 모델 지원 : AI 모델이 Freshdesk를 통해 지원 작업을 수행할 수 있도록 합니다.
• 자동 티켓 관리 : 티켓 생성, 업데이트 및 응답 처리

구성 요소

도구

이 서버는 Freshdesk 운영을 위한 다양한 도구를 제공합니다.

• create_ticket : 새로운 지원 티켓을 생성합니다
  • 입력 :
    • subject (문자열, 필수): 티켓 제목
    • description (문자열, 필수): 티켓 설명
    • source (숫자, 필수): 티켓 소스 코드
    • priority (숫자, 필수): 티켓 우선순위 수준
    • status (숫자, 필수): 티켓 상태 코드
    • email (문자열, 선택): 요청자의 이메일
    • requester_id (숫자, 선택 사항): 요청자의 ID
    • custom_fields (객체, 선택 사항): 티켓에 설정할 사용자 정의 필드
• update_ticket : 기존 티켓 업데이트
  • 입력 :
    • ticket_id (숫자, 필수): 업데이트할 티켓의 ID
    • updates (객체, 필수): 업데이트할 필드
• delete_ticket : 티켓 삭제
  • 입력 :
    • ticket_id (숫자, 필수): 삭제할 티켓의 ID
• search_tickets : 조건에 따라 티켓 검색
  • 입력 :
    • query (문자열, 필수): 검색 쿼리 문자열
• get_ticket_fields : 모든 티켓 필드 가져오기
  • 입력 :
    • 없음
• get_tickets : 모든 티켓을 가져옵니다
  • 입력 :
    • page (번호, 선택 사항): 가져올 페이지 번호
    • per_page (숫자, 선택 사항): 페이지당 티켓 수
• get_ticket : 단일 티켓을 받으세요
  • 입력 :
    • ticket_id (숫자, 필수): 가져올 티켓의 ID

시작하기

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 freshdesk_mcp를 자동으로 설치하려면:

지엑스피1

필수 조건

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

구성

1. Freshdesk 관리자 패널에서 Freshdesk API 키를 생성하세요
2. 도메인 및 인증 세부 정보를 설정하세요

Claude Desktop과 함께 사용

1. 아직 Claude Desktop을 설치하지 않았다면 설치하세요.
2. claude_desktop_config.json 에 다음 구성을 추가하세요.

중요 참고 사항 :

• YOUR_FRESHDESK_API_KEY 실제 Freshdesk API 키로 바꾸세요.
• YOUR_FRESHDESK_DOMAIN Freshdesk 도메인(예: yourcompany.freshdesk.com )으로 바꾸세요.

예제 작업

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

• "제목을 '고객 A101의 결제 문제'로 하고 설명을 '고객 A101의 지난 달 결제 문제에 대해 문의드립니다'로 하고, 고객 이메일 주소를 a101@acme.com 으로 하고 우선순위를 높음으로 설정하여 새 티켓을 만드세요."
• "티켓 #12345의 상태를 '해결됨'으로 업데이트"
• "John Doe 에이전트에게 할당된 모든 우선 순위 티켓을 나열하세요"
• "고객 A101의 지난 30일 이내 티켓을 나열하세요"

테스트

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

문제 해결

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

특허

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