Shiftbrook MCP by usefulapi
Read shifts, people, leave and timesheets; add people and approve leave in Shiftbrook.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWshiftbrook_approve_leave_request에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거