Skip to content

Planfix MCP

MCP (Model Context Protocol) AI yordamchilari va boshqa mos ilovalarga standart protokol orqali Planfix maʼlumotlari bilan ishlash imkonini beradi.

Ulanish o‘rnatilgach, mijoz faqat aniq ruxsat berilgan imkoniyatlardan foydalanadi va tizimga kirgan xodim nomidan ishlaydi. Planfix’ning standart kirish ruxsatlari hamon amal qiladi: AI yordamchisi ushbu foydalanuvchi uchun mavjud 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 berilganda, mijoz vazifalar va kontaktlarni topishi, ularning tafsilotlarini o‘qishi va izohlar qo‘shishi mumkin.

Talablar

  • Planfix xodimi hisobi;
  • 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 va alohida hisob sarlavhasini yubormang. Hisob OAuth avtorizatsiyasi vaqtida tanlanadi.

Istalgan MCP mijozini ulash

  1. Mijozdagi MCP server sozlamalarini oching.
  2. Streamable HTTP transportidan foydalanib, yangi server qo‘shing.
  3. Planfix kabi nom va MCP URL manzilini kiriting.
  4. Sozlamalarni saqlang va OAuth orqali autentifikatsiyani boshlang.
  5. Ochilgan brauzer oynasida Planfix hisobingizni tanlang. Uni nomi, URL manzili yoki elektron pochta manzili orqali topishingiz mumkin.
  6. Ilova nomi va so‘ralgan 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 ulayotgan shaxsning o‘zi administrator bo‘lsa, u ilovani bir amal bilan tasdiqlab, ulashi mumkin.

  • Codex uchun DCR ulanishida tizimga kirish boshlanganidan keyin so‘rovni administratorga yuborib bo‘lmaydi, shuning uchun keyingi bo‘limdan mos usulыg oldindan tanlang.
  • Codex uchun bunday tasdiq CIMD ilovasi hisobga birinchi marta ulanganidagina talab qilinadi. Uni administrator bajarishi kerak. Shundan so‘ng xodimlar mustaqil ulanishlari mumkin.

Codex’ni ulash

Ulanadigan hisobning administratori ekaningizga qarab, mos variantni tanlang.


Tavsiya etiladi: CIMD orqali ulash

planfix.com saytida Codex CIMD’ni avtomatik tanlaydi. Administrator hisobdagi CIMD ilovasini bir marta tasdiqlaydi, shundan so‘ng xodimlar ilovani qayta tasdiqlatmasdan OAuth orqali mustaqil tizimga kirishlari mumkin. Bu usulda ilovani qo‘lda yaratish, client_id berish, yo‘naltirish URI manzilini qo‘shish yoki mijoz sirini saqlash shart emas.

Birinchi ulanishni hisob administratori yoki texnik administrator quyidagi buyruqlar orqali amalga oshiradi: 

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

Codex brauzerni ochadi. O‘zingiz administrator bo‘lgan Planfix hisobini tanlang, so‘ralgan ruxsatlarni ko‘rib chiqing va Tasdiqlash va ulash tugmasini bosing. CIMD ilovasiga ushbu hisobda faqat bir marta ruxsat berish kerak.

Shundan keyin kirish huquqi kerak bo‘lgan har bir xodim shu buyruqlarni bajaradi: 

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

Xodim o‘z Planfix hisobi bilan tizimga kiradi va o‘z kirish huquqini tasdiqlaydi. Administrator CIMD ilovasini qayta tasdiqlashi shart emas.

Muqobil usul: hisobga tegishli ilovadan foydalanish

Hisob boshqaradigan, doimiy client_id’ga ega oldindan belgilangan OAuth mijoziga ehtiyoj bo‘lsa yoki konfiguratsiyangizda CIMD’dan foydalanib bo‘lmasa, ushbu usulni tanlang.

