Jitbit Helpdesk MCP 서버

AI 어시스턴트가 Jitbit Helpdesk에서 지원 티켓을 검색하고 읽을 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. SaaS 및 온프레미스 설치 환경 모두에서 작동합니다.

⚠️ 지원 중단 알림: Jitbit은 이제 버전 11.21 이상을 실행하는 모든 SaaS 및 온프레미스 설치 환경에서 /api/mcp에 내장된 HTTP MCP 엔드포인트를 제공합니다. 이것이 AI 어시스턴트를 Jitbit에 연결하는 권장 방식입니다. 더 많은 도구를 제공하고, Jitbit 릴리스와 자동으로 동기화되며, 로컬 설치가 필요하지 않습니다. 이 npm 패키지는 곧 지원이 중단될 예정이며, 11.21 이전 버전의 온프레미스 설치 환경에만 권장됩니다. Jitbit MCP 문서를 참조하세요.

설정

두 가지 옵션:

1. 호스팅된 HTTP 엔드포인트 (권장) — Jitbit에 내장되어 있어 설치가 필요 없습니다. 버전 11.21 이상을 실행하는 SaaS 및 온프레미스 설치 환경에서 사용할 수 있습니다. Jitbit MCP 문서를 참조하세요.

2. 로컬 npm 패키지 (지원 중단) — 이 저장소이며 npx를 통해 로컬에서 실행됩니다. 온프레미스 Jitbit 버전이 11.21 미만인 경우에만 사용하세요.

옵션 1: 호스팅된 HTTP 엔드포인트

Claude Code

claude mcp add --transport http jitbit-helpdesk https://yourcompany.jitbit.com/api/mcp \
  --header "Authorization: Bearer your-api-token"

Claude Desktop, Cursor, Windsurf

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "type": "http",
      "url": "https://yourcompany.jitbit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

옵션 2: 로컬 npm 패키지

Claude Code

claude mcp add jitbit-helpdesk \
  -e JITBIT_URL=https://yourcompany.jitbit.com \
  -e JITBIT_TOKEN=your-api-token \
  -- npx -y jitbit-helpdesk-mcp

Claude Desktop, Cursor, Windsurf

설정 파일에 추가하세요:

• Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows)

• Cursor: 설정 > MCP 서버

• Windsurf: 설정 > MCP 서버

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "command": "npx",
      "args": ["-y", "jitbit-helpdesk-mcp"],
      "env": {
        "JITBIT_URL": "https://yourcompany.jitbit.com",
        "JITBIT_TOKEN": "your-api-token"
      }
    }
  }
}

환경 변수

API 토큰 가져오기

1. Jitbit Helpdesk에 로그인합니다.

2. 사용자 프로필(우측 상단 아바타 클릭)로 이동합니다.

3. "API Token" 버튼을 클릭합니다.

4. 토큰을 복사하여 JITBIT_TOKEN 값으로 사용합니다.

Related MCP server: tickiti-mcp

도구

jitbit_search_tickets

키워드나 구문으로 티켓을 검색합니다.

매개변수:

• query (문자열, 필수) — 검색 쿼리

• limit (숫자, 기본값 25) — 최대 결과 수 (1–100)

• offset (숫자, 기본값 0) — 페이지네이션 오프셋

jitbit_list_tickets

티켓을 나열하고 필터링합니다.

매개변수:

• mode (문자열, 선택 사항) — "all", "unanswered" 또는 "updated"

• status (문자열, 선택 사항) — 티켓 상태별 필터링

• limit (숫자, 기본값 25) — 최대 결과 수 (1–100)

• offset (숫자, 기본값 0) — 페이지네이션 오프셋

jitbit_get_ticket

전체 대화 스레드가 포함된 단일 티켓을 가져옵니다.

매개변수:

• ticketId (숫자, 필수) — 티켓 ID

개발

npm install
npm run build

라이선스

MIT