Jitbit Helpdesk Mcp Server

Jitbit Helpdesk MCP 服务

一个 MCP（Model Context Protocol）服务，可让 AI 助手搜索和阅读 Jitbit Helpdesk 中的支持工单。兼容 SaaS 和本地部署版本。

⚠️ 请尽可能使用托管 HTTP 端点。 Jitbit 在所有运行 11.21 或更高版本的 SaaS 和本地部署实例中，都内置了位于 /api/mcp 的 HTTP MCP 端点。这是将 AI 助手连接到 Jitbit 的首选方式——无需本地安装，并始终与 Jitbit 版本同步。请参阅 Jitbit MCP 文档。从 2.x 开始，此 npm 包是一个轻量的 stdio 代理，用于尚不支持远程 HTTP MCP 服务的客户端。**需要 Jitbit 11.21 或更高版本。**如果你使用的是较旧的本地部署版本，请继续使用 [email protected]。

设置

有两种方式：

1. 托管 HTTP 端点（推荐）——将 MCP 客户端直接连接到 Jitbit 的 /api/mcp。只要客户端支持 HTTP MCP 传输，就使用此方式。
2. 本地 npm 包（stdio 代理）——本仓库。适用于仅支持 stdio 传输的 MCP 客户端。它会将每个请求转发到 {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：设置 > 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"
      }
    }
  }
}

环境变量

变量	必填	说明
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