API для зовнішніх агентів#
Сервіс надає MCP-сервер, через який зовнішні AI-агенти можуть працювати з даними вашої бази: Claude, ChatGPT чи власні агенти вашої команди. Доступ лише на читання, з тим самим маскуванням персональних даних, що й у чаті.
Для чого#
Чат відповідає на питання за кілька секунд. Але деякі задачі потребують десятків кроків: зібрати дані з різних регістрів, порівняти кілька періодів, перевірити гіпотезу й повернутися з уточненням. Такі складні аналітичні задачі зручно доручати власному агенту, який працює з базою напряму через API. Наприклад:
- пошук причин розбіжностей між обліком і звітністю;
- аналіз маржинальності за клієнтами й товарами за кілька років;
- підготовка аналітичної записки для керівника на основі даних кількох фірм;
- регулярний запуск шаблонів перевірок з власної системи чи сценарію.
Адреса і протокол#
| Параметр | Значення |
|---|---|
| Адреса | https://assist.it-format.com.ua/mcp |
| Протокол | MCP (JSON-RPC), версія 2025-06-18 |
| Авторизація | Bearer-токен агента (видається в кабінеті) |
| Права | Набір областей доступу на токен |
Інструменти#
| Інструмент | Призначення |
|---|---|
query |
Запит до даних бази мовою запитів 1С (лише читання) |
get_metadata |
Структура бази: об'єкти, реквізити, регістри |
find_entity |
Пошук контрагента, номенклатури, рахунку за назвою |
search_knowledge |
Пошук у базі знань з обліку й конфігурації |
get_help |
Довідка по інструментах |
read_chart_of_accounts, read_accumulation_register, read_information_register |
Читання плану рахунків і регістрів |
list_templates, get_template_params, run_template, send_template |
Шаблони перевірок: список, параметри, запуск, доставка |
Як увімкнути#
- У 1С: Чат з асистентом → Налаштування → увімкніть Використовувати API (виконавчий канал) і натисніть Зберегти.
- У кабінеті створіть токен агента й оберіть області доступу.
- Додайте MCP-сервер у налаштування свого агента з цим токеном.
Персональні дані
Зовнішній агент бачить замасковані позначки замість назв контрагентів, ІПН і рахунків, як і модель у чаті. Детальніше — у розділі Безпека і дані.