Інтеграція Claude з PeopleForce через MCP

Огляд

Що Claude може робити з PeopleForce

PeopleForce має власний MCP-сервер. MCP — це відкритий стандарт, за допомогою якого Claude отримує доступ до інших систем. Після підключення Claude може від вашого імені дізнатися:

Хто відсутній у певний день, включно з державними святами
Скільки днів відпустки залишилося в людини, за типами відсутностей
Хто де працює і хто кому підпорядковується, зокрема за власними полями, які бачить ваша роль

Кожна відповідь ґрунтується на актуальних даних PeopleForce, отриманих у вашому власному акаунті PeopleForce. У цьому релізі Claude читає дані й відповідає; він нічого не подає, не схвалює і не змінює.

Як працює PeopleForce MCP →

Налаштування

Перш ніж почати

Потрібні три умови. Перша — разове завдання для адміністратора.

MCP встановлено в PeopleForce

Адміністратор відкриває розділ «Налаштування → Інтеграції → Model Context Protocol (MCP)» і натискає «Встановити». Це може зробити й будь-хто, чия роль дає доступ до інтеграцій. Доти ніщо не зможе підключитися. Якщо сторінки MCP немає, його ще не ввімкнено для вашого акаунта: спочатку це робить команда PeopleForce, тож зверніться до вашого акаунт-менеджера або нашої служби підтримки.

У вас є адреса сервера вашої компанії

Вона на тій самій сторінці, поруч із кнопкою копіювання: це вебадреса вашого PeopleForce, а за нею /mcp, наприклад https://your-company.peopleforce.io/mcp. Саме адреса визначає, у яку компанію ви входите.

Ваш тариф Claude дає змогу додавати власні конектори

Власні конектори працюють на тарифах Claude Free, Pro, Max, Team і Enterprise. В акаунті Free можна додати один. На Team і Enterprise користувач із роллю Owner спершу додає PeopleForce для всієї організації.

Claude у вебверсії та на комп’ютері

Підключіть PeopleForce у Claude

Ті самі кроки працюють на claude.ai і в Claude Desktop. Після підключення PeopleForce буде доступний і тоді, коли ви наступного разу ввійдете в Claude на iOS або Android.

Крок 1: Додайте PeopleForce як власний конектор

Відкрийте Customize → Connectors, натисніть + і виберіть Add custom connector. Вставте адресу сервера вашої компанії й натисніть Add. Поля в Advanced settings залиште порожніми. PeopleForce реєструє Claude автоматично, тож копіювати ідентифікатор клієнта чи секрет не потрібно.

Крок 2: Увійдіть у PeopleForce і підтвердьте підключення

Під час підключення Claude відкриває власну сторінку входу PeopleForce. Увійдіть у ваш акаунт (якщо ви вже ввійшли, то одразу перейдете до підтвердження) і дозвольте Claude читати ваші дані PeopleForce у вашому власному акаунті. Після цього Claude з’явиться в розділі «Підключення» на вашій сторінці «Налаштування облікового запису → Безпека» в PeopleForce.

Крок 3: Увімкніть PeopleForce у розмові

У чаті натисніть + (або введіть /), наведіть курсор на Connectors і ввімкніть PeopleForce. Потім запитуйте звичайною мовою, наприклад Кого не буде наступного вівторка в київському офісі? або Скільки днів щорічної відпустки залишилося в Олени?

Крок 4: Визначте, що Claude може робити, не питаючи

У Customize → Connectors відкрийте PeopleForce, щоб побачити чотири його інструменти: Search people, List people fields, Who's out і People leave balances. Для кожного встановіть Always allow, Needs approval або Blocked. Усі чотири лише читають дані.

Team і Enterprise

Owner додає PeopleForce один раз для всіх

Owner відкриває Organization settings → Connectors, натискає Add, наводить курсор на Custom, вибирає Web і вставляє адресу сервера. Після цього всі інші знаходять PeopleForce у Customize → Connectors і натискають Connect, щоб увійти у свій акаунт. Пошук кожної людини виконується в її власному акаунті PeopleForce, незалежно від того, хто додав конектор.

