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 整合