关于 Kickserv MCP by usefulapi
Kickserv MCP by usefulapi 是面向 Kickserv 用户的托管 MCP 服务,可通过 MCP 客户端查询和更新客户及工单记录,并以 OAuth 登录账户。
主要功能
- 01查询客户和工单
- 02读取备注与工时记录
- 03创建和更新客户记录
- 04创建和更新工单及任务
- 05添加备注、登记工时和费用
适用场景
- 01查看客户的工单和备注
- 02检查工单登记的工时
- 03创建工单并添加任务
- 04记录工时或工单费用
MCP 相关
它向 MCP 客户端提供客户、工单、备注、任务、工时记录和费用相关工具。服务托管于远程端点,并通过 OAuth 验证用户身份。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://kickserv.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-kickserv https://kickserv.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}在 Cursor 中打开{"servers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-usefulapi-kickserv":{"type":"http","url":"https://kickserv.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-kickserv":{"serverUrl":"https://kickserv.usefulapi.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
20| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 否 | 精确匹配的客户名称。 |
| only | string | 否 | 要返回的列名,以逗号分隔,例如 `customer_number,name`。Kickserv 建议使用此参数,可显著缩小响应并提高速度。 |
| page | integer | 否 | 页码(Kickserv 每页返回 30 条记录)。第 1 页可省略。 |
| include | array | 否 | 要嵌入的关联数据:contacts、jobs、tasks、notes、tax_entity、custom_field_assignments。 |
| billing_city | string | 否 | 账单城市。 |
| phone_number | string | 否 | 精确匹配的电话号码,例如 800-555-1212。 |
| service_city | string | 否 | 服务城市。 |
| billing_state | string | 否 | 账单州/省。 |
| email_address | string | 否 | 精确的电子邮件地址。 |
| service_state | string | 否 | 服务州/省(2 个字母的缩写)。 |
| customer_number | integer | 否 | 客户编号。 |
| service_zip_code | string | 否 | 服务 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_customers | read | 列出客户 |
kickserv_get_customer | read | 获取客户信息 |
kickserv_list_customer_jobs | read | 列出客户的工作 |
kickserv_list_jobs | read | 列出工作 |
kickserv_get_job | read | 获取工作信息 |
kickserv_list_customer_notes | read | 列出客户的备注 |
kickserv_list_job_notes | read | 列出工作的备注 |
kickserv_list_job_time_entries | read | 列出工作的工时记录 |
kickserv_get_task | read | 获取任务信息 |
kickserv_list_employees | read | 列出员工 |
kickserv_list_items | read | 列出项目 |
kickserv_create_customer | write | 创建客户 |
kickserv_update_customer | write | 更新客户 |
kickserv_add_customer_note | write | 为客户添加备注 |
kickserv_create_job | write | 创建工作 |
kickserv_update_job | write | 更新工作 |
kickserv_add_job_note | write | 为工作添加备注 |
kickserv_create_task | write | 创建任务 |
kickserv_log_time_entry | write | 记录工作工时 |
kickserv_add_job_charge | write | 为工作添加收费项目 |
kickserv_usage_status | meta | 使用情况(免费套餐用量计数) |
kickserv_request_feature | meta | 申请添加缺失功能 |
kickserv_upgrade | meta | 升级到 Pro(无限*) |
kickserv_cancel_subscription | meta | 取消 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 无关联,也未获得其认可。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。