Claude Code

Підключіть PeopleForce у Claude Code

Claude Code підключається з вашого термінала. На сторінці MCP у PeopleForce є готова до копіювання команда в розділі «Додати до Claude Code».

claude mcp add --transport http --scope user peopleforce https://your-company.peopleforce.io/mcp

Додайте сервер, увійдіть, перевірте

Виконайте команду вище. Параметр --scope user робить PeopleForce доступним у всіх ваших проєктах, а не лише в цьому. У Claude Code виконайте /mcp і дотримуйтеся кроків у браузері, щоб увійти в PeopleForce і підтвердити підключення. Якщо браузер не відкривається, скопіюйте посилання, яке показує Claude Code. claude mcp list після цього показує peopleforce зі статусом ✔ Connected. Claude Code сам оновлює авторизацію, тож ви залишаєтеся підключеними, доки не видалите сервер або не відкличете підключення в PeopleForce.

Ваші дані

Що читає Claude, а що залишається у вас

Кожен запит виконується від імені людини, яка його надіслала. Claude читає чотири речі на вимогу, коли ви запитуєте: директорію співробітників, відсутності, баланси відсутностей і назви полів вашої компанії. Він не може читати вашу базу знань або щось змінювати в PeopleForce.

Claude шукає інформацію від вашого імені

Для чинних співробітників відповіді враховують вашу роль, видимість у директорії та дозволи на рівні полів, тож двоє колег, які ставлять те саме запитання, можуть отримати різні відповіді. Приватний тип відсутності відображається як загальна позначка. Зарплата з’являється у відповіді лише тоді, коли ваша роль дає змогу бачити компенсацію цієї людини в PeopleForce.

Що відбувається з вашими розмовами

PeopleForce надсилає відповідь лише тоді, коли Claude запитує, і не використовує ваші дані для навчання моделей ШІ. У Claude розмови підпорядковуються власним правилам Anthropic: на Team і Enterprise вони за замовчуванням не використовуються для навчання. На Free, Pro і Max усе визначає налаштування Model Improvement від Anthropic, і, за словами Anthropic, воно не поширюється на необроблений вміст із MCP-конекторів, якщо ви не скопіюєте його в чат.

Відключити можна будь-коли

Видаліть PeopleForce у Customize → Connectors або відкличте доступ для Claude в PeopleForce у розділі «Налаштування облікового запису → Безпека → Підключення». Адміністратори бачать і можуть відкликати кожне підключення в розділі «Налаштування → Інтеграції → Model Context Protocol (MCP) → Керувати підключеннями», а коли людину звільняють у PeopleForce, її підключення відкликаються автоматично.

Усі подробиці на сторінці PeopleForce MCP →

Усунення проблем

Якщо щось не працює

Найчастіше причина в одному з трьох: встановленні MCP, адресі або акаунті, у який ви ввійшли.

Що ви бачите	Що робити
У розділі «Налаштування → Інтеграції» немає сторінки MCP	MCP для вашого акаунта ще не ввімкнено. Спочатку його вмикає команда PeopleForce, тож зверніться до вашого акаунт-менеджера або нашої служби підтримки.
Claude не може підключитися або повідомляє, що MCP не ввімкнено	Попросіть адміністратора встановити MCP у розділі «Налаштування → Інтеграції → Model Context Protocol (MCP)», а потім підключіться знову. Перевірте, чи адреса закінчується на /mcp.
Сторінка входу показує іншу компанію, або ви не можете ввійти	Робочий простір визначає адреса. Використовуйте адресу саме вашої компанії та входьте у ваш акаунт у цьому робочому просторі.
У відповіді бракує людей або полів	Claude шукає інформацію від вашого імені. Для чинних співробітників колега чи поле, приховані від вас у PeopleForce, приховані й від Claude.
Claude відповідає, не використовуючи PeopleForce	Увімкніть PeopleForce для розмови в меню + → Connectors або згадайте PeopleForce у запитанні.
Claude Code показує ! Needs authentication	Виконайте /mcp у Claude Code і завершіть вхід у браузері.