clockin MCP by usefulapi

Read employees, absences, projects and work days; create absences and time events in clockin.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
96%
이름 품질
80%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,224토큰 (도구 정의)
~1.2 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.74%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (13)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢clockin_list_employees(limit, page, include)

List employees of the company, paged. Returns id, names, email and related data. Use the ids with the other tools. Customer API: GET /v3/employees.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Rows per page (default 50, max 150).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 150
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "include": {
      "description": "One relation to include: department, files, superior, onboardingSecret or customFields.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_get_employee(employee_id, include)

Get one employee by id. Customer API: GET /v3/employees/{employee}.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Employee id (from clockin_list_employees)."
    },
    "include": {
      "description": "One relation to include: department, files, superior, onboardingSecret or customFields.",
      "type": "string"
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_search_employees(last_name)

Find employees whose last name matches exactly. Customer API: POST /v3/employees/search with scope byLastName.

입력 스키마

{
  "type": "object",
  "properties": {
    "last_name": {
      "type": "string",
      "minLength": 1,
      "description": "Last name to match exactly."
    }
  },
  "required": [
    "last_name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_list_customers(limit, page)

List customers of the company, paged. Customer API: GET /v3/customers.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Rows per page (default 50, max 150).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 150
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_get_customer(customer_id)

Get one customer by id. Customer API: GET /v3/customers/{customer}.

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Customer id (from clockin_list_customers)."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_list_absences(limit, page)

List absences (vacation, sick days, workshops and similar), paged. Customer API: GET /v3/absences.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Rows per page (default 50, max 150).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 150
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_search_absences(starts_from, approvals)

Find absences by start time (from this date-time on) and/or approval state. Pass at least one filter. Customer API: POST /v3/absences/search with scopes byStartsAt and byApprovals.

입력 스키마

{
  "type": "object",
  "properties": {
    "starts_from": {
      "description": "Only absences that start at or after this ISO 8601 date-time.",
      "type": "string",
      "minLength": 1
    },
    "approvals": {
      "description": "Approval states to include.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "denied",
          "granted",
          "pending"
        ]
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_get_absence(absence_id)

Get one absence by id. Customer API: GET /v3/absences/{absence}.

입력 스키마

{
  "type": "object",
  "properties": {
    "absence_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Absence id (from clockin_list_absences)."
    }
  },
  "required": [
    "absence_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_list_projects(limit, page, include)

List projects, paged. Use include=employees,subProjects for the assigned staff and sub-projects. Customer API: GET /v3/projects.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Rows per page (default 50, max 150).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 150
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "include": {
      "description": "Comma-separated relations to include, for example employees,subProjects or signedUrl.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_get_project(project_id, include)

Get one project by id. Customer API: GET /v3/projects/{project}.

입력 스키마

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Project id (from clockin_list_projects)."
    },
    "include": {
      "description": "Comma-separated relations to include, for example employees,subProjects or signedUrl.",
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢clockin_search_workdays(employee_ids, start_date, end_date)

Get the work days of employees for a date range. Each day lists its activities (start, end, project_id) and events. Sum activities by project_id for project hours. Customer API: POST /v3/workdays/search.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_ids": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      },
      "description": "Employee ids to include."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, yyyy-mm-dd."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, yyyy-mm-dd."
    }
  },
  "required": [
    "employee_ids",
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴clockin_create_absence(employee_id, absencecategory_name, starts_at, ends_at, approval, ...)

WRITE: create an absence for one employee. absencecategory_name must match an absence category set up in clockin (for example workshop). approval is denied, granted or pending. Customer API: POST /v3/absences.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Employee id."
    },
    "absencecategory_name": {
      "type": "string",
      "minLength": 1,
      "description": "Absence category name set up in clockin."
    },
    "starts_at": {
      "type": "string",
      "minLength": 1,
      "description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
    },
    "ends_at": {
      "type": "string",
      "minLength": 1,
      "description": "ISO 8601 date-time, for example 2026-11-02T08:00:00+01:00."
    },
    "approval": {
      "type": "string",
      "enum": [
        "denied",
        "granted",
        "pending"
      ]
    },
    "duration": {
      "description": "How the duration is set.",
      "type": "string",
      "enum": [
        "full_day",
        "half_day",
        "start_end"
      ]
    }
  },
  "required": [
    "employee_id",
    "absencecategory_name",
    "starts_at",
    "ends_at",
    "approval"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴clockin_create_event(employee_id, occured_at, task_id, task_label, project_id)

WRITE: record a clock event for one employee, for example a back-dated start of work. task_id: 2 LOADING_TIME, 3 DRIVING_TIME, 4 PROJECT, 5 PAUSE, 6 SPECIAL_1, 7 SPECIAL_2, 8 LOGOUT, 9 BUSINESS_TRIP, 10 WORKING_TIME. Customer API: POST /v3/events.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "Employee id."
    },
    "occured_at": {
      "type": "string",
      "minLength": 1,
      "description": "When the event happened, ISO 8601."
    },
    "task_id": {
      "type": "integer",
      "minimum": 2,
      "maximum": 10,
      "description": "Task id, 2 to 10 (see description)."
    },
    "task_label": {
      "description": "Custom task label. Only configured label and task id pairs are valid.",
      "type": "string"
    },
    "project_id": {
      "description": "Project id, for project time.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "employee_id",
    "occured_at",
    "task_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 13개