Jitbit Helpdesk

io.github.jitbit由 GitHub 账号 jitbit 发布v2.0.0更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行沟通与协作商业与电商

概览

AI 生成的概览

面向 Jitbit Helpdesk 的 MCP 服务器,让 AI 助手搜索、列出并阅读支持工单,并可直接回复工单。

可以做什么
在 Jitbit Helpdesk 实例中搜索和列出支持工单,筛选条件取决于实例提供的工具。读取单个工单及其详情。从助手中回复工单。工具目录由所连接的 Jitbit 实例在其 MCP 端点公布,可能随 Jitbit 版本更新而增加。
适用场景
适合客服人员或帮助台团队希望助手在不打开 Jitbit 网页界面的情况下查找、总结或答复工单的场景。支持远程 MCP 的客户端优先使用托管 HTTP 端点;npm 包用于仅支持 stdio 的客户端。
运行要求
需要 Jitbit Helpdesk 实例(SaaS 或本地部署),版本 11.21 或更高。可使用实例 /api/mcp 路径的远程 HTTP 端点并携带 Authorization bearer 头,或通过 npx 本地运行 npm 包 jitbit-helpdesk-mcp 并设置 JITBIT_URL 和 JITBIT_TOKEN。需要用户 Jitbit 个人资料中的 API 令牌,以及访问该实例的网络连接。
安装前请注意
需要 API 令牌(JITBIT_TOKEN 或 Authorization bearer 头),可访问帮助台数据,应视为机密。助手可以回复工单,即向客户发送消息,允许写入前应先行审核。工单内容会发送给 AI 助手及其模型提供商。低于 11.21 的旧版本本地部署需使用 1.x 包。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jitbit Helpdesk,将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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.

[npm version]

⚠️ 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 [email protected].

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
bash
claude mcp add --transport http jitbit-helpdesk https://yourcompany.jitbit.com/api/mcp \  --header "Authorization: Bearer your-api-token"
Claude Desktop, Cursor, Windsurf
json
{  "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
bash
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
json
{  "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

bash
npm installnpm run build

License

MIT

来源:README.md,提交 b3dfa22

工具

0
该服务器需要 API 密钥等凭据,因此 SourceWeft 无法在没有凭据的情况下读取其工具,也未收录。

版本历史

1
  1. v2.0.0最新Sep 16, 2026

评分

已满足适用检查项的 60%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分