English Français العربية

Jitbit Helpdesk

السجل الرسمي البحث والويب

MCP server for Jitbit Helpdesk: search, list, read, and reply to support tickets from AI assistants.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http jitbit-helpdesk 'https://{helpdesk_host}/api/mcp' --header 'Authorization: <Bearer API token from your Jitbit user profile, for example Bearer your-api-token>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "jitbit-helpdesk": {
            "type": "http",
            "url": "https://{helpdesk_host}/api/mcp",
            "headers": {
                "Authorization": "<Bearer API token from your Jitbit user profile, for example Bearer your-api-token>"
            }
        }
    }
}
NPM package jitbit-helpdesk-mcp
Claude Code 
claude mcp add jitbit-helpdesk -e 'JITBIT_URL=<JITBIT_URL>' -e 'JITBIT_TOKEN=<your jitbit_token>' -- npx -y jitbit-helpdesk-mcp@2.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "jitbit-helpdesk": {
            "command": "npx",
            "args": [
                "-y",
                "jitbit-helpdesk-mcp@2.0.0"
            ],
            "env": {
                "JITBIT_URL": "<JITBIT_URL>",
                "JITBIT_TOKEN": "<your jitbit_token>"
            }
        }
    }
}

متغيرات البيئة

  • JITBIT_URL إلزامي Base URL of your Jitbit Helpdesk instance
  • JITBIT_TOKEN إلزامي سري API token from your Jitbit user profile

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Jitbit Helpdesk MCP Server
  2. Setup
  3. Tools
  4. Development
  5. License

Jitbit Helpdesk MCP Server

An MCP (Model Context Protocol) server that lets AI assistants search and read support tickets from Jitbit Helpdesk. Works with both SaaS and on-premise installations.

⚠️ Use the hosted HTTP endpoint when possible. Jitbit ships a built-in HTTP MCP endpoint at /api/mcp on all SaaS and on-premise installs running version 11.21 or later. That is the preferred way to connect AI assistants to Jitbit — no local install, always in sync with Jitbit releases. See the Jitbit MCP docs. Starting with 2.x, this npm package is a thin stdio proxy to that same endpoint, for clients that don't yet support remote HTTP MCP servers. Jitbit 11.21 or later is required. If you're on an older on-premise version, stay on jitbit-helpdesk-mcp@1.x.

Setup

Two options:

  1. Hosted HTTP endpoint (recommended) — connect your MCP client directly to Jitbit's /api/mcp. Use this whenever your client supports HTTP MCP transport.
  2. Local npm package (stdio proxy) — this repo. Use it when your MCP client only supports stdio transport. It forwards every request to {JITBIT_URL}/api/mcp and adds nothing of its own.
Option 1: Hosted HTTP endpoint
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"
      }
    }
  }
}
Option 2: Local npm package (stdio proxy)
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

Add to your config file:

  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %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"
      }
    }
  }
}
Environment Variables
VariableRequiredDescription
JITBIT_URLYesBase URL of your Jitbit instance (SaaS: https://yourcompany.jitbit.com, on-prem: your server URL)
JITBIT_TOKENYesAPI token — see below
Getting your API token
  1. Log in to your Jitbit Helpdesk
  2. Go to your User Profile (click your avatar in the top right)
  3. Click the "API Token" button
  4. Copy the token and use it as the JITBIT_TOKEN value

Tools

The proxy exposes whatever tools the connected Jitbit instance advertises at /api/mcp — typically ticket search, list, and read, plus anything Jitbit adds in later releases. Use your MCP client's tool listing (or the Jitbit MCP docs) for the up-to-date catalog.

Development

npm install
npm run build

License

MIT

الأسئلة الشائعة

ما هو Jitbit Helpdesk؟

MCP server for Jitbit Helpdesk: search, list, read, and reply to support tickets from AI assistants.

كيف أثبّت Jitbit Helpdesk؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http jitbit-helpdesk 'https://{helpdesk_host}/api/mcp' --header 'Authorization: <Bearer API token from your Jitbit user profile, for example Bearer your-api-token>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Jitbit Helpdesk إلى مفتاح API؟

نعم. يتطلب JITBIT_URL, JITBIT_TOKEN, Authorization، وتضبطها في إعداداته.

هل Jitbit Helpdesk مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Jitbit Helpdesk؟

ينشره jitbit. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.