帮我吧 MCP — AI 助手接入指南

本文档介绍如何将帮我吧工单系统接入 WorkBuddy 等 AI 助手，通过自然语言完成工单查询、创建、客户管理、知识库检索等日常操作。

一、获取认证信息

帮我吧 MCP 使用 HTTP Basic Auth 进行身份认证，你需要从帮我吧后台获取 API 密钥并编码为认证头。

第 1 步：创建 API 密钥

登录帮我吧管理后台（https://www.bangwo8.com）

进入 设置中心 → 开发与定制 → API 接口

使用主账号创建一个 API 密钥，授权类型选择管理员权限的坐席授权

记录下生成的 SecretID 和 SecretKey

第 2 步：生成认证头

将 SecretID:SecretKey 拼接后进行 Base64 编码：

Windows（PowerShell）：

[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("你的SecretID:你的SecretKey"))

macOS / Linux（终端）：

示例：

假设 SecretID 为 f4ff3173d4aae11b，SecretKey 为 62e54fae440ec7d893c250ec65e32e8e，则：

拼接：f4ff3173d4aae11b:62e54fae440ec7d893c250ec65e32e8e

编码结果：ZjRmZjMxNzNkNGFhZTExYjo2MmU1NGZhZTQ0MGVjN2Q4OTNjMjUwZWM2NWUzMmU4ZQ==

编码后的字符串将用于配置中的 Authorization 字段。

二、在 AI 助手中配置

可用端点

帮我吧 MCP 提供三个端点，按需选择：

端点	工具数量	包含功能	适用角色
`/mcp/user`	57 个	工单管理、客户与联系人、服务记录、知识库、附件上传	客服、一线使用者
`/mcp/admin`	34 个	自定义字段配置（查询/创建/更新/删除/选项管理）、附件上传	系统管理员、实施人员
`/mcp`	90 个	以上所有功能的合集	需要全部能力的场景

建议：日常使用优先选择 /mcp/user，仅当需要配置自定义字段时才使用 /mcp/admin。工具越少，AI 助手的响应越精准，因为给AI助手暴露太多的工具可能会让它在执行任务时犯迷糊。

在 WorkBuddy 中配置

第 1 步：打开 MCP 配置

打开 WorkBuddy

点击左侧边栏的 专家-技能-连接器 入口

点击右上角 自定义连接器 → 弹出窗口中点 配置 MCP

打开 JSON 配置编辑器

第 2 步：填写配置

根据需要的端点，选择对应的配置模板（将 <你的Base64编码凭证> 替换为第一步生成的编码字符串）：

用户端点（推荐）：

{
  "mcpServers": {
    "bangwo8-user": {
      "url": "https://www.bangwo8.com/mcp/user",
      "headers": {
        "Authorization": "Basic <你的Base64编码凭证>"
      }
    }
  }
}

管理端点：

{
  "mcpServers": {
    "bangwo8-admin": {
      "url": "https://www.bangwo8.com/mcp/admin",
      "headers": {
        "Authorization": "Basic <你的Base64编码凭证>"
      }
    }
  }
}

全量端点：

{
  "mcpServers": {
    "bangwo8": {
      "url": "https://www.bangwo8.com/mcp",
      "headers": {
        "Authorization": "Basic <你的Base64编码凭证>"
      }
    }
  }
}

同时配置多个端点：如果需要同时使用用户端点和管理端点，请使用不同的名称（如 bangwo8-user 和 bangwo8-admin），避免进程去重导致只有一个生效。

第 3 步：信任并启用

保存 JSON 配置

在连接器列表中找到新增的帮我吧连接器

点击 Trust（信任）按钮

重启 WorkBuddy 使配置生效

在其他 AI 助手中配置

对于支持 Streamable HTTP MCP 的其他客户端（如 Claude Desktop 通过 mcp-remote 桥接），配置方式类似：

{
  "mcpServers": {
    "bangwo8-user": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.bangwo8.com/mcp/user",
        "--header",
        "Authorization:Basic <你的Base64编码凭证>"
      ]
    }
  }
}

验证连接

重启后，在对话中输入：

请列出帮我吧 MCP 可用的工具列表

连接成功时，AI 助手会列出可用的帮我吧工具（如 list_tickets、create_ticket、search_contacts 等）。

三、日常使用

