Protime MCP by usefulapi
Read clockings, absences, assignments, contracts, people and departments in Protime.
使うべきか
品質と安全性
検出事項(1)
- LOWprotime_list_absence_definitions 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"protime": {
"url": "https://protime.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://protime.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(12)
🟢protime_list_clockings(from, to, person, kind, continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"person": {
"description": "Internal person IDs. Leave out for all people.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"kind": {
"type": "string",
"enum": [
"InOut",
"Reason",
"Activity",
"ActivityEnd"
]
},
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_absences(from, to, person, continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"person": {
"description": "Internal person IDs. Leave out for all people.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_assignments(from, to, person, continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"person": {
"description": "Internal person IDs. Leave out for all people.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_contracts(person, continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"person": {
"description": "Internal person IDs. Leave out for all people.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_people(person, continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"person": {
"description": "Internal person IDs. Leave out for all people.",
"maxItems": 100,
"type": "array",
"items": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_departments(continuationToken)
List all departments configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-departments.read.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_jobs(continuationToken)
List all jobs configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-jobs.read.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_work_locations(continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_shift_definitions(continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_absence_definitions(continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_list_absence_groups(continuationToken)
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.
入力スキーマ
{
"type": "object",
"properties": {
"continuationToken": {
"description": "continuationToken from the previous page (use the same other arguments).",
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢protime_get_person(id)
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.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス