Octadesk MCP by usefulapi

usefulapi 的 Octadesk MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Octadesk 账户。它可以搜索工单和人员、读取工单对话，以及创建和更新工单与人员。托管服务，无需本地安装：使用你自己的凭据连接。

在线端点： https://octadesk.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 Customize → Connectors，点击 + Add → Add custom connector，然后粘贴 https://octadesk.usefulapi.io/mcp。
• Claude Code： 运行 claude mcp add --transport http octadesk https://octadesk.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "octadesk": {
      "url": "https://octadesk.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Octadesk 凭据。

分步设置说明、凭据查找方式和常见问题：https://usefulapi.io/octadesk/

首次连接时，你需要提供 Octadesk 子域名（acme.octadesk.com 中的 acme 部分）、从 Settings → API → Token API Octadesk (Legacy) 获取的 Legacy API 令牌，以及拥有该令牌的账户的 电子邮件地址。服务会验证这些信息并按用户存储。配置文件中无需填写密钥。

工具

工具	类型	功能
octadesk_search_tickets	读取	搜索工单
octadesk_get_ticket	读取	获取工单
octadesk_get_ticket_interactions	读取	获取工单对话
octadesk_list_requester_tickets	读取	列出请求者的工单
octadesk_list_custom_ticket_lists	读取	列出自定义工单列表
octadesk_find_person_by_email	读取	按电子邮件查找人员
octadesk_get_person	读取	获取人员
octadesk_search_requesters	读取	搜索请求者
octadesk_search_agents	读取	搜索 Agent
octadesk_create_ticket	写入	创建工单
octadesk_update_ticket	写入	更新工单
octadesk_create_person	写入	创建人员
octadesk_update_person	写入	更新人员
octadesk_usage_status	元信息	使用情况（免费套餐用量计数）
octadesk_request_feature	元信息	申请缺少的功能
octadesk_upgrade	元信息	升级到 Pro 或 Pro+
octadesk_cancel_subscription	元信息	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告用量、管理订阅或发送功能申请。

定价

套餐	价格	限制
免费	$0	每月 50 次工具调用
Pro（按用户计费）	$9/mo 或 $90/yr（免费 2 个月）	无限次*

*此服务上的 Pro 套餐每月最多可调用 10,000 次工具，遵循公平使用限制。如需更多调用次数，请写信至 [email protected]。

Pro 仅适用于此服务。使用 octadesk_upgrade 订阅（它会返回 Stripe Checkout 链接）。你可以随时使用 octadesk_cancel_subscription 取消：Pro 会持续到付费周期结束，当前周期不予退款；在此之前运行 octadesk_upgrade 可撤销取消操作。或者写信至 [email protected]。

许可证

MIT — 请参阅 LICENSE。仅提供文档；服务由托管方运行。