Maintainly MCP by usefulapi
List maintenance tasks, set task assignees, comment on tasks and report work requests in Maintainly.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- LOWTool 'maintainly_get_work_request' description lacks action verbmaintainly_get_work_request에서
- LOWTool 'maintainly_add_task_comment' description lacks action verbmaintainly_add_task_comment에서
- LOWTool 'maintainly_list_task_assignment' name length outside 3-30 rangemaintainly_list_task_assignment에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"maintainly": {
"url": "https://maintainly.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://maintainly.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (9)
🟢maintainly_get_me
Return the signed-in user and every profile this token reaches, with each organisation's route key. Use it to find the organisation key.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_tasks(filter, page, per_page)
List maintenance tasks in the organisation, newest first. Filter with GitHub-style terms, such as status:open, type:reactive or due:<2026-12-31.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "GitHub-style filter terms, for example \"status:open type:reactive\". Quote values with spaces: assignee:\"Jane Smith\".",
"type": "string",
"maxLength": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page (default 100, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_get_task(task)
Return one task in full: assignees, work logs, materials, downtimes, checklists and its work request.
입력 스키마
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
}
},
"required": [
"task"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_task_assignment(task)
List the users assigned to a task and the users not assigned. Use the user guids here with maintainly_assign_task.
입력 스키마
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
}
},
"required": [
"task"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_list_work_requests(filter, page, per_page)
List work requests (problems reported for an asset or location), with their status and the task raised from each. Filter with GitHub-style terms.
입력 스키마
{
"type": "object",
"properties": {
"filter": {
"description": "GitHub-style filter terms, for example \"status:open type:reactive\". Quote values with spaces: assignee:\"Jane Smith\".",
"type": "string",
"maxLength": 500
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"per_page": {
"description": "Rows per page (default 100, max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢maintainly_get_work_request(work_request)
Return one work request with its description, reporter details, files and linked task.
입력 스키마
{
"type": "object",
"properties": {
"work_request": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "The work request guid (from maintainly_list_work_requests)."
}
},
"required": [
"work_request"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴maintainly_assign_task(task, user_guids)
Set the assignees of a task to exactly these users. Send every user who should stay assigned, because the request sets the full list. Get guids from maintainly_list_task_assignment.
입력 스키마
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
},
"user_guids": {
"minItems": 1,
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"description": "The guids of the users to assign."
}
},
"required": [
"task",
"user_guids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡maintainly_add_task_comment(task, comment)
Post a comment on a task. The comment is visible to everyone who can see the task.
입력 스키마
{
"type": "object",
"properties": {
"task": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The task number (from maintainly_list_tasks)."
},
"comment": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "The comment text."
}
},
"required": [
"task",
"comment"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡maintainly_create_work_request(title, description, location, asset_guid)
Create a work request that reports a problem. It starts as open and can become a task after review.
입력 스키마
{
"type": "object",
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Short summary of the problem."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 10000,
"description": "What is wrong and where."
},
"location": {
"description": "Where the problem is, as free text.",
"type": "string",
"maxLength": 255
},
"asset_guid": {
"description": "Optional guid of the asset the problem concerns.",
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"title",
"description"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}커뮤니티
증거