配置完成后，直接用自然语言描述需求即可，AI 助手会自动选择并调用对应的帮我吧工具。无需特殊格式或命令。

工单管理

查询我今天的待处理工单列表

帮我看一下工单 #36007290 的详细信息和最新回复

创建一个工单，标题是"打印机故障"，描述是"三楼会议室打印机无法正常工作"，优先级设为高

把工单 #36007290 的状态改为已解决，备注"已更换墨盒"

搜索所有包含"网络故障"关键词的工单

客户与联系人

查一下公司"腾讯科技"的详细信息

帮我搜索联系人张三的联系方式

列出最近新增的客户公司

查看客户组"VIP客户"下面有哪些客户

服务记录

查看今天的 IM 在线客服记录列表

帮我查一下最近跟客户李四的通话记录

看一下客服小王今天的远程协助记录

知识库

搜索知识库中关于"密码重置"的文章

帮我创建一条知识库条目，标题是"如何修改登录密码"

更新知识库条目 #123 的内容

自定义字段配置（管理端点）

列出工单模块的所有自定义字段

给工单模板添加一个下拉列表字段"故障类型"，选项有：硬件故障、软件故障、网络故障

删除联系人模块的"备用邮箱"字段

更新工单下拉字段"优先级"的选项列表

参考信息

工单状态：

状态码	含义
1	新建
2	已开启
3	待回应
4	已解决
5	自动关闭
6	手动关闭

工单类型：

类型码	含义
1	问题
2	事务
3	故障
4	任务

优先级：

优先级码	含义
1	低
2	正常
3	高
4	紧急

四、故障排查

常见问题

Q: AI 助手中没有看到帮我吧的工具

确认 JSON 配置已保存且格式正确（无多余逗号、引号匹配）

确认已点击 Trust 按钮信任该连接器

重启 AI 助手（配置修改后通常需要重启才能加载新的 MCP Server）

Q: 工具调用时报认证错误（401 Unauthorized）

检查 Authorization 头的值是否以 Basic 开头（注意 Basic 后有一个空格）

检查 Base64 编码是否正确——可以反向解码验证：

输出应为 SecretID:SecretKey 的格式

确认 API 密钥未被我吧后台禁用或删除

Q: 配置了两个端点但只有一个生效

AI 助手可能按连接器名称做了进程去重。确保两个配置使用不同的名称（如 bangwo8-user 和 bangwo8-admin）

修改配置后重启 AI 助手

Q: 创建工单时不知道该用哪个模板

让 AI 助手分步引导：

帮我列出所有工单模板

查看"IT支持"模板有哪些字段

用这个模板创建一个工单，标题是...

Q: 连接超时或无法连接

确认网络可以正常访问 https://www.bangwo8.com

在公司网络环境中可能需要配置代理

Q: AI 助手调用了管理端的工具（如创建自定义字段），但我只想给用户端权限

将配置中的 URL 从 /mcp 改为 /mcp/user，这样 AI 助手只能看到用户侧的 57 个工具，不会误触管理操作

9.1 MCP接入指南

帮我吧 MCP — AI 助手接入指南

目录

一、获取认证信息

第 1 步：创建 API 密钥

第 2 步：生成认证头

二、在 AI 助手中配置

可用端点

在 WorkBuddy 中配置

在其他 AI 助手中配置

验证连接

三、日常使用

工单管理

客户与联系人

服务记录

知识库

自定义字段配置（管理端点）

参考信息

四、故障排查

常见问题

9.1 MCP接入指南

帮我吧 MCP — AI 助手接入指南#

目录#

一、获取认证信息#

第 1 步：创建 API 密钥#

第 2 步：生成认证头#

二、在 AI 助手中配置#

可用端点#

在 WorkBuddy 中配置#

在其他 AI 助手中配置#

验证连接#

三、日常使用#

工单管理#

客户与联系人#

服务记录#

知识库#

自定义字段配置（管理端点）#

参考信息#

四、故障排查#

常见问题#

帮我吧 MCP — AI 助手接入指南

目录

一、获取认证信息

第 1 步：创建 API 密钥

第 2 步：生成认证头

二、在 AI 助手中配置

可用端点

在 WorkBuddy 中配置

在其他 AI 助手中配置

验证连接

三、日常使用

工单管理

客户与联系人

服务记录

知识库

自定义字段配置（管理端点）

参考信息

四、故障排查

常见问题