MCP

MCP (Model Context Protocol) дає змогу ШІ-помічникам та іншим сумісним застосункам працювати з даними Planfix за стандартним протоколом.

Після встановлення з’єднання клієнт отримує лише явно дозволені можливості та діє від імені співробітника, який увійшов у систему. Стандартні права доступу Planfix продовжують діяти: ШІ-помічник не може переглядати чи змінювати те, що недоступне цьому користувачу.

Доступні дії залежать від клієнта MCP, наданих дозволів і поточної версії сервера. Наприклад, клієнт може мати змогу знаходити завдання й контакти, переглядати їхні дані та додавати коментарі, якщо на це надано відповідні дозволи.

Вимоги

акаунт співробітника Planfix;
клієнт MCP із підтримкою Streamable HTTP та OAuth.

Адреса сервера MCP

Використовуйте цю URL-адресу сервера MCP:

https://mcp.planfix.com/mcp

URL-адреса однакова для всіх акаунтів Planfix. Не додавайте до неї назву акаунта й не надсилайте окремий заголовок акаунта. Акаунт вибирається під час авторизації OAuth.

Підключення будь-якого клієнта MCP

Відкрийте налаштування сервера MCP у клієнті.
Додайте новий сервер, використовуючи транспорт Streamable HTTP.
Укажіть назву, наприклад Planfix, і URL-адресу MCP.
Збережіть налаштування та почніть автентифікацію OAuth.
У вікні браузера, що відкриється, виберіть акаунт Planfix. Його можна знайти за назвою, URL-адресою або адресою електронної пошти.
Перевірте назву застосунку та запитані дозволи, а потім підтвердьте підключення.

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

Для підключення Codex через DCR запит не можна передати адміністратору після початку входу, тому заздалегідь виберіть відповідний сценарій з наступного розділу.

Підключення Codex

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

Якщо ви адміністратор: підключення через DCR

Цей варіант доступний адміністратору акаунта або технічному адміністратору. Під час входу вони зможуть схвалити автоматично зареєстрований застосунок і підключити його.

Додайте сервер MCP:

codex mcp add planfix --url https://mcp.planfix.com/mcp

Почніть вхід через OAuth і явно виберіть DCR як спосіб реєстрації клієнта:

codex mcp login planfix --oauth-client-registration dcr

Codex відкриє браузер. Виберіть акаунт Planfix, у якому ви є адміністратором, перевірте запитані дозволи й натисніть Дозволити та підключити.

Застосунок, зареєстрований через DCR, завжди потребує явного схвалення акаунта. Звичайному співробітнику не слід починати цей сценарій: наразі запит на підключення через DCR не можна відкласти й передати адміністратору для окремого схвалення.

Параметр --oauth-client-registration dcr застосовується лише для цього входу й не зберігається у config.toml. Codex самостійно збереже отримані дані підключення OAuth.

Якщо ви не адміністратор: підключення через client_id

Спочатку попросіть адміністратора акаунта або технічного адміністратора створити застосунок:

Відкрийте Керування акаунтом → API → Застосунки OAuth і MCP.
У блоці Застосунки цього акаунта натисніть Створити застосунок.
Укажіть назву, наприклад Codex.
Виберіть тип Публічний клієнт. Для Codex секретний ключ клієнта не потрібен.
Додайте Redirect URI http://127.0.0.1/callback.
Виберіть мінімально необхідні дозволи й збережіть застосунок.
Передайте користувачу отриманий client_id.

Planfix публікує issuer і підтримує прив’язку до нього відповіді авторизації, тому новий попередньо зареєстрований клієнт Codex використовує стабільну адресу зворотного виклику http://127.0.0.1/callback. Під час входу Codex додає тимчасовий порт loopback; Planfix приймає такий порт, якщо хост і шлях залишаються незмінними.

Користувач додає сервер, підставивши отриманий ідентифікатор:

codex mcp add planfix --url https://mcp.planfix.com/mcp --oauth-client-id CLIENT_ID

Codex покаже повну URL-адресу зворотного виклику. У стандартній конфігурації вона має такий вигляд:

OAuth callback URL: http://127.0.0.1/callback

Якщо через власні налаштування Codex відображається інша адреса, попросіть адміністратора додати цей Redirect URI до застосунку.

Потім виконайте команду:

codex mcp login planfix

Якщо вказано --oauth-client-id, Codex використовуватиме попередньо зареєстрований клієнт і не запускатиме CIMD або DCR. Налаштування зберігаються приблизно так:

[mcp_servers.planfix]
url = "https://mcp.planfix.com/mcp"

