Vision Helpdesk MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.7.4更新于 Nov 7, 2026

Triage Vision Helpdesk tickets, read conversations, find clients and manage internal handoffs.

发布方自己的服务:Ably MCP by usefulapi

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

概览

AI 生成的概览

将助手连接到 Vision Helpdesk 实例,用于分诊工单、阅读对话、查询客户并执行经确认的修改。

可以做什么
  • 查看仪表盘工单数量,列出、搜索或打开工单及其完整对话。
  • 按标签、标记、状态、优先级或类型筛选工单,并列出某部门的工单状态、优先级和类型。
  • 列出和搜索客户,读取客户的备注与工单数量。
  • 创建工单、回复工单,并为工单或客户记录添加内部备注。
  • 修改工单的状态、优先级、部门或类型,分配或取消分配客服人员,并添加标签。
  • 查看用量、提交功能请求,以及管理或取消订阅。
适用场景
适合客服与支持团队让助手汇总新进工单、查找客户历史、起草回复,或在无需切换到客服系统界面的情况下维护状态、负责人和标签。
运行要求
以仅含 URL 的远程 MCP 端点接入;服务器通过 OAuth 登录,登录页会要求填写 Vision Helpdesk 凭据。需要公开的 HTTPS 客服系统地址,以及具备 API Access 权限的管理员或客服 API 访问令牌(vis_txttoken);厂商的 Starter 套餐不包含 REST API。
安装前请注意
写入类工具会创建工单、发布回复、添加备注、修改工单属性、分配客服和添加标签;它们要求 confirm:true,应先由用户确认。回复可对客户可见并可选发送邮件,请核对可见性与邮件标志。服务按调用计费:免费版每月 50 次调用,付费版通过 Stripe 结账链接订阅,取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Vision Helpdesk MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

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

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fvision-helpdesk/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "vision-helpdesk-by-usefulapi": {
      "type": "http",
      "url": "https://vision-helpdesk.usefulapi.io/mcp"
    }
  }
}

README

Vision Helpdesk MCP by usefulapi

Connect your assistant at https://vision-helpdesk.usefulapi.io/mcp.

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://vision-helpdesk.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http vision-helpdesk https://vision-helpdesk.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "vision-helpdesk": {      "url": "https://vision-helpdesk.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Vision Helpdesk credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/vision-helpdesk/

Enter your public HTTPS helpdesk address and an admin or staff API access token (vis_txttoken). Ask your helpdesk administrator for the token if you do not already have one. Your role needs API Access permission, and the vendor's Starter plan does not include the REST API.

Use the URL of your hosted helpdesk or your publicly reachable installation, including its folder if applicable. The connector sends your token only to that address and does not follow API redirects.

Every write requires explicit confirmation. Ticket creation and replies disable customer email by default. Internal tickets stay private and cannot include client recipients or customer email flags.

Tools

ToolTypeWhat it does
vision_get_dashboard_countsreadGet dashboard counts
vision_list_ticketsreadList tickets
vision_search_ticketsreadSearch tickets by reference or subject
vision_get_ticketreadGet ticket
vision_list_tickets_by_tagreadList tickets by tag
vision_list_tickets_by_labelreadList tickets by label
vision_list_statusesreadList ticket statuses
vision_list_prioritiesreadList ticket priorities
vision_list_ticket_typesreadList ticket types
vision_list_clientsreadList clients
vision_search_clientsreadSearch clients
vision_get_client_summaryreadGet client summary
vision_create_ticketwriteCreate ticket
vision_reply_to_ticketwriteReply to ticket
vision_add_ticket_notewriteAdd ticket note
vision_add_client_notewriteAdd client note
vision_update_ticket_propertywriteUpdate ticket status, priority, department or type
vision_assign_ticket_staffwriteAssign or unassign ticket staff
vision_add_ticket_tagwriteAdd tag to ticket
vision_usage_statusmetaUsage status (free-tier meter)
vision_request_featuremetaRequest a missing feature
vision_upgrademetaUpgrade to Pro or Pro+
vision_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per helpdesk)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with vision_upgrade (it returns a Stripe Checkout link). Cancel any time with vision_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running vision_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT. An independent integration by usefulapi; not affiliated with Vision Helpdesk.

来源:servers/vision-helpdesk/README.md,提交 4046075

工具

19

vision_get_dashboard_counts

Get dashboard counts

