Інструменти MCP

Кожен інструмент сервера MCP, записаний з його власних визначень. Підключити асистента налаштовує сервер. Асистент читає повний опис кожного інструмента в tools/list. Описи аргументів там, як і тут, англійською.

documents:read

get_document

Читає один документ як ocost.document.v1, як GET /public/v1/documents/{document_id}.

АргументТипЗміст
document_iduuid, обов'язковоAn id Ocost gave (a UUID)
JSON
{
  "name": "get_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11"
  }
}

get_file

Повертає статус файлу, причину і документи, як GET /public/v1/files/{file_id}.

АргументТипЗміст
file_iduuid, обов'язковоAn id Ocost gave (a UUID)
JSON
{
  "name": "get_file",
  "arguments": {
    "file_id": "01a1b08c-6e3a-7562-8f4a-7924722667b1"
  }
}

list_files

Перелічує файли за останньою зміною, від найстаріших, як GET /public/v1/files.

АргументТипЗміст
statusсписок received, reading, read, not_read, failed, needs_companyOnly files in these statuses
updated_sincedate-timeFiles changed at or after this time (ISO 8601)
external_refstringOnly the files carrying this id of yours among their external_refs
cursorstringnext_cursor of the page before
limitinteger 1–100, типово 50Файлів на сторінку.
JSON
{
  "name": "list_files",
  "arguments": {
    "status": ["read", "not_read", "failed"],
    "updated_since": "2026-11-09T08:00:00Z"
  }
}

read_document

Читає сторінки документа як текст, до 4 сторінок і 12 000 символів.

АргументТипЗміст
document_iduuid, обов'язковоІдентифікатор документа.
pagesсписок integerНомери сторінок файлу, які треба прочитати.
JSON
{
  "name": "read_document",
  "arguments": {
    "document_id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11",
    "pages": [1, 2]
  }
}

find_documents

Перелічує документи від найновіших, за видом, групою або компанією.

АргументТипЗміст
kindacceptance_protocol, agreement, bonus_payment_notification, … (82 значень)Один тип документа, як kind_detail їх перелічує в Значення.
company_iduuidІдентифікатор компанії, з find_company.
familyinvoices, payments, buying, contracts, reports, people, otherГрупа видів, наприклад invoices або contracts.
JSON
{
  "name": "find_documents",
  "arguments": {
    "kind": "credit_note",
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_contracts

Перелічує договори з їхнім строком, повідомленням про розірвання і регулярними сумами.

АргументТипЗміст
company_iduuidІдентифікатор компанії, з find_company.
JSON
{
  "name": "find_contracts",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

find_company

Знаходить постачальників і клієнтів за назвою, з їхніми ідентифікаторами.

АргументТипЗміст
namestring, типово ""Частина назви. Без неї перелічуються всі.
countrystringЛише компанії, чия основна адреса в цій країні (ISO 3166-1 alpha-2, DE).
relationsupplier, customerЛише постачальники або лише клієнти.
JSON
{
  "name": "find_company",
  "arguments": {
    "name": "Musterbüro"
  }
}

find_project

Знаходить проєкти за назвою, з їхніми ідентифікаторами.

АргументТипЗміст
namestring, типово ""Частина назви. Без неї перелічуються всі.
JSON
{
  "name": "find_project",
  "arguments": {
    "name": "Neubau"
  }
}

company_documents

Перелічує документи компанії в обох напрямах, до 30.

АргументТипЗміст
company_iduuid, обов'язковоІдентифікатор компанії, з find_company.
JSON
{
  "name": "company_documents",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

invoice_detail

Показує один рахунок так, як його сторінка в Ocost: суми, строк оплати, знижку, замовлення та історію.

АргументТипЗміст
invoice_iduuid, обов'язковоІдентифікатор рахунку.
JSON
{
  "name": "invoice_detail",
  "arguments": {
    "invoice_id": "01a1b08c-8c3d-7f41-a2b5-3e4f5a6b7c8d"
  }
}

open_decisions

Перелічує відкриті рішення підключеної людини, спершу ті, що мають найближчий строк.

Лише через з'єднання OAuth, від імені людини, яка його дозволила.

АргументТипЗміст
company_iduuidІдентифікатор компанії, з find_company.
project_iduuidІдентифікатор проєкту, з find_project.
JSON
{
  "name": "open_decisions",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

check_invoice

Перевіряє рахунки постачальників за § 14 UStG і чи є кожен електронним рахунком.

АргументТипЗміст
document_idsсписок uuidРахунки для перевірки, за їхніми ідентифікаторами.
company_iduuidІдентифікатор компанії, з find_company.
issued_sincedateДата документа, від.
issued_untildateДата документа, до.
only_missingboolean, типово falseЛише рахунки, у яких чогось бракує.
titlestringНазва таблиці.
JSON
{
  "name": "check_invoice",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c",
    "issued_since": "2026-01-01",
    "only_missing": true
  }
}

documents:write

send_file

Надсилає файл як base64, як POST /public/v1/files.

АргументТипЗміст
filenamestring, обов'язковоIts name, e.g. bill.pdf
content_base64string, обов'язковоThe file's bytes in base64: a PDF, an image (JPEG, PNG, TIFF, WebP), a Word file (.docx, .doc) or an e-invoice's XML (XRechnung, UBL, CII), at most 25 MB
external_refstringYour own id for it, e.g. an Odoo bill's 'account.move,42'; kept and given back, beside the ones sent with the same bytes before
JSON
{
  "name": "send_file",
  "arguments": {
    "filename": "invoice.pdf",
    "content_base64": "JVBERi0xLjcK…",
    "external_ref": "account.move,42"
  }
}

search:read

search_documents

Шукає в тексті документів: за точним текстом, ключовими словами, змістом або за обома.

АргументТипЗміст
querystring, обов'язковоЩо знайти.
matchexact, keywords, meaning, hybrid, типово "hybrid"exact як написано, keywords за словами, meaning за змістом, hybrid за обома.
document_iduuidШукати лише в цьому документі.
kindsсписок acceptance_protocol, agreement, bonus_payment_notification, … (82 значень)Лише ці типи документів, як kind_detail їх перелічує в Значення.
familyinvoices, payments, buying, contracts, reports, people, otherГрупа видів, наприклад invoices або contracts.
company_iduuidІдентифікатор компанії, з find_company.
project_iduuidІдентифікатор проєкту, з find_project.
site_iduuidІдентифікатор майданчика.
issued_sincedateДата документа, від.
issued_untildateДата документа, до.
due_sincedateСтрок оплати рахунку, від.
due_untildateСтрок оплати рахунку, до.
gross_minдесяткове числоСума брутто від, у валюті компанії.
gross_maxдесяткове числоСума брутто до, у валюті компанії.
directionincoming, outgoingincoming від постачальників, outgoing клієнтам.
statusopen, paidСтатус рахунку: open або paid.
categorystringКод ECLASS будь-якого рівня, з find_category.
limitintegerЩонайбільше скільки рядків.
titlestringНазва таблиці.
JSON
{
  "name": "search_documents",
  "arguments": {
    "query": "Bürostuhl",
    "match": "hybrid",
    "kinds": ["invoice"],
    "issued_since": "2026-01-01"
  }
}

search

Шукає документи для глибокого дослідження і знань компанії в ChatGPT.

АргументТипЗміст
querystring, обов'язковоWhat to find
JSON
{
  "name": "search",
  "arguments": {
    "query": "Wartungsvertrag Aufzug"
  }
}

fetch

Отримує результат search повністю: його перші чотири сторінки, до 12 000 символів.

АргументТипЗміст
idstring, обов'язковоA result's id
JSON
{
  "name": "fetch",
  "arguments": {
    "id": "01a1b08c-7aa1-7b52-9d4e-2f1f1c0c4f11"
  }
}

figures:read

find_category

Перетворює слова будь-якою з мов Ocost на коди ECLASS.

АргументТипЗміст
wordsstring, обов'язковоСлова для категорії будь-якою з мов Ocost.
JSON
{
  "name": "find_category",
  "arguments": {
    "words": "Büromaterial"
  }
}

company_profile

Підсумовує останні 12 місяців компанії: куплене, продане, умови, відкриті позиції і строки оплати.

АргументТипЗміст
company_iduuid, обов'язковоІдентифікатор компанії, з find_company.
JSON
{
  "name": "company_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

project_overview

Порівнює план проєкту з витраченим і зарезервованим, за постачальниками і місяцями.

АргументТипЗміст
project_iduuid, обов'язковоІдентифікатор проєкту, з find_project.
JSON
{
  "name": "project_overview",
  "arguments": {
    "project_id": "01a1b08c-4b1c-7d20-9a4b-2c3d4e5f6a7b"
  }
}

query_figures

Підсумовує записи для діаграми, порівняння або підрахунку.

АргументТипЗміст
sourcedocuments, lines, invoices, … (11 значень), обов'язковоЩо підсумовувати, наприклад invoices або lines.
group_byсписок об'єкт (field, bucket, level), обов'язковоОдне або два поля: рядки, потім стовпці.
measureоб'єкт (agg, field, signed)Що підсумовувати: кількість або суму, середнє, мінімум чи максимум поля.
filtersсписок об'єкт (field, values, since, until, min, max)Умови для полів джерела.
yearintegerРік для підсумку. period його замінює.
compareprevious_period, previous_yearПорівняти з попереднім періодом або з тим самим періодом роком раніше.
top_nintegerЛише найбільші групи.
matchingоб'єкт (query, match)Лише документи, які знаходить пошук.
titlestringНазва таблиці.
periodstringЗвичайними словами, наприклад 2025, Q3 2025 або last year.
JSON
{
  "name": "query_figures",
  "arguments": {
    "source": "invoices",
    "measure": {"agg": "sum", "field": "net"},
    "group_by": [{"field": "company"}],
    "filters": [{"field": "direction", "values": ["incoming"]}],
    "period": "2025",
    "top_n": 10
  }
}

top_companies

Ранжує найбільших постачальників або клієнтів за сумою нетто за період.

АргументТипЗміст
sidesuppliers, customers, типово "suppliers"Постачальники (типово) або клієнти.
periodstringЗвичайними словами, наприклад 2025, Q3 2025 або last year.
sincedateВід цієї дати.
untildateДо цієї дати.
categorystringКод ECLASS або слова.
ninteger, типово 10Скільки перелічити.
titlestringНазва таблиці.
JSON
{
  "name": "top_companies",
  "arguments": {
    "side": "suppliers",
    "period": "2025",
    "n": 10
  }
}

spend_over_time

Дає суму нетто за місяцями, кварталами або роками, на запит — за компаніями чи категоріями.

АргументТипЗміст
periodstringЗвичайними словами, наприклад 2025, Q3 2025 або last year.
bucketmonth, quarter, year, типово "month"Місяць (типово), квартал або рік.
bycompany, categoryСтовпець на кожну компанію або на кожен сегмент ECLASS.
sidesuppliers, customers, типово "suppliers"Постачальники (типово) або клієнти.
sincedateВід цієї дати.
untildateДо цієї дати.
titlestringНазва таблиці.
JSON
{
  "name": "spend_over_time",
  "arguments": {
    "period": "last 12 months",
    "bucket": "month",
    "by": "company"
  }
}

largest_documents

Перелічує найбільші документи за сумою брутто за період.

АргументТипЗміст
kindstringВид, відмінний від рахунків до оплати, наприклад credit_note.
sidesuppliers, customers, типово "suppliers"Постачальники (типово) або клієнти.
periodstringЗвичайними словами, наприклад 2025, Q3 2025 або last year.
sincedateВід цієї дати.
untildateДо цієї дати.
ninteger, типово 10Скільки перелічити.
titlestringНазва таблиці.
JSON
{
  "name": "largest_documents",
  "arguments": {
    "period": "Q3 2025",
    "n": 10
  }
}

payables_due

Перелічує неоплачені рахунки постачальників зі строком оплати у вікні, спершу строки Skonto.

АргументТипЗміст
windowthis_week, next_7_days, next_14_days, next_30_days, this_monthКоли настає строк оплати рахунків.
sincedateВід цієї дати.
untildateДо цієї дати.
company_iduuidІдентифікатор компанії, з find_company.
titlestringНазва таблиці.
JSON
{
  "name": "payables_due",
  "arguments": {
    "window": "next_14_days"
  }
}

vat_preview

Попередньо показує USt-Voranmeldung за Kennzahl, щоб податковий консультант перевірив.

АргументТипЗміст
periodstringМісяць (2026-10) або квартал (2026-Q4).
kzstringKennzahl, щоб перелічити її рахунки.
titlestringНазва таблиці.
JSON
{
  "name": "vat_preview",
  "arguments": {
    "period": "2026-10"
  }
}

find_anomalies

Позначає дублікати рахунків, змінені банківські рахунки і ціни, вищі за замовлення.

АргументТипЗміст
sincedateВід цієї дати.
untildateДо цієї дати.
kindsсписок duplicate, bank_changed, price_above_orderЛише ці позначки.
titlestringНазва таблиці.
JSON
{
  "name": "find_anomalies",
  "arguments": {
    "since": "2026-08-01",
    "until": "2026-10-31",
    "kinds": ["bank_changed"]
  }
}

supplier_profile

Підсумовує постачальника за один виклик: витрати, умови, швидкість оплати, відкриті позиції і ціни.

АргументТипЗміст
company_iduuid, обов'язковоІдентифікатор компанії, з find_company.
JSON
{
  "name": "supplier_profile",
  "arguments": {
    "company_id": "01a1b08c-5c2d-7e10-8b3a-1d2e3f4a5b6c"
  }
}

exports:write

export_table

Експортує таблицю, яку повернув інший інструмент, в Excel або CSV за посиланням, дійсним 30 хвилин.

АргументТипЗміст
queryоб'єкт (tool, args), обов'язковоquery таблиці без змін, як його повернув інструмент.
titlestring, типово "Ocost"Назва таблиці.
formatxlsx, csv, типово "xlsx"Excel (xlsx, типово) або CSV.
JSON
{
  "name": "export_table",
  "arguments": {
    "query": {"tool": "top_companies", "args": {"period": "2025"}},
    "title": "Top suppliers 2025",
    "format": "xlsx"
  }
}

make_datev_export

Створює експорт DATEV за період одним ZIP за підписаним посиланням.

Лише через з'єднання OAuth, від імені людини, яка його дозволила.

АргументТипЗміст
starts_ondate, обов'язковоПерший день періоду.
ends_ondate, обов'язковоОстанній день періоду, у тому самому фінансовому році.
JSON
{
  "name": "make_datev_export",
  "arguments": {
    "starts_on": "2026-10-01",
    "ends_on": "2026-10-31"
  }
}

Див. також