Protime MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

Read clockings, absences, assignments, contracts, people and departments in Protime.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流商业与电商

概览

AI 生成的概览

托管式只读 MCP 服务,用于读取 Protime 工时数据:打卡、缺勤、排班任务、合同、人员及租户配置。

可以做什么
  • 按日期范围列出打卡、缺勤与工作任务,并通过 continuationToken 分页
  • 列出雇佣合同、人员名单,或按内部 ID 获取单个人员
  • 列出租户配置:部门、岗位、工作地点、班次定义、缺勤定义与缺勤组
  • 查看当月用量、提交功能请求、升级或取消订阅
适用场景
适合让助手在不打开 Protime 应用的情况下回答工时、休假与人员安排问题,例如上周谁打了卡、下周一谁缺勤、租户中有哪些部门和工作地点。
运行要求
远程 streamable HTTP 端点,无需本地安装。通过 OAuth 登录,首次连接时需提供租户名称、环境,以及 Protime 为该租户签发的 client ID 和 client secret。客户端配置中不要添加 API key 或 Authorization 头。每个工具需要对应的读取权限范围,例如 connector-protimeapi-clockings.read。
安装前请注意
服务器在校验后会按用户保存你的 Protime 租户凭据。它会返回姓名、工作邮箱、在职日期和合同等个人数据,但家庭住址、出生日期、银行、护照和社保信息不会返回。所有数据工具均为只读。付费方案需要花钱:Pro 为每月 9 美元或每年 90 美元,Pro+ 为每月 39 美元或每年 390 美元,通过 Stripe Checkout 链接付款,取消时当期不退款。免费方案每月 50 次调用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Protime MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fprotime/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Protime MCP by usefulapi

Use your Protime account from Claude, Cursor, or any MCP client. Read clockings, absences, assignments, contracts, people, departments, jobs and shift definitions. Hosted, no local install: connect with your own credentials.

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

Connect

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

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

On first connect you provide your tenant name, the environment and the client ID and client secret that Protime issued for your tenant. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
protime_list_clockingsreadList clockings
protime_list_absencesreadList absences
protime_list_assignmentsreadList assignments
protime_list_contractsreadList contracts
protime_list_peoplereadList people
protime_list_departmentsreadList departments
protime_list_jobsreadList jobs
protime_list_work_locationsreadList work locations
protime_list_shift_definitionsreadList shift definitions (codes and names)
protime_list_absence_definitionsreadList absence definitions (codes, groups)
protime_list_absence_groupsreadList absence groups
protime_get_personreadGet person
protime_usage_statusmetaUsage status (free-tier meter)
protime_request_featuremetaRequest a missing feature
protime_upgrademetaUpgrade to Pro or Pro+
protime_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 protime_upgrade (it returns a Stripe Checkout link). Cancel any time with protime_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running protime_upgrade before then undoes the cancel. Or write to [email protected].

License

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

来源:servers/protime/README.md,提交 4046075

工具

12

protime_list_clockings

List clockings

List time clockings (in/out, reasons, activities) for a date range. Deleted clockings have status Deleted. Location data is left out. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-clockings.read.

输入参数to必填from必填kindpersoncontinuationToken

protime_list_absences

List absences

List absence instances (leave, sickness) for a date range. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absences.read.

输入参数to必填from必填personcontinuationToken

protime_list_assignments

List assignments

List work assignments (planned and registered activities) for a date range. A date range is required. Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-assignments.read.

输入参数to必填from必填personcontinuationToken

protime_list_contracts

List contracts

List employment contracts (percentage, hours, dates). Optional person filter. Returns one page: pass continuationToken for the next. Read only. Needs scope connector-protimeapi-contracts.read.

输入参数personcontinuationToken

protime_list_people

List people

List people with name, work email and service dates. Home address, birth date, bank, passport and social security data are never returned. Optional person filter. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-people.read.

输入参数personcontinuationToken

protime_list_departments

List departments

List all departments configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-departments.read.

输入参数continuationToken

protime_list_jobs

List jobs

List all jobs configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-jobs.read.

输入参数continuationToken

protime_list_work_locations

List work locations

List all work locations configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-work-locations.read.

输入参数continuationToken

protime_list_shift_definitions

List shift definitions (codes and names)

List all shift definitions (codes and names) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-shift-definitions.read.

输入参数continuationToken

protime_list_absence_definitions

List absence definitions (codes, groups)

List all absence definitions (codes, groups) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-definitions.read.

输入参数continuationToken

protime_list_absence_groups

List absence groups

List all absence groups configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-groups.read.

输入参数continuationToken

protime_get_person

Get person

Get one person by internal ID: name, work email, service dates. Sensitive personal data is never returned. Read only. Needs scope connector-protimeapi-people.read.

输入参数id必填

版本历史

6
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成