Експериментальні функції: API для інтеграцій і MCP для ШІ-асистентів

У Налаштуваннях з'явився новий розділ — Експериментальні функції. Він дає два способи працювати з даними Staff ззовні:

API для інтеграцій — для розробників, які пишуть власні програми й хочуть читати дані Staff автоматично.
MCP для ШІ-асистентів — щоб ШІ-помічник (наприклад, Claude) міг відповідати на питання про команду, нарахування й виплати на основі ваших даних.

Обидві функції позначені як експериментальні: їхня поведінка може змінюватися без попередження.

1.00

Де знайти

Налаштування → Експериментальні функції (останній пункт у списку налаштувань).

Якщо поруч із перемикачем стоїть корона, функція не входить у ваш тарифний план: перемикач заблоковано, а натискання на рядок відкриє вікно тарифу.

Рівні доступу

І для API, і для MCP діє один з трьох рівнів:

Рівень	Що дозволено
Читання	лише переглядати дані: команду, довідники, нарахування, виплати, баланси, відсутності, прогони, аналітику
Читання і зміни	те саме плюс створення, редагування й проведення
Повний	те саме плюс видалення і сторно — усе, що вміє сам застосунок

Зараз через API і MCP доступне лише читання. Зміни й видалення з'являться в наступних оновленнях — рівень можна виставити вже зараз, він почне діяти, щойно відповідні дії стануть доступними.

Для API рівень задається окремо для кожного ключа. Для MCP — один рівень на весь робочий простір.

MCP — доступ для ШІ-асистентів

MCP — це спосіб підключити ШІ-асистента до ваших даних. Асистент бачить рівно те, що дозволяє обраний рівень, і працює від імені людини, яка його підключила.

Перемикач «Дозволити підключення через MCP» за замовчуванням увімкнений, рівень — Читання.
Якщо вимкнути перемикач, усі підключені асистенти одразу втрачають доступ.
Щоб дозволити асистентові зміни, оберіть рівень «Читання і зміни» або «Повний». Перед збереженням вищого рівня застосунок попросить підтвердити вибір.

Адреса підключення з'явиться в цьому блоці, щойно запрацює сервер Staff у шлюзі OneB. До того моменту увімкнути MCP і обрати рівень можна вже зараз — налаштування збережуться.

Якщо асистент повідомляє, що йому бракує прав, що MCP вимкнено або не входить у тариф, — він перекаже вам готову підказку з назвою потрібного налаштування та посиланням на нього.

API для інтеграцій

API призначений для розробників. Він описаний у документації, посилання «Документація API» є у правому верхньому куті блока — там перелік усіх запитів, їхні параметри й приклади відповідей.

Доступ через API за замовчуванням вимкнений. Щоб ним скористатися:

Увімкніть перемикач «Дозволити доступ через API».
Натисніть Створити ключ: задайте назву (наприклад, «Інтеграція з 1С»), рівень доступу і, за бажанням, термін дії.
Скопіюйте ключ із вікна, що відкриється. Ключ показується лише один раз — після закриття вікна побачити його знову неможливо. Якщо ключ загубився, відкличте його і створіть новий.
Передайте ключ розробникові інтеграції.

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

Відкликати ключ можна в будь-який момент із цього ж списку. Відкликаний ключ перестає працювати одразу і назавжди.

Ключ діє від імені людини, яка його створила. Якщо цю людину вилучити з робочого простору, її ключі перестануть працювати.

Безпека

Ключ API — це пароль. Не надсилайте його в чатах і не зберігайте у спільних документах.
Створюйте окремий ключ для кожної інтеграції з найнижчим достатнім рівнем — тоді відкликання одного ключа не зупинить інші.
Вимкнений перемикач «API» або «MCP» блокує доступ повністю, навіть якщо ключі або підключення ще існують.