Protime MCP by usefulapi
Read clockings, absences, assignments, contracts, people and departments in Protime.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWTool 'protime_list_absence_definitions' name length outside 3-30 rangein protime_list_absence_definitions
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"protime": {
"url": "https://protime.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://protime.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis