Инструменты 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"
  }
}

См. также