MCP MeasureMCP Measure

인덱스 관측됨

Saldeo MCP by usefulapi

Read SaldeoSMART companies, contractors, documents, invoices, bank statements and employees.

사용해야 할까요

품질 및 안전성

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

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

컨텍스트 비용

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

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

설치

원클릭 설치

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

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (10)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢saldeo_list_companies(limit, offset)

List the companies (clients) the Saldeo user can see: COMPANY_PROGRAM_ID (needed by every other tool), COMPANY_ID, names, VAT number, address, bank accounts. Start here. Saldeo: GET /api/xml/3.0/company/list.

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 100). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_contractors(company_program_id, limit, offset)

List the contractors (suppliers and customers) of one company: names, VAT number (NIP), address, bank accounts, e-mails, payment days. Saldeo: GET /api/xml/3.0/contractor/list.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_search_documents(company_program_id, document_id, number, nip, guid, ...)

Find documents of one company by field (at least one of document_id, number, nip, guid; several are combined with AND). Returns the matching documents. Saldeo: POST /api/xml/3.1/document/search (policy BY_FIELDS).

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "document_id": {
      "description": "The Saldeo DOCUMENT_ID.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "number": {
      "description": "The document number, e.g. FV/101/2016.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "nip": {
      "description": "The contractor's VAT number (NIP).",
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "guid": {
      "description": "The document GUID.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_document_ids(company_program_id, year, month, limit, offset)

List the ids of all documents of one company in one month folder, grouped by type (contracts, cost/sale/internal/material invoices, orders, writings, other). Feed the ids to saldeo_get_documents_by_ids. Saldeo: POST /api/xml/3.0/document/getidlist.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month of the Saldeo folder, 1-12."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id",
    "year",
    "month"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_get_documents_by_ids(company_program_id, contracts, invoices_cost, invoices_internal, invoices_material, ...)

Get full documents of one company by id, per type (use the groups from saldeo_list_document_ids; at most 200 ids per call). Saldeo: POST /api/xml/3.1/document/listbyid.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "contracts": {
      "description": "CONTRACT ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_cost": {
      "description": "INVOICE_COST ids (cost invoices).",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_internal": {
      "description": "INVOICE_INTERNAL ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_material": {
      "description": "INVOICE_MATERIAL ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "invoices_sale": {
      "description": "INVOICE_SALE ids (sales invoices).",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "orders": {
      "description": "ORDER ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "writings": {
      "description": "WRITING ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "other_documents": {
      "description": "OTHER_DOCUMENT ids.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_invoices(company_program_id, limit, offset)

List the sales invoices of one company that were marked for export in Saldeo (policy SALDEO): number, dates, contractor, line items, amounts. Saldeo: GET /api/xml/3.0/invoice/list.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_invoice_ids(company_program_id, year, month, limit, offset)

List the ids of the invoices (invoices, corrective invoices, pre-invoices, corrective pre-invoices) of one company in one month folder. Feed them to saldeo_get_invoices_by_ids. Saldeo: POST /api/xml/3.0/invoice/getidlist.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Year of the Saldeo folder (the month the document is booked in), e.g. 2026."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month of the Saldeo folder, 1-12."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 500). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id",
    "year",
    "month"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_get_invoices_by_ids(company_program_id, invoices, corrective_invoices, pre_invoices, corrective_pre_invoices, ...)

Get full invoices of one company by id (ids from saldeo_list_invoice_ids; at most 200 per call). Saldeo: POST /api/xml/3.0/invoice/listbyid.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "invoices": {
      "description": "INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "corrective_invoices": {
      "description": "CORRECTIVE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "pre_invoices": {
      "description": "PRE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "corrective_pre_invoices": {
      "description": "CORRECTIVE_PRE_INVOICE_ID values.",
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_bank_statements(company_program_id, limit, offset)

List the bank statements of one company with their entries, contractors and links. Saldeo: GET /api/xml/3.0/bank_statement/list.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢saldeo_list_employees(company_program_id, limit, offset)

List the employees of one company (personnel module): names, acronym and HR master data. Contains personal data. Saldeo: GET /api/xml/3.0/employee/list.

입력 스키마

{
  "type": "object",
  "properties": {
    "company_program_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$",
      "description": "The company's COMPANY_PROGRAM_ID, as returned by saldeo_list_companies."
    },
    "limit": {
      "description": "Entries per list in the reply, 1-1000 (default 50). The reply's \"paging\" says how many exist and the next offset.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Skip this many entries of each list (default 0); use paging.next_offset from the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "company_program_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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