Hisob administratori yoki texnik administrator ilova yaratadi:

  1. Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
  2. Ushbu hisobga tegishli ilovalar bo‘limida Ilova yaratish bandini tanlang.
  3. Codex kabi nom kiriting.
  4. Ommaviy mijoz bandini tanlang. Codex’ga mijoz siri kerak emas.
  5. Yo‘naltirish URI manzili sifatida http://127.0.0.1/callback manzilini qo‘shing.
  6. Kerakli eng kam ruxsatlarni tanlang va ilovani saqlang.
  7. Yaratilgan client_id’ni ulanishni amalga oshiradigan xodimlarga bering.

Planfix issuer’ni eʼlon qiladi va issuer’ga bog‘langan avtorizatsiya javoblarini qo‘llab-quvvatlaydi. Shu sababli, oldindan ro‘yxatdan o‘tkazilgan yangi Codex mijozida barqaror http://127.0.0.1/callback qayta chaqiruv manzili ishlatiladi. Tizimga kirish vaqtida Codex vaqtinchalik loopback portini qo‘shadi. Host va yo‘l o‘zgarmasa, Planfix ushbu portni qabul qiladi.

Har bir foydalanuvchi berilgan ID orqali serverni qo‘shadi va tizimga kiradi: 

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

Codex to‘liq qayta chaqiruv URL manzilini ko‘rsatadi. Standart konfiguratsiyada u quyidagicha bo‘ladi: 

OAuth callback URL: http://127.0.0.1/callback

Agar Codex maxsus qayta chaqiruv sozlamasi sababli boshqa manzilni ko‘rsatsa, administratordan ilovaga aynan shu yo‘naltirish URI manzilini qo‘shishni so‘rang.

--oauth-client-id parametri Codex’ga oldindan ro‘yxatdan o‘tkazilgan mijozdan foydalanishni va CIMD hamda DCR’ni o‘tkazib yuborishni bildiradi. Saqlangan konfiguratsiya quyidagiga o‘xshaydi: 

