Freshdesk MCP 서버

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

특징

• Freshdesk 통합 : Freshdesk API 엔드포인트와의 원활한 상호 작용

• AI 모델 지원 : AI 모델이 Freshdesk를 통해 지원 작업을 수행할 수 있도록 합니다.

• 자동 티켓 관리 : 티켓 생성, 업데이트 및 응답 처리

Related MCP server: mcp-jira-server

구성 요소

도구

이 서버는 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 에 다음 구성을 추가하세요.

"mcpServers": {
  "freshdesk-mcp": {
    "command": "uvx",
    "args": [
        "freshdesk-mcp"
    ],
    "env": {
      "FRESHDESK_API_KEY": "<YOUR_FRESHDESK_API_KEY>",
      "FRESHDESK_DOMAIN": "<YOUR_FRESHDESK_DOMAIN>"
    }
  }
}

중요 참고 사항 :

• YOUR_FRESHDESK_API_KEY 실제 Freshdesk API 키로 바꾸세요.

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

예제 작업

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

• "제목을 '고객 A101의 결제 문제'로 하고 설명을 '고객 A101의 지난 달 결제 문제에 대해 문의드립니다'로 하고, 고객 이메일 주소를 a101@acme.com 으로 하고 우선순위를 높음으로 설정하여 새 티켓을 만드세요."

• "티켓 #12345의 상태를 '해결됨'으로 업데이트"

• "John Doe 에이전트에게 할당된 모든 우선 순위 티켓을 나열하세요"

• "고객 A101의 지난 30일 이내 티켓을 나열하세요"

테스트

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

uvx freshdesk-mcp --env FRESHDESK_API_KEY=<your_api_key> --env FRESHDESK_DOMAIN=<your_domain>

문제 해결

• Freshdesk API 키와 도메인이 올바른지 확인하세요

• Freshdesk 서버에 대한 적절한 네트워크 연결을 확인하세요.

• API 속도 제한 및 할당량 확인

• PATH에서 uvx 명령을 사용할 수 있는지 확인하세요.

특허

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