Jitbit Helpdesk MCP 服务器

一个 MCP (Model Context Protocol) 服务器，允许 AI 助手搜索和阅读 Jitbit Helpdesk 中的支持工单。适用于 SaaS 和本地部署版本。

⚠️ 弃用通知： Jitbit 现在在所有运行 11.21 或更高版本的 SaaS 和本地部署版本上内置了 /api/mcp HTTP MCP 端点。这是将 AI 助手连接到 Jitbit 的首选方式——它拥有更多工具，能自动与 Jitbit 版本保持同步，且无需本地安装。此 npm 包即将弃用，仅建议用于 11.21 之前的本地部署版本。请参阅 Jitbit MCP 文档。

设置

有两种选择：

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 (字符串，必需) — 搜索查询

• 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