Jitbit Helpdesk Mcp Server

Jitbit Helpdesk MCP サーバー

AI アシスタントがJitbit Helpdeskのサポートチケットを検索・閲覧できるMCP（Model Context Protocol）サーバーです。SaaSとオンプレミスの両方のインストールに対応しています。

⚠️ 可能な場合は、ホスト型HTTPエンドポイントを使用してください。 Jitbitには、バージョン11.21以降を実行するすべてのSaaSおよびオンプレミス環境に、/api/mcpの組み込みHTTP MCPエンドポイントが用意されています。これはAIアシスタントをJitbitに接続する推奨方法です。ローカルへのインストールが不要で、Jitbitのリリースと常に同期されます。Jitbit MCPのドキュメントをご覧ください。2.x以降、このnpmパッケージは、リモートHTTP MCPサーバーにまだ対応していないクライアント向けに、同じエンドポイントへの薄いstdioプロキシとして動作します。Jitbit 11.21以降が必要です。 古いバージョンのオンプレミス環境をお使いの場合は、[email protected]をご利用ください。

セットアップ

次の2つの方法があります。

1. ホスト型HTTPエンドポイント（推奨）— MCPクライアントをJitbitの/api/mcpに直接接続します。クライアントがHTTP MCPトランスポートに対応している場合は、こちらを使用してください。
2. ローカルnpmパッケージ（stdioプロキシ） — このリポジトリを使用します。MCPクライアントがstdioトランスポートのみに対応している場合に使用してください。すべてのリクエストを{JITBIT_URL}/api/mcpに転送し、独自の機能は追加しません。

方法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パッケージ（stdioプロキシ）

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

環境変数

変数	必須	説明
JITBIT_URL	はい	JitbitインスタンスのベースURL（SaaS：https://yourcompany.jitbit.com、オンプレミス：お使いのサーバーのURL）
JITBIT_TOKEN	はい	APIトークン。下記を参照

APIトークンの取得方法

1. Jitbit Helpdeskにログインします
2. ユーザープロフィールを開きます（右上のアバターをクリック）
3. **「API Token」**ボタンをクリックします
4. トークンをコピーし、JITBIT_TOKENの値として使用します

ツール

このプロキシは、接続先のJitbitインスタンスが/api/mcpで提供するツールを公開します。通常はチケットの検索、一覧表示、閲覧などのツールが含まれ、今後のリリースでJitbitが追加するツールも利用できます。最新のカタログは、MCPクライアントのツール一覧、またはJitbit MCPのドキュメントをご確認ください。

開発

npm install
npm run build

ライセンス

MIT