Octadesk MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.0.1更新於 Nov 7, 2026

Search tickets, read conversations and people; create and update tickets and people in Octadesk.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商

概覽

AI 產生的概覽

面向 Octadesk 客服系統的託管 MCP 連接器:搜尋與讀取工單、對話和人員,並可建立或更新工單與人員。

可以做什麼
  • 搜尋與讀取工單,包括已儲存的自訂清單和某位請求人的全部工單
  • 依序讀取工單對話:回覆、內部備註和屬性變更
  • 依電子郵件或 ID 尋找人員,並依電子郵件或姓名搜尋請求人和客服人員
  • 建立與更新工單,包括狀態、優先順序、負責人、群組、標籤以及公開或內部留言
  • 建立與更新人員資料
  • 查看當月用量、提出缺少的功能需求並管理付費訂閱
適用情境
適合在 Octadesk 客服工作中使用:讓助理分流工單、彙整某張工單的歷程、查詢某位客戶的工單,或草擬並送出工單更新,不必切換到網頁介面。
執行需求
透過 streamable HTTP 存取的遠端端點,無需本機安裝。以 OAuth 登入,登入頁要求填寫 Octadesk 子網域、設定中的 Legacy API 權杖,以及擁有該權杖的帳戶電子郵件;伺服器會依使用者儲存這些資料。用戶端設定中不需填寫金鑰。
安裝前請注意
寫入類工具會建立和更新工單與人員,工單上的公開留言會以電子郵件寄給請求人,執行前請先確認。服務依呼叫次數計費:免費方案每月 50 次呼叫,付費方案透過 Stripe 結帳連結付款,取消後當期不退費。你的 Octadesk 憑證與權杖由第三方託管服務保存。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Octadesk MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Foctadesk/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Octadesk MCP by usefulapi

Use your Octadesk account from Claude, Cursor, or any MCP client. It searches tickets and people, reads ticket conversations, and creates and updates tickets and people. Hosted, no local install: connect with your own credentials.

Live endpoint: https://octadesk.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://octadesk.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http octadesk https://octadesk.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": {    "octadesk": {      "url": "https://octadesk.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 Octadesk credentials.

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

On first connect you provide your Octadesk subdomain (the acme part of acme.octadesk.com), your Legacy API token from Settings → API → Token API Octadesk (Legacy), and the account e-mail of the account that owns the token. The server validates them and stores them per user. No keys go in config files.

Tools

ToolTypeWhat it does
octadesk_search_ticketsreadSearch tickets
octadesk_get_ticketreadGet ticket
octadesk_get_ticket_interactionsreadGet ticket conversation
octadesk_list_requester_ticketsreadList tickets of a requester
octadesk_list_custom_ticket_listsreadList custom ticket lists
octadesk_find_person_by_emailreadFind person by e-mail
octadesk_get_personreadGet person
octadesk_search_requestersreadSearch requesters
octadesk_search_agentsreadSearch agents
octadesk_create_ticketwriteCreate ticket
octadesk_update_ticketwriteUpdate ticket
octadesk_create_personwriteCreate person
octadesk_update_personwriteUpdate person
octadesk_usage_statusmetaUsage status (free-tier meter)
octadesk_request_featuremetaRequest a missing feature
octadesk_upgrademetaUpgrade to Pro or Pro+
octadesk_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 user)$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 octadesk_upgrade (it returns a Stripe Checkout link). Cancel any time with octadesk_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running octadesk_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

來源:servers/octadesk/README.md,提交 2450437

工具

13

octadesk_search_tickets

Search tickets

Search tickets with optional filters. Returns the page of tickets plus paging fields (total_count, search_id, next_page_url). For the next page, pass the same filters with the returned search_id and page + 1. GET /tickets/search.

輸入參數pagetagstaketypenumberstatuscontentsort_bygroup_idprioritysearch_idassignee_id另有 3 個

octadesk_get_ticket

Get ticket

Get one ticket by its number, with its fields and status. GET /tickets/{number}.

輸入參數number必填

octadesk_get_ticket_interactions

Get ticket conversation

List the interactions of one ticket: replies, internal notes and property changes, in order. GET /tickets/{number}/interactions.

輸入參數number必填

octadesk_list_requester_tickets

List tickets of a requester

List the tickets of one requester. Pass last_number to read past the last ticket of the previous page. GET /tickets.

輸入參數last_numberrequester_id必填

octadesk_list_custom_ticket_lists

List custom ticket lists

List the saved custom ticket lists (views) of the account. GET /tickets/custom-lists.

無需輸入參數。

octadesk_find_person_by_email

Find person by e-mail

Find one person (requester or agent) by exact e-mail address. GET /persons?email=.

輸入參數email必填

octadesk_get_person

Get person

Get one person by id. GET /persons/{id}.

輸入參數id必填

octadesk_search_requesters

Search requesters

Search requesters (customers who open tickets) by e-mail or name. GET /persons/requesters.

輸入參數pagekeyword必填detailed

octadesk_search_agents

Search agents

Search agents (staff who work tickets) by e-mail or name. GET /persons/agents.

輸入參數pagekeyword必填detailed

octadesk_create_ticket

Create ticket

Create a ticket. Common keys of `ticket`: summary, requester ({ email, name } or { id }), idGroupAssigned, idAssigned, idPriority, idCurrentStatus, idSubject, tags (string array), comments ({ internal: { content } } for an agent-only note, { public: { content } } for a reply the requester can read). POST /tickets.

輸入參數ticket必填

octadesk_update_ticket

Update ticket

Change fields of one ticket, for example status, priority, assignee or group. Send only the fields to change. A `comments.public` entry is e-mailed to the requester. PUT /tickets/{number}.

輸入參數fields必填number必填

octadesk_create_person

Create person

Create a person (requester or agent). Send the person fields, for example email and name. POST /persons.

輸入參數person必填

octadesk_update_person

Update person

Change fields of one person. Send only the fields to change. PATCH /persons/{id}.

輸入參數id必填fields必填

版本歷史

1
  1. v1.0.1最新Nov 7, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合