[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"

Tizimga kirish boshlanganda, Planfix ilovaga egalik qiluvchi hisobni ochadi. Ruxsatlarni ko‘rib chiqing va ulanishni tasdiqlang.

Codex ilovasi va IDE kengaytmasi

Codex ilovasi, Codex CLI va IDE kengaytmasi bir kompyuterda MCP konfiguratsiyasidan birgalikda foydalanadi. CLI’da dastlabki sozlashdan so‘ng ilova yoki kengaytmani qayta ishga tushiring. Server Sozlamalar → MCP serverlari bo‘limida paydo bo‘ladi. Agar unda Autentifikatsiya qilish ko‘rsatilsa, shu bandni tanlab, tizimga kirishni yakunlang.

Faol MCP serverlarini ko‘rish uchun Codex composer’iga /mcp deb kiriting.

CLI orqali sozlangan serverlar va ularning holatini ko‘rish uchun quyidagi buyruqni bajaring: 

codex mcp list

Codex’ning joriy boshqaruv elementlari, buyruqlari va qayta chaqiruv manzilini tanlash qoidalari OpenAI’ning rasmiy MCP hujjatlarida bayon qilingan.

Codex’da bir nechta hisobdan foydalanish

Har bir ulanish bitta hisob va bitta foydalanuvchiga bog‘lanadi.

CIMD’dan foydalanganda, ulanmoqchi bo‘lgan har bir hisobda administrator ilovaga bir marta ruxsat berishi kerak. Har bir ulanishni boshqa nom bilan qo‘shing va OAuth orqali tizimga kirishda kerakli hisobni tanlang. Hisobga tegishli ilovalardan foydalansangiz, har bir hisob uchun alohida ilova va client_id kerak bo‘ladi.

MCP URL manzilini o‘zgartirmang va so‘rovlarga hisob nomini qo‘shmang. Server hisobni OAuth tokeni orqali aniqlaydi.

Codex ulanishidagi muammolarni bartaraf etish

Agar birinchi CIMD orqali tizimga kirishda administrator tasdig‘i talab qilinsa, ulanishni hisob administratori yoki texnik administrator sifatida yakunlang va Tasdiqlash va ulash tugmasini bosing. Ilovaga ruxsat berilgach, xodimlar mustaqil tizimga kirishlari mumkin.

Agar CIMD’dan foydalanib bo‘lmasa va Codex client_id so‘rasa, yuqorida bayon qilingan hisobga tegishli ilovadan foydalanish usulini tanlang.

Avtomatik ro‘yxatdan o‘tkazish imkoniyati bo‘lmagan boshqa MCP mijozlari

Zamonaviy MCP mijozlari CIMD yoki DCR orqali avtomatik ro‘yxatdan o‘tishi mumkin. Avtomatik ro‘yxatdan o‘tishning o‘zi hisobga kirish huquqini bermaydi: hisob siyosati va administrator tasdig‘i baribir talab qilinadi.

Agar boshqa mijoz oldindan belgilangan client_id talab qilsa, administratordan hisobga tegishli ommaviy ilova yaratishni so‘rang:

  1. Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
  2. Ushbu hisobga tegishli ilovalar bo‘limida ilova yarating.
  3. Ommaviy mijoz bandini tanlang.
  4. MCP mijozi ko‘rsatgan yo‘naltirish URI manzilini qo‘shing.
  5. Kerakli eng kam ruxsatlarni tanlang.
  6. Yaratilgan client_id’ni foydalanuvchiga bering yoki mijoz sozlamalariga kiriting.

Ilova faqat uni yaratgan hisobga ulanishi mumkin. Tafsilotlar uchun Hisobdagi OAuth va MCP ilovalari sahifasiga qarang.

MCP ulanishini uzish

Ulanishni bekor qilish uchun:

  1. Planfix’da foydalanuvchi kartangizni oching.
  2. Seanslarni boshqarish bo‘limiga o‘ting.
  3. MCP deb belgilangan ilovani toping va seansni o‘chiring.
  4. Agar MCP mijozidagi server endi kerak bo‘lmasa, uni olib tashlang yoki o‘chirib qo‘ying.

Seansni o‘chirish unga tegishli OAuth tokenlarini bekor qiladi. Qayta ulanish uchun tizimga yangidan kirish va rozilik berish kerak.

Administrator butun hisob uchun ilovaning ruxsatini Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limida bekor qilishi mumkin.

Xavfsizlik

  • Faqat ishonchli ilovalarni ulang.
  • Tasdiqlashdan oldin ilova nomi, egasi, yo‘naltirish URI manzili va so‘ralgan ruxsatlarni tekshiring.
  • Kerakli eng kam ruxsatlarni bering. Faqat o‘qish uchun foydalaniladigan holatlarda o‘zgartirish yoki o‘chirish ruxsatlarini bermang.
  • Kirish tokeni yoki yangilash tokenini hech qachon chatga, so‘rov sozlamalariga yoki jurnallarga joylamang.
  • Vazifa, kontakt va izohlar mazmuni tegishli xizmatning maʼlumotlarni qayta ishlash shartlariga muvofiq tashqi AI xizmatiga yuborilishi mumkinligini unutmang.
  • Ulanish endi ishlatilmasa yoki tanish bo‘lmasa, uni Seanslarni boshqarish bo‘limidan olib tashlang.

Muammolarni bartaraf etish

  • 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 boshqa shaxsga yubora olmaydi.
  • Birinchi CIMD orqali tizimga kirishda administrator tasdig‘i talab qilinsa, ulanishni hisob administratori yoki texnik administrator sifatida yakunlang va Ruxsat berish va ulash tugmasini bosing. Ilovaga ruxsat berilgach, xodimlar mustaqil tizimga kira oladi.
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 avtorizatsiyani yana so‘raydi Ulanishni mijozdan olib tashlang va qaytadan yarating. Aynan MCP URL manzilidan foydalanayotganingizni tekshiring.
Noto‘g‘ri hisob tanlangan Ulanishni bekor qiling va to‘g‘ri hisobni tanlab, qayta tizimga kiring. Tokenni boshqa hisobga o‘tkazib bo‘lmaydi.
Amalni bajarib bo‘lmaydi Berilgan ruxsatlar doirasini va foydalanuvchining Planfix’dagi o‘z kirish ruxsatlarini tekshiring.

O‘tish

Retrieved from "http://planfix.com/uz/help/index.php?title=Planfix_MCP&oldid=7042"