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ドキュメントを参照してください。

セットアップ

2つの選択肢があります：

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 (string, 必須) — 検索クエリ

• limit (number, デフォルト 25) — 最大結果数 (1–100)

• offset (number, デフォルト 0) — ページネーションのオフセット

jitbit_list_tickets

チケットの一覧表示とフィルタリングを行います。

パラメータ:

• mode (string, オプション) — "all", "unanswered", または "updated"

• status (string, オプション) — チケットステータスによるフィルタリング

• limit (number, デフォルト 25) — 最大結果数 (1–100)

• offset (number, デフォルト 0) — ページネーションのオフセット

jitbit_get_ticket

会話スレッド全体を含む単一のチケットを取得します。

パラメータ:

• ticketId (number, 必須) — チケットID

開発

npm install
npm run build

ライセンス

MIT