Zendesk MCP 통합 설정 가이드

저장소 설정

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. 개발 환경에서 환경 변수를 구성하세요.
   export ZENDESK_EMAIL="your-email@example.com" export ZENDESK_TOKEN="your-zendesk-api-token" export ZENDESK_SUBDOMAIN="your-zendesk-subdomain"

프로젝트 구축

1. TypeScript 프로젝트를 빌드합니다.
   npm run build
   이렇게 하면 TypeScript 파일이 dist 디렉토리의 JavaScript로 컴파일됩니다.
2. 개발을 위해 다음을 사용할 수 있습니다.
   npm run dev

Claude 데스크톱 앱으로 설치

1. Claude Desktop 구성 파일( claude_desktop_config.json )을 업데이트합니다.
   { "tools": { "zendesk": { "command": "node", "env": { "ZENDESK_EMAIL": "internal@z3nmail.com", "ZENDESK_TOKEN": "your-zendesk-api-token", "ZENDESK_SUBDOMAIN": "your-zendesk-subdomain" }, "args": [ "/path/to/mcp-experiments/zd-mcp-server/dist/index.js" ] } } }
2. 환경 변수를 실제 Zendesk 자격 증명으로 바꾸세요.
3. 빌드한 index.js 파일의 위치와 일치하도록 경로를 업데이트합니다.
4. 변경 사항을 적용하려면 Claude Desktop 애플리케이션을 다시 시작하세요.

사용 가능한 Zendesk 도구

MCP Zendesk 통합은 다음과 같은 기능을 제공합니다.

1. zendesk_get_ticket - ID로 티켓을 검색합니다.
2. zendesk_get_ticket_details - 댓글을 포함한 티켓 세부 정보를 가져옵니다.
3. zendesk_search - Zendesk 쿼리 구문으로 티켓 검색
4. zendesk_create_ticket - 새 티켓을 만듭니다
5. zendesk_update_ticket - 티켓 속성을 업데이트합니다.
6. zendesk_add_private_note - 티켓에 내부 메모를 추가합니다.
7. zendesk_add_public_note - 티켓에 공개 댓글을 추가합니다.

인증 설정

1. Zendesk 관리 센터에서 API 토큰을 생성하세요.
   • 관리 센터 > 앱 및 통합 > API > Zendesk API로 이동하세요.
   • API 토큰을 추가하고 복사하세요
2. MCP 구성에서 이메일 주소와 API 토큰을 사용하세요.

문제 해결

• 인증 오류가 발생하면 API 토큰이 유효한지 확인하세요.
• Zendesk 하위 도메인이 올바른지 확인하세요.
• 환경 변수가 올바르게 설정되었는지 확인하세요
• 변경 후 MCP 서버를 다시 시작하세요.