mcpField
K
Kickserv MCP by usefulapi

Kickserv MCP by usefulapi

远程服务
usefulapi.io商业与营销0今天更新

关于 Kickserv MCP by usefulapi

Kickserv MCP by usefulapi 是面向 Kickserv 用户的托管 MCP 服务,可通过 MCP 客户端查询和更新客户及工单记录,并以 OAuth 登录账户。

主要功能

  1. 01查询客户和工单
  2. 02读取备注与工时记录
  3. 03创建和更新客户记录
  4. 04创建和更新工单及任务
  5. 05添加备注、登记工时和费用

适用场景

  1. 01查看客户的工单和备注
  2. 02检查工单登记的工时
  3. 03创建工单并添加任务
  4. 04记录工时或工单费用

MCP 相关

它向 MCP 客户端提供客户、工单、备注、任务、工时记录和费用相关工具。服务托管于远程端点,并通过 OAuth 验证用户身份。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://kickserv.usefulapi.io/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

20
参数类型必填说明
namestring否精确匹配的客户名称。
onlystring否要返回的列名,以逗号分隔,例如 `customer_number,name`。Kickserv 建议使用此参数,可显著缩小响应并提高速度。
pageinteger否页码(Kickserv 每页返回 30 条记录)。第 1 页可省略。
includearray否要嵌入的关联数据:contacts、jobs、tasks、notes、tax_entity、custom_field_assignments。
billing_citystring否账单城市。
phone_numberstring否精确匹配的电话号码,例如 800-555-1212。
service_citystring否服务城市。
billing_statestring否账单州/省。
email_addressstring否精确的电子邮件地址。
service_statestring否服务州/省(2 个字母的缩写)。
customer_numberinteger否客户编号。
service_zip_codestring否服务 ZIP 邮政编码(如果记录中有完整的 ZIP+4,则使用完整值)。

详细介绍

usefulapi 提供的 Kickserv MCP

通过 Claude、Cursor 或任何 MCP 客户端使用 Kickserv——查询客户、工作、备注和工时记录,并创建或更新客户、工作、任务、备注、工时和收费项目。 托管服务,无需本地安装:使用你自己的 Kickserv 凭据连接。

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

连接

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

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

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

首次连接时,你需要提供 Kickserv 账户标识(来自 app.kickserv.com/)和 员工 API 令牌(My Account > API token)。 系统会验证这些信息,并按用户分别存储,且仅限你本人使用——配置文件中不会存放密钥。

工具

工具类型功能
kickserv_list_customersread列出客户
kickserv_get_customerread获取客户信息
kickserv_list_customer_jobsread列出客户的工作
kickserv_list_jobsread列出工作
kickserv_get_jobread获取工作信息
kickserv_list_customer_notesread列出客户的备注
kickserv_list_job_notesread列出工作的备注
kickserv_list_job_time_entriesread列出工作的工时记录
kickserv_get_taskread获取任务信息
kickserv_list_employeesread列出员工
kickserv_list_itemsread列出项目
kickserv_create_customerwrite创建客户
kickserv_update_customerwrite更新客户
kickserv_add_customer_notewrite为客户添加备注
kickserv_create_jobwrite创建工作
kickserv_update_jobwrite更新工作
kickserv_add_job_notewrite为工作添加备注
kickserv_create_taskwrite创建任务
kickserv_log_time_entrywrite记录工作工时
kickserv_add_job_chargewrite为工作添加收费项目
kickserv_usage_statusmeta使用情况(免费套餐用量计数)
kickserv_request_featuremeta申请添加缺失功能
kickserv_upgrademeta升级到 Pro(无限*)
kickserv_cancel_subscriptionmeta取消 Pro 订阅

read 工具仅供读取;write 工具会修改数据(客户端应先确认);meta 工具用于报告用量、管理订阅或发送功能申请。

定价

套餐价格限额
Free$0每月 50 次工具调用
Pro(按用户计费)$9/mo 或 $90/yr(免费使用 2 个月)无限*

*此服务上的 Pro 套餐设有每月 10,000 次工具调用的合理使用限额。如需更多,请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 kickserv_upgrade 订阅(该工具会返回 Stripe Checkout 链接)。可随时使用 kickserv_cancel_subscription 取消:Pro 将持续到已付费周期结束,当前周期不予退款;在此之前运行 kickserv_upgrade 可撤销取消操作。也可发送邮件至 [email protected]。

许可证

MIT © usefulapi。与 Kickserv 无关联,也未获得其认可。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。