Shiftbrook MCP by usefulapi

Read shifts, people, leave and timesheets; add people and approve leave in Shiftbrook.

使うべきか

品質と安全性

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

検出事項(1)

  • LOWTool 'shiftbrook_approve_leave_request' name length outside 3-30 rangeshiftbrook_approve_leave_request 内

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

コンテキストコスト

~1,860トークン数(ツール定義)
~855 B一般的なレスポンスサイズ
注意への影響は中程度(128k コンテキストの 1.45%)

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

インストール

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

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "shiftbrook": {
      "url": "https://shiftbrook.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://shiftbrook.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(14)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢shiftbrook_check_key

Check that the API key is valid. Returns the organisation name. Shiftbrook GET /api/v1/auth/test.

入力スキーマ

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_people(limit, cursor, status)

List people in the organisation, with open invites. Use status to filter. Shiftbrook GET /api/v1/people.

入力スキーマ

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "nextCursor from the previous page.",
      "type": "string"
    },
    "status": {
      "description": "Filter by status, as the Shiftbrook API defines it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_get_person(person_id)

Get one person by id. Shiftbrook GET /api/v1/people/{id}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "person_id": {
      "type": "string",
      "minLength": 1,
      "description": "The person id."
    }
  },
  "required": [
    "person_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴shiftbrook_create_person(name, email, role)

Add a person to the organisation. Shiftbrook sends that person an invite email. The invite token is not returned. Shiftbrook POST /api/v1/people.

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Full name."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email address for the invite."
    },
    "role": {
      "type": "string",
      "minLength": 1,
      "description": "Role, as the Shiftbrook API defines it."
    }
  },
  "required": [
    "name",
    "email",
    "role"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_locations(limit, cursor)

List the organisation's locations (sites). Shiftbrook GET /api/v1/locations.

入力スキーマ

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "nextCursor from the previous page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_get_location(location_id)

Get one location by id. Shiftbrook GET /api/v1/locations/{id}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "location_id": {
      "type": "string",
      "minLength": 1,
      "description": "The location id."
    }
  },
  "required": [
    "location_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_shifts(from, to, status, limit, cursor)

List shifts in the rota, optionally between two dates. Draft shifts are not published. Shiftbrook GET /api/v1/shifts.

入力スキーマ

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, yyyy-mm-dd."
    },
    "status": {
      "description": "Filter by status, as the Shiftbrook API defines it.",
      "type": "string"
    },
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "nextCursor from the previous page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_get_shift(shift_id)

Get one shift by id. Shiftbrook GET /api/v1/shifts/{id}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "shift_id": {
      "type": "string",
      "minLength": 1,
      "description": "The shift id."
    }
  },
  "required": [
    "shift_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_leave_requests(limit, cursor, status)

List leave requests. Use status to see only pending or approved requests. Shiftbrook GET /api/v1/leave-requests.

入力スキーマ

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "nextCursor from the previous page.",
      "type": "string"
    },
    "status": {
      "description": "Filter by status, as the Shiftbrook API defines it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_get_leave_request(leave_request_id)

Get one leave request by id. Shiftbrook GET /api/v1/leave-requests/{id}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "leave_request_id": {
      "type": "string",
      "minLength": 1,
      "description": "The leave request id."
    }
  },
  "required": [
    "leave_request_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴shiftbrook_approve_leave_request(leave_request_id)

Approve one leave request. This changes the request and its approved absence. Shiftbrook POST /api/v1/leave-requests/{id}/approve.

入力スキーマ

{
  "type": "object",
  "properties": {
    "leave_request_id": {
      "type": "string",
      "minLength": 1,
      "description": "The leave request id."
    }
  },
  "required": [
    "leave_request_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_timesheets(limit, cursor, status)

List timesheets. With status 'approved', each item includes approvedHours. Shiftbrook GET /api/v1/timesheets.

入力スキーマ

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Page size, 1 to 100 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "nextCursor from the previous page.",
      "type": "string"
    },
    "status": {
      "description": "Filter by status, as the Shiftbrook API defines it.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_get_timesheet(timesheet_id)

Get one timesheet by id. Shiftbrook GET /api/v1/timesheets/{id}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "timesheet_id": {
      "type": "string",
      "minLength": 1,
      "description": "The timesheet id."
    }
  },
  "required": [
    "timesheet_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢shiftbrook_list_absences(from, to)

List approved leave that overlaps a date range, for example one month. Shiftbrook GET /api/v1/absences.

入力スキーマ

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, yyyy-mm-dd."
    },
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, yyyy-mm-dd."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

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