helpdashHelpdash 提供一个 **Model Context Protocol（MCP）**服务器，因此 AI 助手可以直接在你的工作区里 干活，而不用你把工单复制粘贴到聊天窗口。问一句"今天哪些工单会违反 SLA？"或者"把这个会话总结一下 用于交接"，助手就会去查询 Helpdash 本身。
本文讲的是连接器提供了什么、怎么接入，以及——值得读两遍的那部分——它不被允许做什么。
连接器提供了什么
服务器带有 46 个工具、四条现成的提示，以及一个列出所有工具可接受枚举值的资源。这些工具涵盖 工单、在线聊天、知识库、常用回复、项目与同事、仪表盘、CSAT、自动化规则、Webhook、设置、活动日志 和计费。
读取与写入始终是不同的工具。这里没有一个带 method 参数、什么都能干的 api_request 工具——
搜索工单和修改工单是权限不同的两个工具，因此一个只被授予读取权限的助手，无法通过换个参数去改动
任何东西。
那四条提示，是值得预先写好的工作流：
- 给工单分流——推荐优先级、分类和负责人。什么都不改。
- 起草客户回复——用你的知识库和常用回复写出文本。它不能发送；回复会回到你手上供你审阅。
- 总结一个会话——把一张长工单或聊天记录压缩成便于交接的内容。
- 每周支持报告——工作量、SLA、CSAT，以及需要留意的事项。
接入一个客户端
打开**设置 → AI 连接器（MCP）**并签发一个令牌。给它一个你日后认得出的标签，第一个令牌请把所有 写入开关都保持关闭，然后复制密钥——它只会显示一次。
接着注册它。对 Claude Code：
claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
--header "Authorization: Bearer hd_mcp_..."
对任何读取 .mcp.json 的客户端：
{
"mcpServers": {
"helpdash": {
"type": "http",
"url": "https://your-workspace.helpdash.io/mcp",
"headers": { "Authorization": "Bearer hd_mcp_..." }
}
}
}
这两段代码都会为你生成，并已填入你的工作区地址，就在显示令牌的同一个页面上。
更喜欢在浏览器里登录的客户端，可以用 OAuth 2.1 代替静态令牌：服务器发布标准的发现文档，支持 PKCE 和动态客户端注册，并会展示一个授权页面，逐条列出正在申请的权限范围。既没有令牌要复制，也没有 密钥要存到磁盘上。
它不能做什么
连接器不是第二套更宽松的 API。每一次调用都要过与人工请求相同的四道关。
它以你的身份行事。 令牌绑定到签发它的操作者，原样继承那个人的角色和权限——如果你在应用里打不开 一张工单，持有你令牌的助手同样打不开。而且它绑定在一个工作区上：没有任何参数能够到另一个租户的 数据。
除非你另有指示，否则只读。 一个所有开关都关着的新令牌可以搜索、阅读和出报表，仅此而已。写入 权限按领域授予——修改工单、在在线聊天中回复、编辑知识库、管理项目、邀请同事、更改设置、更改自动化 规则——并且只授予你勾选的那些。读取始终包含在内，因为一个能写不能读的助手毫无用处。
写入工具会先问。 每一个会改动数据的工具都被标注为破坏性，因此一个行为规范的客户端会在每次调用 前询问你，而不是悄悄执行。那些会触达客户的工具在自己的描述里就写明了这一点：在线聊天消息会即时送达 且无法撤回，而工单评论默认是内部备注，所以不会有东西意外发到客户那里。
密钥留在服务端。 通过连接器读取你的设置，返回的集成凭据是被遮蔽的。没有任何参数能把它揭开。
客户写的文字被围起来。 工单描述、评论和聊天记录都是别人写的，而支持收件箱恰恰是有人会试图给 读它的 AI 埋下指令的地方。Helpdash 会把这些文字包进一个明确的不可信内容块，并在服务器自己的说明中 告诉模型：其中的任何内容都不是命令。
一切都会记录。 每次调用都会连同操作者、工具和结果一起，记入与工作区其余部分相同的审计日志。 如果哪天你需要回答"助手周二到底做了什么？"，记录就在那里。
吊销立即生效。 在设置里删掉一个令牌，助手的下一次请求就会被拦下。我们只保存密钥的 SHA-256 哈希，因此无法替你找回——弄丢了就重新签发一个。
把令牌收得更紧
有两项可选控制值得知道。令牌可以带一个有效期，这是让一次短期试验自行清理的最简单办法。它还 可以带一份 IP 允许列表，好让为某台服务器准备的令牌无法从别处使用。两者都在同一个创建表单里。
一个合理的首个令牌
签发一个不带写入范围的令牌，给助手一周只读的时间。让它找出 SLA 风险、总结冗长的会话、起草由你自己 发送的回复。这几乎覆盖了全部价值，却没有任何暴露。等你清楚自己真正需要哪一项写入范围时，再签发一个 只带那一项的第二个令牌——扩展一个已有令牌是我们特意不支持的。
上面每一句话描述的都是今天已经上线的行为；这个连接器在每个 Helpdash 工作区都可以使用。