MCP-сервер для Jitbit Helpdesk

MCP-сервер (Model Context Protocol), позволяющий ИИ-ассистентам искать и читать тикеты поддержки из Jitbit Helpdesk. Работает как с SaaS, так и с локальными (on-premise) установками.

⚠️ Уведомление об устаревании: Jitbit теперь включает встроенную HTTP MCP-конечную точку по адресу /api/mcp во всех SaaS и локальных установках версии 11.21 или новее. Это предпочтительный способ подключения ИИ-ассистентов к Jitbit — он обладает большим количеством инструментов, автоматически синхронизируется с релизами Jitbit и не требует локальной установки. Этот npm-пакет скоро будет объявлен устаревшим и рекомендуется только для локальных установок версии ниже 11.21. См. документацию Jitbit MCP.

Настройка

Два варианта:

1. Хостинговая HTTP-конечная точка (рекомендуется) — встроена в Jitbit, установка не требуется. Доступна в SaaS и локальных установках версии 11.21 или новее. См. документацию 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: Settings > MCP Servers

• Windsurf: Settings > MCP Servers

{
  "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