Protime MCP by usefulapi

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

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
91%
命名の品質
78%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'protime_list_absence_definitions' name length outside 3-30 rangeprotime_list_absence_definitions 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,051トークン数(ツール定義)
~1.1 KB一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.60%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 12 件