Planfix MCP
MCP (Model Context Protocol) AI yordamchilari va boshqa mos ilovalarga standart protokol orqali Planfix ma’lumotlari bilan ishlash imkonini beradi.
Ulanish o‘rnatilgandan so‘ng, mijoz faqat aniq ruxsat berilgan imkoniyatlardan foydalanadi va tizimga kirgan xodim nomidan ishlaydi. Planfix’ning standart kirish ruxsatlari hamon amal qiladi: AI yordamchisi ushbu foydalanuvchiga ochiq bo‘lmagan ma’lumotlarni ko‘ra yoki o‘zgartira olmaydi.
Mavjud amallar MCP mijoziga, berilgan ruxsatlarga va serverning joriy versiyasiga bog‘liq. Masalan, tegishli ruxsatlar berilganida mijoz vazifalar va kontaktlarni topishi, ularning tafsilotlarini o‘qishi va izoh qo‘shishi mumkin.
Talablar
- Planfix xodim hisobi (pulli tarif);
- Streamable HTTP va OAuth’ni qo‘llab-quvvatlaydigan MCP mijozi.
MCP server manzili
Ushbu MCP server URL manzilidan foydalaning:
https://mcp.planfix.com/mcp
URL barcha Planfix hisoblari uchun bir xil. Unga hisob nomini qo‘shmang yoki alohida hisob sarlavhasini yubormang. Hisob OAuth orqali avtorizatsiya jarayonida tanlanadi.
Istalgan MCP mijozini ulash
- Mijozdagi MCP server sozlamalarini oching.
- Streamable HTTP transportidan foydalanib yangi server qo‘shing.
Planfixkabi nom va MCP URL manzilini kiriting.- Sozlamalarni saqlang va OAuth orqali autentifikatsiyani boshlang.
- Ochilgan brauzer oynasida Planfix hisobingizni tanlang. Uni nomi, URL manzili yoki elektron pochta manzili orqali topishingiz mumkin.
- Ilova nomi va so‘ralayotgan ruxsatlarni tekshiring, so‘ng ulanishni tasdiqlang.
Agar ilovaga hisobda hali ruxsat berilmagan bo‘lsa, Planfix administrator tasdig‘i kerakligini bildiradi. Hisob administratori yoki texnik administrator ilovani tasdiqlashi mumkin. Agar administrator ulanishni o‘zi amalga oshirayotgan bo‘lsa, u bir amal bilan tasdiqlashi va ulashi mumkin.
Codex’ni DCR orqali ulashda tizimga kirish boshlanganidan keyin so‘rovni administratorga yo‘naltirib bo‘lmaydi. Shuning uchun keyingi bo‘limdan mos ssenariyni oldindan tanlang.
Codex’ni ulash
Ulanadigan hisob administratori ekanligingizga qarab variantni tanlang.
Agar siz administrator bo‘lsangiz: DCR orqali ulash
Bu variant hisob administratori yoki texnik administrator uchun mavjud. Tizimga kirish vaqtida ular avtomatik ro‘yxatdan o‘tgan ilovani tasdiqlashi va uni ulashi mumkin.
MCP serverini qo‘shing:
codex mcp add planfix --url https://mcp.planfix.com/mcp
OAuth orqali tizimga kirishni boshlang va mijozni ro‘yxatdan o‘tkazish usuli sifatida DCR’ni aniq tanlang:
codex mcp login planfix --oauth-client-registration dcr
Codex brauzerni ochadi. O‘zingiz administrator bo‘lgan Planfix hisobini tanlang, so‘ralayotgan ruxsatlarni tekshiring va Ruxsat berish va ulash tugmasini bosing.
DCR orqali ro‘yxatdan o‘tgan ilova uchun hisob egasining aniq tasdig‘i doim talab qilinadi. Oddiy xodim bu ssenariyni boshlamasligi kerak: hozircha DCR ulanishi so‘rovini kechiktirib, alohida tasdiqlash uchun administratorga yo‘naltirib bo‘lmaydi.
--oauth-client-registration dcr parametri faqat shu tizimga kirish jarayoniga tegishli va config.toml fayliga saqlanmaydi. Codex olingan OAuth ulanish ma’lumotlarini o‘zi saqlaydi.
Agar siz administrator bo‘lmasangiz: client_id orqali ulash
Avval hisob administratoridan yoki texnik administratordan ilova yaratishni so‘rang:
- Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
- Ushbu hisob ilovalari blokida Ilova yaratish tugmasini bosing.
- Nom kiriting, masalan, Codex.
- Public client turini tanlang. Codex uchun mijoz siri talab qilinmaydi.
-{R|http://127.0.0.1/callback}-yo‘naltirish URI manzilini qo‘shing.- Zarur bo‘lgan eng kam ruxsatlarni tanlang va ilovani saqlang.
- Olingan
client_idqiymatini foydalanuvchiga bering.
Planfix issuer manzilini e’lon qiladi va avtorizatsiya javobini unga bog‘lashni qo‘llab-quvvatlaydi. Shu sababli, oldindan ro‘yxatdan o‘tkazilgan yangi Codex mijozi barqaror -{R|http://127.0.0.1/callback}- qayta chaqiruv manzilidan foydalanadi. Tizimga kirish vaqtida Codex vaqtinchalik loopback portini qo‘shadi; xost va yo‘l o‘zgarmasa, Planfix bunday portga ruxsat beradi.
Foydalanuvchi berilgan identifikatorni qo‘yib, serverni qo‘shadi:
codex mcp add planfix --url https://mcp.planfix.com/mcp --oauth-client-id CLIENT_ID
Codex to‘liq qayta chaqiruv URL manzilini ko‘rsatadi. Standart sozlamada u quyidagicha ko‘rinadi:
OAuth callback URL: http://127.0.0.1/callback
Agar Codex’ning maxsus sozlamalari tufayli boshqa manzil ko‘rsatilsa, administratordan shu yo‘naltirish URI manzilini ilovaga qo‘shishni so‘rang.
So‘ng quyidagini bajaring:
codex mcp login planfix
--oauth-client-id parametrini berish Codex oldindan ro‘yxatdan o‘tgan mijozdan foydalanishini va CIMD yoki DCR’ni boshlamasligini anglatadi. Sozlamalar taxminan quyidagicha saqlanadi:
[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 ilovasi va IDE kengaytmasi
Codex ilovasi, Codex CLI va IDE kengaytmasi bitta kompyuterda umumiy MCP konfiguratsiyasidan foydalanadi. CLI orqali birinchi marta ulangandan so‘ng, ilova yoki kengaytmani qayta ishga tushiring. Server Sozlamalar → MCP serverlari bo‘limida paydo bo‘ladi. Uning yonida Autentifikatsiya qilish ko‘rsatilsa, shu tugmani bosing va tizimga kirishni yakunlang.
Faol MCP serverlarini Codex kiritish maydonidagi /mcp buyrug‘i orqali tekshirishingiz mumkin.
Ulanishlar ro‘yxati va holatini quyidagi buyruq bilan ko‘rish mumkin:
codex mcp list
Joriy interfeys elementlari, buyruqlar va qayta chaqiruv manzilini tanlash qoidalari OpenAI’ning rasmiy MCP hujjatlarida bayon qilingan.
Boshqa MCP mijozi avtomatik ro‘yxatdan o‘ta olmasa
Zamonaviy MCP mijozi CIMD yoki DCR orqali avtomatik ro‘yxatdan o‘tishi mumkin. Bunday ro‘yxatdan o‘tishning o‘zi hisobga kirish huquqini bermaydi: hisob qoidalari va administrator tasdig‘i hamon amal qiladi.
Agar mijoz oldindan belgilangan client_id talab qilsa, administratordan hisob uchun ochiq ilova yaratishni so‘rang:
- Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
- Ushbu hisob ilovalari blokida ilova yarating.
- Public client turini tanlang.
- MCP mijozida ko‘rsatilgan yo‘naltirish URI manzilini qo‘shing.
- Zarur bo‘lgan eng kam ruxsatlarni tanlang.
- Olingan
client_idqiymatini foydalanuvchiga bering yoki uni mijoz sozlamalariga qo‘shing.
Bunday ilova faqat uni yaratgan hisobga ulana oladi. Tafsilotlar — Hisobdagi OAuth va MCP ilovalari maqolasida.
Bir nechta hisob
Har bir ulanish bitta hisob va bitta foydalanuvchiga bog‘langan.
- DCR orqali ulanish uchun boshqa nom ostida yana bir MCP server qo‘shing va tizimga kirish vaqtida administrator huquqiga ega bo‘lgan boshqa hisobni tanlang.
- Hisobga tegishli ilova va uning
client_idqiymati faqat ularni yaratgan hisobda ishlaydi. Boshqa hisob uchun uning administratori alohida ochiq ilova yaratishi kerak; uni yangiclient_idbilan Codex’ga boshqa nom ostida qo‘shing.
MCP URL manzilini o‘zgartirmang va so‘rovlarga hisob nomini qo‘shmang. Server hisobni berilgan OAuth tokeni orqali aniqlaydi.
MCP ulanishini uzish
Ulanishni bekor qilish uchun:
- Planfix’da foydalanuvchi kartangizni oching.
- Seanslarni boshqarish bo‘limiga o‘ting.
- MCP deb belgilangan ilovani toping va seansni o‘chiring.
- Agar endi kerak bo‘lmasa, MCP mijozidagi serverni olib tashlang yoki o‘chirib qo‘ying.
Seansni o‘chirish unga bog‘langan OAuth tokenlarini bekor qiladi. Qayta ulanish uchun tizimga yangidan kirish va rozilik berish kerak.
Administrator Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limida ilovani butun hisob uchun bekor qilishi mumkin.
Xavfsizlik
- Faqat ishonchli ilovalarni ulang.
- Tasdiqlashdan oldin ilova nomi, egasi, yo‘naltirish URI manzili va so‘ralayotgan ruxsatlarni tekshiring.
- Zarur bo‘lgan eng kam ruxsatlarni bering. Faqat o‘qish uchun foydalaniladigan holatlarda o‘zgartirish yoki o‘chirish ruxsatlarini bermang.
- Kirish yoki yangilash tokenini hech qachon chatga, so‘rov sozlamalariga yoki jurnallarga joylamang.
- Vazifa, kontakt va izohlar mazmuni tashqi AI xizmatiga yuborilishi mumkinligini, bu xizmatning ma’lumotlarni qayta ishlash shartlariga muvofiq ekanini yodda tuting.
- Ulanishdan foydalanilmayotgan yoki uni tanimasangiz, uni Seanslarni boshqarish bo‘limidan olib tashlang.
Muammolarni bartaraf etish
Agar DCR orqali tizimga kirishda administrator tasdig‘i talab qilinsa, hisob administratori yoki texnik administrator sifatida tizimga kiring va Ruxsat berish va ulash tugmasini bosing. Oddiy xodim boshlangan DCR so‘rovini alohida tasdiqlash uchun administratorga yo‘naltira olmaydi.
| Xabar yoki alomat | Nima qilish kerak |
|---|---|
| Ilova hisob siyosati tomonidan bloklangan | Administrator muayyan ilovani tasdiqlashi yoki uchinchi tomon ilovalari siyosatini o‘zgartirishi kerak. |
| Mijoz tizimga kirgandan keyin yana avtorizatsiya so‘raydi | Mijozdagi ulanishni olib tashlang va qayta yarating. Aynan MCP URL manzilidan foydalanilayotganiga ishonch hosil qiling. |
| Noto‘g‘ri hisob tanlangan | Ulanishni bekor qiling va to‘g‘ri hisobni tanlab, qayta kiring. Tokenni boshqa hisobga o‘tkazib bo‘lmaydi. |
Mijoz client_id so‘raydi
|
Administratordan hisob uchun ochiq ilova yaratishini va MCP serverini --oauth-client-id parametri bilan qo‘shishini so‘rang.
|
| Amalni bajarib bo‘lmaydi | Berilgan ruxsatlar doirasini va foydalanuvchining Planfix’dagi o‘z kirish ruxsatlarini tekshiring. |