The ticket counts of the staff dashboard (quick view): for example new, open, overdue and assigned tickets. ticket / quick_view.

无需输入参数。

vision_list_tickets

List tickets

List tickets, with at most ONE filter: a ticket id, a status id, a department id or a folder (inbox, new, overdue, assigned, trash, spam, draft). Without a filter it lists the tickets the API user can see. Status ids come from vision_list_statuses. ticket / get_tickets.

输入参数limitfolderoffsetstatus_idticket_iddepartment_idinclude_count

vision_search_tickets

Search tickets by reference or subject

Find tickets by an EXACT ticket reference (the ticket hash such as VHD-218) or an EXACT subject. Give one of them. ticket / get_tickets with a filter on ticket_hash or subject.

输入参数limitoffsetsubjectticket_hash

vision_get_ticket

Get ticket

One ticket with its fields (status, owner, priority, department...) and its posts (the conversation). ticket / ticket_details.

输入参数ticket_id必填

vision_list_tickets_by_tag

List tickets by tag

Tickets that carry a tag, by tag id. ticket / tag_search.

输入参数tag_id必填

vision_list_tickets_by_label

List tickets by label

Tickets that carry a label, by label id. ticket / search_label_tickets.

输入参数label_id必填

vision_list_statuses

List ticket statuses

The ticket statuses of a department (ids and names), for filters and status changes. ticket / get_status.

输入参数department_id必填

vision_list_priorities

List ticket priorities

The ticket priorities of a department (ids and names). ticket / get_priority.

输入参数department_id必填

vision_list_ticket_types

List ticket types

The ticket types of a department (ids and names). ticket / get_ticket_type.

输入参数department_id必填

vision_list_clients

List clients

List clients (customers), with at most ONE filter: a client id, a first name (exact), or a parent client id (lists that client's contacts). client / get_clients.

输入参数limitoffsetclient_idparent_idfirst_nameinclude_count

vision_search_clients

Search clients

Search clients by name or email text. client / list_clients.

输入参数text必填limitoffset

vision_get_client_summary

Get client summary

A client's summary: notes and ticket counts. client / get_summary.

输入参数client_id必填

vision_create_ticket

Create ticket

WRITE: confirm:true required. open a new ticket for a client, given by client id or email. By default no email and no autoresponder is sent; a normal ticket's first post is created on behalf of the client and shown to the client. Internal tickets are staff-only and cannot have client recipients or email enabled. Look up the department, status, priority and type ids first (vision_list_statuses, vision_list_priorities, vision_list_ticket_types). ticket / open_new_ticket.

输入参数ccfrom必填confirm必填message必填subject必填type_id必填internalas_clientclient_iddomain_id必填owner_idsstatus_id必填另有 6 个

vision_reply_to_ticket

Reply to ticket

WRITE: confirm:true required. add a staff reply to a ticket. Say explicitly whether the client can see it (visible_to_client) and whether it is emailed to the client (send_email, default false). ticket / reply_ticket.

输入参数from必填confirm必填message必填ticket_id必填send_emailvisible_to_client必填

vision_add_ticket_note

Add ticket note

WRITE: confirm:true required. add an internal note to a ticket (not shown to the client). ticket / add_note with notetype 0.

输入参数note必填confirm必填ticket_id必填

vision_add_client_note

Add client note

WRITE: confirm:true required. add an internal note to a client record. ticket / add_note with notetype 1.

输入参数note必填confirm必填client_id必填

vision_update_ticket_property

Update ticket status, priority, department or type

WRITE: confirm:true required. change one property of a ticket to another id: status, priority, department or type. Look the ids up first (vision_list_statuses and the like). Changing the department can change which statuses and priorities apply. ticket / update_properties.

输入参数confirm必填property必填value_id必填ticket_id必填

vision_assign_ticket_staff

Assign or unassign ticket staff

WRITE: confirm:true required. add a staff member as an owner of a ticket, or remove one. ticket / update_properties with action staff.

输入参数action必填confirm必填staff_id必填ticket_id必填

vision_add_ticket_tag

Add tag to ticket

WRITE: confirm:true required. add a tag (by title) to a ticket. ticket / add_live_tag.

输入参数tag必填confirm必填ticket_id必填

版本历史

11
  1. v1.7.4最新Nov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.2Oct 30, 2026
  11. v1.0.0Oct 30, 2026

评分

已满足适用检查项的 100%

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

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成