MCP-адаптер
Все 36 инструментов внешнего MCP-адаптера SterBase, их схемы и связь с собственным runtime API.
Внешний stdio MCP-адаптер SterBase публикует 36 инструментов и передаёт их вызовы в собственный runtime API активного Enterprise. Адаптер не создаёт второй механизм исполнения, не превращает named pipe API в HTTP REST и не использует нативный fallback.
Подключение и выбор инструмента
Запускайте адаптер из комплекта своей версии и задайте endpoint собственного Enterprise. Сначала выполните tools/list и инструмент описания сеанса. Проверяйте пользователя, базу и доступные возможности. Схемы ниже — полный справочник; состояние конкретного процесса определяется его каталогом. Подключение показано на MCP-портале.
Полные схемы внешнего MCP-адаптера
| Инструмент | Назначение | Режим |
|---|---|---|
sterbase_selection_get | Чтение ожидающего типизированного выбора, включая печатную форму; операция ничего не выбирает. | Чтение |
sterbase_selection_choose | Продолжение опубликованного выбора: index начинается с нуля, -1 отменяет. | Действие / изменение состояния |
sterbase_process_diagnostics | Диагностика выбранного собственного процесса вне его UI-потока; без повторения операций. | Чтение |
sterbase_forms_list | Реальные открытые формы без передачи владения пользовательскими окнами. | Чтение |
sterbase_form_views | Вкладки и табличные области с ревизией и токенами навигации. | Чтение |
sterbase_form_view_set | Переход к вкладке или строке через обычный обработчик, без записи и проведения. | Действие / изменение состояния |
sterbase_metadata_get | Поля метаданных, типы, длины, точность и допустимые ссылочные цели. | Чтение |
sterbase_form_set | Изменение опубликованных полей через обычные обработчики; не подтверждает запись. | Действие / изменение состояния |
sterbase_object_draft_create | Черновик справочника или документа в памяти. | Действие / изменение состояния |
sterbase_object_draft_apply | Типизированные поля и полный набор строк версии черновика. | Действие / изменение состояния |
sterbase_reference_select | Постраничный подбор типизированной ссылки с ограничениями поля. | Чтение |
sterbase_object_create | Фиксация подготовленного черновика через штатную запись; повтор того же черновика сверяет прежний результат. | Действие / изменение состояния |
sterbase_object_save | Запись полей существующего объекта с контролем версии и состояния commit. | Действие / изменение состояния |
sterbase_object_set_delete_mark | Установка или снятие пометки удаления по текущим правам. | Действие / изменение состояния |
sterbase_document_set_posted | Проведение или отмена через общий жизненный цикл; открытая карточка требует владения и ревизии. | Действие / изменение состояния |
sterbase_accounting_total | Чтение бухгалтерского показателя за период по счёту. | Чтение |
sterbase_accounting_totals_recalculate | Штатный пересчёт итогов с подтверждением, правом обслуживания и фактическим монопольным доступом. | Действие / изменение состояния |
sterbase_operation_get | Опрос запущенной операции без повторения побочных эффектов; показывает доступные дочерние формы. | Чтение |
sterbase_period_dialog_get | Чтение принадлежащего операции календарного диалога без его подтверждения. | Чтение |
sterbase_period_dialog_complete | Применение или отмена периода через штатный обработчик диалога. | Действие / изменение состояния |
sterbase_form_open | Открытие отчёта или обработки по точным метаданным. | Действие / изменение состояния |
sterbase_form_actions | Доступные действия формы с одноразовыми токенами и ревизией. | Чтение |
sterbase_form_invoke | Выполнение опубликованного действия через обычный обработчик команды. | Действие / изменение состояния |
sterbase_session_describe | Текущая база, пользователь, права, готовность и поддерживаемые операции. | Чтение |
sterbase_metadata_list | Постраничный список читаемых метаданных. | Чтение |
sterbase_object_list | Чтение справочников и документов без открытия формы. | Чтение |
sterbase_object_get | Чтение точного объекта и его полей/строк по выданному токену. | Чтение |
sterbase_list_open | Открытие списка или бухгалтерского журнала, при необходимости с периодом. | Действие / изменение состояния |
sterbase_list_period_set | Изменение периода своего журнала с сохранением фильтров и порядка. | Действие / изменение состояния |
sterbase_form_get | Семантическое состояние своей формы; закрытый токен не переадресуется другому окну. | Чтение |
sterbase_list_select | Выбор точного объекта и выполнение обработчиков позиционирования. | Действие / изменение состояния |
sterbase_list_activate | Активация объекта с учётом перенаправления формы или штатной отмены. | Действие / изменение состояния |
sterbase_form_snapshot | PNG-снимок готовой собственной формы вместе с её состоянием. | Чтение |
sterbase_form_close | Штатное закрытие собственной формы с уважением отказа обработчика. | Действие / изменение состояния |
sterbase_session_close | Закрытие только принадлежащих API форм в обратном порядке. | Действие / изменение состояния |
sterbase_session_shutdown | Завершение форм и явно назначенного собственного сеанса. | Действие / изменение состояния |
sterbase_selection_get
Чтение ожидающего типизированного выбора, включая печатную форму; операция ничего не выбирает.
operation_token — обязательно
{
"type": "object",
"properties": {
"operation_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"operation_token"
],
"additionalProperties": false
}sterbase_selection_choose
Продолжение опубликованного выбора: index начинается с нуля, -1 отменяет.
operation_token — обязательно, action_token — обязательно, index — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"operation_token": {
"type": "string",
"minLength": 1
},
"action_token": {
"type": "string",
"minLength": 1
},
"index": {
"type": "integer",
"minimum": -1,
"maximum": 2147483647
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"operation_token",
"action_token",
"index"
],
"additionalProperties": false
}sterbase_process_diagnostics
Диагностика выбранного собственного процесса вне его UI-потока; без повторения операций.
Параметры не требуются.
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}sterbase_forms_list
Реальные открытые формы без передачи владения пользовательскими окнами.
Параметры не требуются.
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}sterbase_form_views
Вкладки и табличные области с ревизией и токенами навигации.
form_token — обязательно
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"form_token"
],
"additionalProperties": false
}sterbase_form_view_set
Переход к вкладке или строке через обычный обработчик, без записи и проведения.
form_token — обязательно, action_token — обязательно, expected_revision — обязательно, index — обязательно, flag, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"action_token": {
"type": "string",
"minLength": 1
},
"expected_revision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"index": {
"type": "integer",
"minimum": 0,
"maximum": 2147483647
},
"flag": {
"type": "boolean"
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"action_token",
"expected_revision",
"index"
],
"additionalProperties": false
}sterbase_metadata_get
Поля метаданных, типы, длины, точность и допустимые ссылочные цели.
object_kind — обязательно, metadata_id — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"metadata_id": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_kind",
"metadata_id"
],
"additionalProperties": false
}sterbase_form_set
Изменение опубликованных полей через обычные обработчики; не подтверждает запись.
form_token — обязательно, changes — обязательно, expected_revision — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field_token": {
"type": "string",
"minLength": 1
},
"scalar_text": {
"type": "string"
},
"reference_token": {
"type": "string",
"minLength": 1
},
"clear": {
"type": "boolean"
}
},
"required": [
"field_token"
],
"additionalProperties": false
},
"maxItems": 2000
},
"expected_revision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"changes",
"expected_revision"
],
"additionalProperties": false
}sterbase_object_draft_create
Черновик справочника или документа в памяти.
object_kind — обязательно, metadata_id — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"metadata_id": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_kind",
"metadata_id"
],
"additionalProperties": false
}sterbase_object_draft_apply
Типизированные поля и полный набор строк версии черновика.
draft_token — обязательно, version_token — обязательно, changes, rows, wait_timeout_ms
{
"type": "object",
"properties": {
"draft_token": {
"type": "string",
"minLength": 1
},
"version_token": {
"type": "string",
"minLength": 1
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field_token": {
"type": "string",
"minLength": 1
},
"scalar_text": {
"type": "string"
},
"reference_token": {
"type": "string",
"minLength": 1
},
"clear": {
"type": "boolean"
}
},
"required": [
"field_token"
],
"additionalProperties": false
},
"maxItems": 2000
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field_token": {
"type": "string",
"minLength": 1
},
"scalar_text": {
"type": "string"
},
"reference_token": {
"type": "string",
"minLength": 1
},
"clear": {
"type": "boolean"
}
},
"required": [
"field_token"
],
"additionalProperties": false
},
"maxItems": 2000
}
},
"required": [
"changes"
],
"additionalProperties": false
},
"maxItems": 1000
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"draft_token",
"version_token"
],
"additionalProperties": false
}sterbase_reference_select
Постраничный подбор типизированной ссылки с ограничениями поля.
field_token — обязательно, query, cursor, limit
{
"type": "object",
"properties": {
"field_token": {
"type": "string",
"minLength": 1
},
"query": {
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"field_token"
],
"additionalProperties": false
}sterbase_object_create
Фиксация подготовленного черновика через штатную запись; повтор того же черновика сверяет прежний результат.
draft_token — обязательно, version_token — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"draft_token": {
"type": "string",
"minLength": 1
},
"version_token": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"draft_token",
"version_token"
],
"additionalProperties": false
}sterbase_object_save
Запись полей существующего объекта с контролем версии и состояния commit.
object_token — обязательно, version_token — обязательно, changes — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_token": {
"type": "string",
"minLength": 1
},
"version_token": {
"type": "string",
"minLength": 1
},
"changes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"field_token": {
"type": "string",
"minLength": 1
},
"scalar_text": {
"type": "string"
},
"reference_token": {
"type": "string",
"minLength": 1
},
"clear": {
"type": "boolean"
}
},
"required": [
"field_token"
],
"additionalProperties": false
},
"maxItems": 2000
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_token",
"version_token",
"changes"
],
"additionalProperties": false
}sterbase_object_set_delete_mark
Установка или снятие пометки удаления по текущим правам.
object_token — обязательно, version_token — обязательно, flag — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_token": {
"type": "string",
"minLength": 1
},
"version_token": {
"type": "string",
"minLength": 1
},
"flag": {
"type": "boolean"
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_token",
"version_token",
"flag"
],
"additionalProperties": false
}sterbase_document_set_posted
Проведение или отмена через общий жизненный цикл; открытая карточка требует владения и ревизии.
object_token — обязательно, version_token — обязательно, form_token, expected_revision, flag — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_token": {
"type": "string",
"minLength": 1
},
"version_token": {
"type": "string",
"minLength": 1
},
"form_token": {
"type": "string",
"minLength": 1
},
"expected_revision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"flag": {
"type": "boolean"
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_token",
"version_token",
"flag"
],
"additionalProperties": false
}sterbase_accounting_total
Чтение бухгалтерского показателя за период по счёту.
period_from — обязательно, period_to — обязательно, account_code — обязательно, metric — обязательно
{
"type": "object",
"properties": {
"period_from": {
"type": "string",
"minLength": 1
},
"period_to": {
"type": "string",
"minLength": 1
},
"account_code": {
"type": "string",
"minLength": 1
},
"metric": {
"type": "string",
"minLength": 1
}
},
"required": [
"period_from",
"period_to",
"account_code",
"metric"
],
"additionalProperties": false
}sterbase_accounting_totals_recalculate
Штатный пересчёт итогов с подтверждением, правом обслуживания и фактическим монопольным доступом.
period_to, wait_timeout_ms
{
"type": "object",
"properties": {
"period_to": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [],
"additionalProperties": false
}sterbase_operation_get
Опрос запущенной операции без повторения побочных эффектов; показывает доступные дочерние формы.
operation_token — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"operation_token": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"operation_token"
],
"additionalProperties": false
}sterbase_period_dialog_get
Чтение принадлежащего операции календарного диалога без его подтверждения.
operation_token — обязательно
{
"type": "object",
"properties": {
"operation_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"operation_token"
],
"additionalProperties": false
}sterbase_period_dialog_complete
Применение или отмена периода через штатный обработчик диалога.
operation_token — обязательно, action_token — обязательно, flag — обязательно, period_from, period_to, wait_timeout_ms
{
"type": "object",
"properties": {
"operation_token": {
"type": "string",
"minLength": 1
},
"action_token": {
"type": "string",
"minLength": 1
},
"flag": {
"type": "boolean"
},
"period_from": {
"type": "string",
"minLength": 1
},
"period_to": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"operation_token",
"action_token",
"flag"
],
"additionalProperties": false
}sterbase_form_open
Открытие отчёта или обработки по точным метаданным.
object_kind — обязательно, metadata_id — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"metadata_id": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_kind",
"metadata_id"
],
"additionalProperties": false
}sterbase_form_actions
Доступные действия формы с одноразовыми токенами и ревизией.
form_token — обязательно
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"form_token"
],
"additionalProperties": false
}sterbase_form_invoke
Выполнение опубликованного действия через обычный обработчик команды.
form_token — обязательно, action_token — обязательно, expected_revision — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"action_token": {
"type": "string",
"minLength": 1
},
"expected_revision": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"action_token",
"expected_revision"
],
"additionalProperties": false
}sterbase_session_describe
Текущая база, пользователь, права, готовность и поддерживаемые операции.
Параметры не требуются.
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}sterbase_metadata_list
Постраничный список читаемых метаданных.
object_kind, query, cursor, limit
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"query": {
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [],
"additionalProperties": false
}sterbase_object_list
Чтение справочников и документов без открытия формы.
object_kind — обязательно, metadata_id — обязательно, query, cursor, limit
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"metadata_id": {
"type": "string",
"minLength": 1
},
"query": {
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"object_kind",
"metadata_id"
],
"additionalProperties": false
}sterbase_object_get
Чтение точного объекта и его полей/строк по выданному токену.
object_token — обязательно, cursor, limit
{
"type": "object",
"properties": {
"object_token": {
"type": "string",
"minLength": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"object_token"
],
"additionalProperties": false
}sterbase_list_open
Открытие списка или бухгалтерского журнала, при необходимости с периодом.
object_kind — обязательно, metadata_id — обязательно, period_from, period_to, wait_timeout_ms
{
"type": "object",
"properties": {
"object_kind": {
"type": "string",
"minLength": 1
},
"metadata_id": {
"type": "string",
"minLength": 1
},
"period_from": {
"type": "string",
"minLength": 1
},
"period_to": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"object_kind",
"metadata_id"
],
"additionalProperties": false
}sterbase_list_period_set
Изменение периода своего журнала с сохранением фильтров и порядка.
form_token — обязательно, period_from — обязательно, period_to — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"period_from": {
"type": "string",
"minLength": 1
},
"period_to": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"period_from",
"period_to"
],
"additionalProperties": false
}sterbase_form_get
Семантическое состояние своей формы; закрытый токен не переадресуется другому окну.
form_token — обязательно
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"form_token"
],
"additionalProperties": false
}sterbase_list_select
Выбор точного объекта и выполнение обработчиков позиционирования.
form_token — обязательно, object_token — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"object_token": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"object_token"
],
"additionalProperties": false
}sterbase_list_activate
Активация объекта с учётом перенаправления формы или штатной отмены.
form_token — обязательно, object_token — обязательно, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"object_token": {
"type": "string",
"minLength": 1
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token",
"object_token"
],
"additionalProperties": false
}sterbase_form_snapshot
PNG-снимок готовой собственной формы вместе с её состоянием.
form_token — обязательно
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
}
},
"required": [
"form_token"
],
"additionalProperties": false
}sterbase_form_close
Штатное закрытие собственной формы с уважением отказа обработчика.
form_token — обязательно, discard_changes, wait_timeout_ms
{
"type": "object",
"properties": {
"form_token": {
"type": "string",
"minLength": 1
},
"discard_changes": {
"type": "boolean"
},
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [
"form_token"
],
"additionalProperties": false
}sterbase_session_close
Закрытие только принадлежащих API форм в обратном порядке.
wait_timeout_ms
{
"type": "object",
"properties": {
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [],
"additionalProperties": false
}sterbase_session_shutdown
Завершение форм и явно назначенного собственного сеанса.
wait_timeout_ms
{
"type": "object",
"properties": {
"wait_timeout_ms": {
"type": "integer",
"minimum": 0,
"maximum": 120000
}
},
"required": [],
"additionalProperties": false
}Результат и ограничения
Инструменты работают в границах текущего пользователя и контекста. Для изменения формы или данных сохраняйте идентичность объекта и проверяйте readback; после потери сеанса не применяйте старый контекст к другому окну. Runtime API описывает транспорт, общие поля и восстановление. 19 инструментов встроенного ИИ описаны отдельно.