MCP

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

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

Доступні дії залежать від 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 секрет клієнта не потрібен.
Додайте URI перенаправлення http://127.0.0.1/callback.
Виберіть мінімально необхідні дозволи та збережіть програму.
Передайте користувачу отриманий client_id.

Planfix публікує видавця та підтримує прив’язування до нього відповіді авторизації, тому новий попередньо зареєстрований клієнт 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 показано іншу адресу, попросіть адміністратора додати цей 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.
Створіть програму в блоці Програми цього акаунта.
Виберіть тип Публічний клієнт.
Додайте URI перенаправлення, указаний MCP-клієнтом.
Виберіть мінімально необхідні дозволи.
Передайте отриманий client_id користувачу або додайте його в налаштування клієнта.

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

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

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

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

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

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

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

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

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

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

Безпека

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

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

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

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