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‘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

  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‘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:

  1. Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
  2. Ushbu hisob ilovalari blokida Ilova yaratish tugmasini bosing.
  3. Nom kiriting, masalan, Codex.
  4. Public client turini tanlang. Codex uchun mijoz siri talab qilinmaydi.
  5. -{R|http://127.0.0.1/callback}- yo‘naltirish URI manzilini qo‘shing.
  6. Zarur bo‘lgan eng kam ruxsatlarni tanlang va ilovani saqlang.
  7. Olingan client_id qiymatini 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:

  1. Hisob boshqaruvi → API → OAuth va MCP ilovalari bo‘limini oching.
  2. Ushbu hisob ilovalari blokida ilova yarating.
  3. Public client turini tanlang.
  4. MCP mijozida ko‘rsatilgan yo‘naltirish URI manzilini qo‘shing.
  5. Zarur bo‘lgan eng kam ruxsatlarni tanlang.
  6. Olingan client_id qiymatini 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_id qiymati faqat ularni yaratgan hisobda ishlaydi. Boshqa hisob uchun uning administratori alohida ochiq ilova yaratishi kerak; uni yangi client_id bilan 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:

  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 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.

O‘tish