帮助台MCP服务器

一个允许AI助手搜索和读取Jitbit帮助台支持票证的MCP服务器,适用于SaaS和本地安装。

  • by jitbit
  • JavaScript
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 jitbit/jitbit-helpdesk-mcp

使用说明

Jitbit帮助台MCP服务器

MCP(模型上下文协议)服务器,允许AI助手从以下位置搜索和读取支持票 Jitbit帮助台。适用于SaaS和内部部署。

⚠️ 尽可能使用托管的HTTP端点。 Jitbit在以下位置提供了一个内置的HTTP MCP端点 /api/mcp 在所有运行11.21或更高版本的SaaS和本地安装中。这是将AI助手连接到Jitbit的首选方式——无需本地安装,始终与Jitbit版本同步。看 Jitbit MCP文档.从以下内容开始 2.x,这个npm包是一个瘦的stdio代理 对于尚未支持远程HTTP MCP服务器的客户端。 需要11.21或更高版本。 如果您使用的是较旧的内部部署版本,请继续使用 jitbit-helpdesk-mcp@1.x.

设置

两种选择:

  1. 托管HTTP端点 (推荐)--将您的MCP客户端直接连接到Jitbit的 /api/mcp。每当您的客户端支持HTTP MCP传输时,请使用此选项。
  2. 本地npm包(stdio代理) --这个回购。当您的MCP客户端仅支持stdio传输时,请使用它。它将每个请求转发给 {JITBIT_URL}/api/mcp 并且没有添加任何自己的东西。

选项1:托管HTTP端点

克劳德代码

claude mcp add --transport http jitbit-helpdesk https://yourcompany.jitbit.com/api/mcp \
  --header "Authorization: Bearer your-api-token"

克劳德桌面,光标,风帆

{
  "mcpServers": {
    "jitbit-helpdesk": {
      "type": "http",
      "url": "https://yourcompany.jitbit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

选项2:本地npm包(stdio代理)

克劳德代码

claude mcp add jitbit-helpdesk \
  -e JITBIT_URL=https://yourcompany.jitbit.com \
  -e JITBIT_TOKEN=your-api-token \
  -- npx -y jitbit-helpdesk-mcp

克劳德桌面,光标,风帆

添加到您的配置文件中:

  • 克劳德桌面: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows)
  • 光标:设置>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帮助台
  2. 去你的 用户档案 (点击右上角的头像)
  3. 点击 “API令牌” 按钮
  4. 复制令牌并将其用作 JITBIT_TOKEN 价值

工具

代理暴露了连接的Jitbit实例在其上发布的任何工具 /api/mcp --通常是票搜索、列表和阅读,以及Jitbit在后续版本中添加的任何内容。使用MCP客户的工具列表(或 Jitbit MCP文档)查看最新目录。

发展

npm install
npm run build

许可证

麻省理工学院