MCP Server

The Jitbit Helpdesk MCP (Model Context Protocol) server lets AI assistants search and read support tickets directly from your helpdesk. It works with both SaaS and self-hosted installations.

The MCP server is available as an npm package: jitbit-helpdesk-mcp.

Setup

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

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

Available Tools

Once configured, the MCP server exposes three read-only tools that the AI assistant can call automatically.

Search Tickets

Tool name: jitbit_search_tickets

Search tickets by keyword or phrase. Matches against ticket subjects and bodies.

Parameters:

• query (string, required) — search query
• limit (number, default 25) — max results (1-100)
• offset (number, default 0) — pagination offset

Example use: "Search for tickets about password reset" — the AI calls jitbit_search_tickets with query "password reset" and returns matching tickets.

List Tickets

Tool name: jitbit_list_tickets

List and filter tickets by mode and status.

Parameters:

• mode (string, optional) — "all", "unanswered", or "updated"
• status (string, optional) — filter by ticket status
• limit (number, default 25) — max results (1-100)
• offset (number, default 0) — pagination offset

Example use: "Show me unanswered tickets" — the AI calls jitbit_list_tickets with mode "unanswered".

Get Ticket

Tool name: jitbit_get_ticket

Get a single ticket with its full conversation thread, including subject, body, status, priority, category, tags, and all comments.

Parameters:

• ticketId (number, required) — the ticket ID

Example use: "Show me ticket #4521" — the AI calls jitbit_get_ticket with ticketId 4521 and returns the full ticket details and conversation history.

What You Can Do With It

Once connected, you can ask your AI assistant things like:

• "Search for tickets about SSO login issues"
• "Show me all unanswered tickets"
• "Get the details of ticket #1234"
• "Find tickets related to billing"
• "List updated tickets and summarize them"

The AI assistant handles tool selection automatically — just ask in natural language.

Security

• The MCP server is read-only — it cannot create, modify, or delete tickets
• All API calls use your personal API token, so the AI sees only what you have access to
• The token is stored locally in your MCP configuration and is never sent to third parties