Auvo MCP by usefulapi

List tasks, customers and receivables; create tasks and customers in Auvo.

사용해야 할까요

품질 및 안전성

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

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

컨텍스트 비용

~4,352토큰 (도구 정의)
~2.0 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 3.40%)

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

설치

원클릭 설치

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

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (19)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢auvo_list_users(filter, page, pageSize, order)

List the admin, manager and technician users of the Auvo account (paged). Auvo API: GET /users.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: userId, name, smartPhoneNumber, userType (1 user, 2 manager, 3 administrator), externalId.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_get_user(id)

Return one Auvo user by id. Auvo API: GET /users/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Record id from a list call."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_customers(filter, page, pageSize, order)

List customers of the Auvo account (paged). Auvo API: GET /customers.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, description (name), externalId, segmentId, groupId, active, dateLastUpdate, creationDate, legalName, cpfCnpj.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_get_customer(id)

Return one Auvo customer by id. Auvo API: GET /customers/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Record id from a list call."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_customer_groups(filter)

List the customer groups of the Auvo account (labels that group customers). Auvo API: GET /customergroups.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_tasks(filter, page, pageSize, order)

List field-service tasks (work orders). Filter by date range, technician, customer, team or status. Auvo API: GET /tasks.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: taskID, externalId, idUserTo, startDate and endDate (yyyy-MM-dd), type, typeList, customerId, customerGroupId, teamId, status (0 not finished, 1 auto finished, 2 manual finished, 3 auto or manual, 4 all, 5 with pendency, 6 started or finished, 7 in execution), orientation, tags, priority (1 low, 2 medium, 3 high), dateLastUpdate, questionnairesId.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_get_task(id)

Return one Auvo task by id. Auvo API: GET /tasks/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Record id from a list call."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_task_types(filter, page, pageSize, order)

List the task types (ids used when creating a task). Auvo API: GET /tasktypes.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_products(filter, page, pageSize, order)

List products (parts and stock items) of the Auvo account. Auvo API: GET /products.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, externalId, name, description, categoryId, associatedEquipmentId, active, lowerThanMinimumStock.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_services(filter, page, pageSize, order)

List services (billable work items) of the Auvo account. Auvo API: GET /services.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, title, description, externalCode, price, active, fiscalServiceId.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_equipments(filter, page, pageSize, order)

List customer equipments (assets) of the Auvo account. Auvo API: GET /equipments.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: externalId, name, identifier, associatedUserId, associatedCustomerId, parentEquipmentId, categoryId, active, warrantyStartDate, warrantyEndDate.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_teams(filter, page, pageSize, order)

List the teams of the Auvo account. Auvo API: GET /teams.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: id, description.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_tickets(filter, page, pageSize, order)

List support tickets of the Auvo account. Auvo API: GET /tickets.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: ids, status, responsableUsersIds, teamIds, customerGroupId, customerId, priorities, externalId, statusIds, startDate, endDate, startDateLastUpdate, endDateLastUpdate.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_get_ticket(id)

Return one Auvo ticket by id. Auvo API: GET /tickets/{id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1
        },
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        }
      ],
      "description": "Record id from a list call."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_invoices(filter, page, pageSize, order)

List invoices issued through Auvo. Auvo API: GET /invoices.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: customerId, status, startDate, endDate.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_receivables(filter, page, pageSize, order)

List receivables (amounts due from customers). Auvo API: GET /receivables.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: customerId, bankAccountId, status, isRecurrent, dueDateFrom, dueDateTo.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢auvo_list_expenses(filter, page, pageSize, order)

List expenses booked by users (for example travel or materials). Auvo API: GET /expenses.

입력 스키마

{
  "type": "object",
  "properties": {
    "filter": {
      "description": "Filter object sent as Auvo paramFilter. Known keys: startDate, endDate, userToId, type, id, description.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Records per page (default 10, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "order": {
      "description": "Sort direction: \"asc\" (or 0) or \"desc\" (or 1).",
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ]
        },
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴auvo_create_customer(name, externalId, email, phoneNumber, address, ...)

Create a customer in the Auvo account. Creates a new record each call. Auvo API: POST /customers.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Customer name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "externalId": {
      "description": "Your own id for this customer.",
      "type": "string",
      "maxLength": 255
    },
    "email": {
      "description": "Email addresses.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "phoneNumber": {
      "description": "Phone numbers.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "address": {
      "description": "Address.",
      "type": "string"
    },
    "cpfCnpj": {
      "description": "Brazilian CPF or CNPJ.",
      "type": "string"
    },
    "note": {
      "description": "Notes.",
      "type": "string",
      "maxLength": 5000
    },
    "segmentId": {
      "description": "Segment id from the Auvo account.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "groupsId": {
      "description": "Customer group ids from auvo_list_customer_groups.",
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "active": {
      "description": "Whether the customer is active.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴auvo_create_task(idUserFrom, orientation, priority, idUserTo, taskType, ...)

Create a field-service task for a technician. Creates a new task and notifies the assignee. Auvo API: POST /tasks.

입력 스키마

{
  "type": "object",
  "properties": {
    "idUserFrom": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "User id that opens the task (required)."
    },
    "orientation": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "Task instructions (required)."
    },
    "priority": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3,
      "description": "1 low, 2 medium, 3 high (required)."
    },
    "idUserTo": {
      "description": "User id of the technician who executes the task.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "taskType": {
      "description": "Task type id from auvo_list_task_types.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "taskDate": {
      "description": "Execution date and time, yyyy-MM-ddTHH:mm:ss.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"
    },
    "customerId": {
      "description": "Customer id from auvo_list_customers.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "teamId": {
      "description": "Team id from auvo_list_teams.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "address": {
      "description": "Address of the task.",
      "type": "string"
    },
    "latitude": {
      "description": "Latitude of the task.",
      "type": "number"
    },
    "longitude": {
      "description": "Longitude of the task.",
      "type": "number"
    },
    "checkinType": {
      "description": "Check-in type: 1 manual, 2 automatic, 3 user.",
      "type": "integer",
      "minimum": 1,
      "maximum": 3
    },
    "questionnaireId": {
      "description": "Checklist id from the Auvo account.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "externalId": {
      "description": "Your own id for this task.",
      "type": "string",
      "maxLength": 255
    }
  },
  "required": [
    "idUserFrom",
    "orientation",
    "priority"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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