[{"data":1,"prerenderedAt":152},["ShallowReactive",2],{"help-article-staff-569":3,"help-view-staff":34},{"data":4},{"help":5},{"id":6,"name":7,"article":8},"48","Staff",{"id":9,"catalog":10,"category":11,"keywords":14,"title":22,"description":23,"body":24,"legacy":25,"created_by":26,"created_at":30,"updated_at":31,"edge_associated_articles":32},"569",{"id":6,"name":7},{"id":12,"name":13},"83","Огляди можливостей",[15,16,17,18,19,20,21],"API","MCP","ключ API","інтеграції","ШІ-асистент","рівень доступу","експериментальні функції","Експериментальні функції: API для інтеграцій і MCP для ШІ-асистентів","У Налаштуваннях з'явився новий розділ — **Експериментальні функції**. Він дає два способи працювати з даними Staff ззовні:\n\n* **API для інтеграцій** — для розробників, які пишуть власні програми й хочуть читати дані Staff автоматично.\n\n* **MCP для ШІ-асистентів** — щоб ШІ-помічник (наприклад, Claude) міг відповідати на","У Налаштуваннях з'явився новий розділ — **Експериментальні функції**. Він дає два способи працювати з даними Staff ззовні:\n\n* **API для інтеграцій** — для розробників, які пишуть власні програми й хочуть читати дані Staff автоматично.\n\n* **MCP для ШІ-асистентів** — щоб ШІ-помічник (наприклад, Claude) міг відповідати на питання про команду, нарахування й виплати на основі ваших даних.\n\nОбидві функції позначені як експериментальні: їхня поведінка може змінюватися без попередження.\n\n![1.00](/img/s4/8968/7a42f02db5b080b86ce9c3baf61e95d84d6b.png?s=bf38a765f007f9a52f6f007ad2414b19 \"Налаштування → Експериментальні функції\")\n\n## Де знайти\n\n**Налаштування → Експериментальні функції** (останній пункт у списку налаштувань).\n\nЯкщо поруч із перемикачем стоїть **корона**, функція не входить у ваш тарифний план: перемикач заблоковано, а натискання на рядок відкриє вікно тарифу.\n\n## Рівні доступу\n\nІ для API, і для MCP діє один з трьох рівнів:\n\n| Рівень              | Що дозволено                                                                                              |\n| ------------------- | --------------------------------------------------------------------------------------------------------- |\n| **Читання**         | лише переглядати дані: команду, довідники, нарахування, виплати, баланси, відсутності, прогони, аналітику |\n| **Читання і зміни** | те саме плюс створення, редагування й проведення                                                          |\n| **Повний**          | те саме плюс видалення і сторно — усе, що вміє сам застосунок                                             |\n\nЗараз через API і MCP доступне лише **читання**. Зміни й видалення з'являться в наступних оновленнях — рівень можна виставити вже зараз, він почне діяти, щойно відповідні дії стануть доступними.\n\nДля API рівень задається **окремо для кожного ключа**. Для MCP — **один рівень на весь робочий простір**.\n\n## MCP — доступ для ШІ-асистентів\n\nMCP — це спосіб підключити ШІ-асистента до ваших даних. Асистент бачить рівно те, що дозволяє обраний рівень, і працює від імені людини, яка його підключила.\n\n* Перемикач «Дозволити підключення через MCP» за замовчуванням **увімкнений**, рівень — **Читання**.\n\n* Якщо вимкнути перемикач, усі підключені асистенти одразу втрачають доступ.\n\n* Щоб дозволити асистентові зміни, оберіть рівень «Читання і зміни» або «Повний». Перед збереженням вищого рівня застосунок попросить підтвердити вибір.\n\n**Адреса підключення** з'явиться в цьому блоці, щойно запрацює сервер Staff у шлюзі OneB. До того моменту увімкнути MCP і обрати рівень можна вже зараз — налаштування збережуться.\n\nЯкщо асистент повідомляє, що йому бракує прав, що MCP вимкнено або не входить у тариф, — він перекаже вам готову підказку з назвою потрібного налаштування та посиланням на нього.\n\n## API для інтеграцій\n\nAPI призначений для розробників. Він описаний у документації, посилання «Документація API» є у правому верхньому куті блока — там перелік усіх запитів, їхні параметри й приклади відповідей.\n\nДоступ через API за замовчуванням **вимкнений**. Щоб ним скористатися:\n\n1. Увімкніть перемикач «Дозволити доступ через API».\n2. Натисніть **Створити ключ**: задайте назву (наприклад, «Інтеграція з 1С»), рівень доступу і, за бажанням, термін дії.\n3. Скопіюйте ключ із вікна, що відкриється. **Ключ показується лише один раз** — після закриття вікна побачити його знову неможливо. Якщо ключ загубився, відкличте його і створіть новий.\n4. Передайте ключ розробникові інтеграції.\n\nУ списку ключів видно назву, рівень, термін дії і дату останнього використання кожного ключа — так легко помітити ключ, яким ніхто не користується.\n\n**Відкликати ключ** можна в будь-який момент із цього ж списку. Відкликаний ключ перестає працювати одразу і назавжди.\n\nКлюч діє від імені людини, яка його створила. Якщо цю людину вилучити з робочого простору, її ключі перестануть працювати.\n\n## Безпека\n\n* Ключ API — це пароль. Не надсилайте його в чатах і не зберігайте у спільних документах.\n\n* Створюйте окремий ключ для кожної інтеграції з найнижчим достатнім рівнем — тоді відкликання одного ключа не зупинить інші.\n\n* Вимкнений перемикач «API» або «MCP» блокує доступ повністю, навіть якщо ключі або підключення ще існують.\n\n",false,{"id":27,"name":28,"photo_url":29},"37","Ярослав Плакида","https://account.oneb.app/uploads/usr/photo/1/JMQPpCmTUtL2j8Mecr5W3TbY5ZbyK4fw.jpeg?w=300&h=300&fit=crop&s=7712ff4ac866b4965be19403505c01c8",1791012640,1791385498,{"edges":33},[],{"data":35},{"help":36},{"id":6,"name":7,"language":37,"edge_categories":38,"edge_translations":150},null,{"page_info":39,"edges":41},{"has_next_page":25,"end_cursor":40},"W1s0XSxbMSw4MF1d",[42,62,90,118],{"node":43},{"id":44,"name":45,"created_at":46,"articles_count":47,"edge_preview_articles":48},"81","З чого почати",1782908698,3,{"edges":49},[50,54,58],{"node":51},{"id":52,"title":53},"478","Що таке Staff: огляд застосунку",{"node":55},{"id":56,"title":57},"464","Перехід з іншої системи: як перенести всі дані",{"node":59},{"id":60,"title":61},"378","Як імпортувати співробітників з Excel або CSV",{"node":63},{"id":64,"name":65,"created_at":66,"articles_count":67,"edge_preview_articles":68},"82","Поняття й терміни",1782955204,5,{"edges":69},[70,74,78,82,86],{"node":71},{"id":72,"title":73},"473","Мінбаза і максбаза ЄСВ, зміни заднім числом",{"node":75},{"id":76,"title":77},"469","Баланс відпустки і страховий стаж",{"node":79},{"id":80,"title":81},"411","Категорії нарахувань: баланс і податки",{"node":83},{"id":84,"title":85},"383","Як дати прийняття та звільнення впливають на нарахування",{"node":87},{"id":88,"title":89},"380","Тип значення змінної: число чи відсоток",{"node":91},{"id":12,"name":13,"created_at":92,"articles_count":93,"edge_preview_articles":94},1782958181,13,{"edges":95},[96,100,104,106,110,114],{"node":97},{"id":98,"title":99},"571","Публічний API і MCP: що можна читати й змінювати ззовні",{"node":101},{"id":102,"title":103},"570","Пауза нарахувань: як тимчасово не нараховувати зарплату",{"node":105},{"id":9,"title":22},{"node":107},{"id":108,"title":109},"477","Доступ для служби підтримки",{"node":111},{"id":112,"title":113},"468","Відсутності: календар, типи і статуси",{"node":115},{"id":116,"title":117},"414","Картка співробітника: повний огляд",{"node":119},{"id":120,"name":121,"created_at":122,"articles_count":123,"edge_preview_articles":124},"80","Покрокові інструкції",1782809096,17,{"edges":125},[126,130,134,138,142,146],{"node":127},{"id":128,"title":129},"476","Масове проведення відпускних і лікарняних",{"node":131},{"id":132,"title":133},"474","Імпорт історії відсутностей з Excel: покрокова інструкція",{"node":135},{"id":136,"title":137},"472","Компенсація невикористаної відпустки при звільненні",{"node":139},{"id":140,"title":141},"471","Відрядження і добові",{"node":143},{"id":144,"title":145},"470","Як нарахувати відпускні, лікарняні та декретні",{"node":147},{"id":148,"title":149},"467","Імпорт історії виплат з Excel: покрокова інструкція",{"edges":151},[],1791429752816]