[mcp_servers.planfix.oauth]
client_id = "CLIENT_ID"
callback_url = "http://127.0.0.1/callback"

Застосунок Codex і розширення IDE

Застосунок Codex, Codex CLI та розширення IDE використовують спільну конфігурацію MCP на тому самому комп’ютері. Після першого підключення через CLI перезапустіть застосунок або розширення. Сервер з’явиться в розділі Налаштування → Сервери MCP. Якщо поруч із ним відображається Автентифікувати, натисніть цю кнопку й завершіть вхід.

Перевірити активні сервери MCP можна командою /mcp у полі введення Codex.

Переглянути список і статус підключень можна командою:

codex mcp list

Актуальні елементи інтерфейсу, команди та правила вибору адреси зворотного виклику описані в офіційній документації OpenAI з MCP.

Якщо інший клієнт MCP не може зареєструватися автоматично

Сучасний клієнт MCP може зареєструватися автоматично через CIMD або DCR. Така реєстрація сама по собі не надає доступу до акаунта: правила акаунта та схвалення адміністратора залишаються чинними.

Якщо клієнту потрібен заздалегідь визначений client_id, попросіть адміністратора створити для акаунта публічний застосунок:

Відкрийте Керування акаунтом → API → Застосунки OAuth і MCP.
Створіть застосунок у блоці Застосунки цього акаунта.
Виберіть тип Публічний клієнт.
Додайте Redirect URI, указаний клієнтом MCP.
Виберіть мінімально необхідні дозволи.
Передайте отриманий client_id користувачу або додайте його в налаштування клієнта.

Такий застосунок зможе підключатися лише до акаунта, у якому його створено. Докладніше — у статті Додатки OAuth і MCP в акаунті.

Кілька акаунтів

Кожне підключення пов’язане з одним акаунтом і одним користувачем.

Для підключення через DCR додайте інший сервер MCP під іншою назвою та під час входу виберіть інший акаунт, у якому ви маєте права адміністратора.
Застосунок, створений в акаунті, та його client_id працюють лише в акаунті, у якому їх створено. Для іншого акаунта його адміністратор має створити окремий публічний застосунок; додайте його в Codex під іншою назвою з новим client_id.

Не змінюйте URL-адресу MCP і не додавайте назву акаунта до запитів. Сервер визначає акаунт за виданим токеном OAuth.

Відключення MCP

Щоб відкликати підключення:

Відкрийте картку користувача в Planfix.
Перейдіть до розділу Керування сеансами.
Знайдіть застосунок із позначкою MCP і видаліть сеанс.
Видаліть або вимкніть сервер у клієнті MCP, якщо він більше не потрібен.

Видалення сеансу відкликає пов’язані токени OAuth. Щоб підключитися знову, потрібно повторно увійти й надати згоду.

Адміністратор може відкликати доступ застосунку для всього акаунта в розділі Керування акаунтом → API → Застосунки OAuth і MCP.

Безпека

Підключайте лише ті застосунки, яким довіряєте.
Перш ніж схвалювати застосунок, перевірте його назву, власника, Redirect URI та запитані дозволи.
Надавайте мінімально необхідні дозволи. Для сценарію лише з переглядом не надавайте дозволів на змінення чи видалення.
Ніколи не вставляйте токен доступу або токен оновлення в чат, налаштування запитів чи журнали.
Пам’ятайте, що вміст завдань, контактів і коментарів може надсилатися до зовнішнього сервісу ШІ згідно з умовами обробки даних цього сервісу.
Видаліть підключення в розділі Керування сеансами, якщо воно більше не використовується або вам невідоме.

Усунення несправностей

Якщо для входу через DCR потрібне схвалення адміністратора, увійдіть як адміністратор акаунта або технічний адміністратор і натисніть Дозволити та підключити. Звичайний співробітник не може передати вже розпочатий запит DCR на окреме схвалення.

Повідомлення або симптом	Що робити
Застосунок заблоковано політикою акаунта	Адміністратор має схвалити конкретний застосунок або змінити політику щодо сторонніх застосунків.
Після входу клієнт знову запитує авторизацію	Видаліть підключення з клієнта й створіть його знову. Переконайтеся, що використовується точна URL-адреса MCP.
Вибрано неправильний акаунт	Відкличте підключення та увійдіть знову, вибравши правильний акаунт. Токен не можна переключити на інший акаунт.
Клієнт запитує `client_id`	Попросіть адміністратора створити публічний застосунок для акаунта й додайте сервер MCP із параметром `--oauth-client-id`.
Операція недоступна	Перевірте надані дозволи та власні права доступу користувача в Planfix.