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 集成

Ably MCP by usefulapi

io.usefulapi官方发布者

MCP server for Ably — channel history, presence, occupancy, stats, publish, and app management.

Streamable HTTP可网页运行
沟通与协作15 个工具Nov 7, 2026

Woffu MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手查询 Woffu 公司的用户、劳动合同、部门和办公地点。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapi官方发布者

面向 White Label Loyalty 的托管 MCP 服务器：浏览奖励、查看客户积分钱包与等级进度，并用积分购买奖励。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026

Weekdone MCP by usefulapi

io.usefulapi官方发布者

托管的 Weekdone 连接器，让助手读取周报、团队、目标与 KPI，并新增报告条目、评论和 KPI 数值。

Streamable HTTP可网页运行
数据与分析15 个工具Nov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapi官方发布者

托管式只读 MCP 服务器，让助手列出 WebinarKit 的网络研讨会、场次时间、系列、会议以及白标子账户。

Streamable HTTP可网页运行
商业与电商5 个工具Nov 7, 2026