Skip to content

Hisobdagi OAuth va MCP ilovalari


OAuth va MCP ilovalari bo‘limida tashqi ilovalarni Planfix hisobiga ulash sozlamalari mavjud.

Hisobni boshqarish → API → OAuth va MCP ilovalari bo‘limiga o‘ting. Bu bo‘lim hisob administratorlari va texnik administratorlar uchun mavjud.

Unda uchta bo‘lim mavjud:

  • MCP — MCP server manzili va ulanish bo‘yicha qisqacha ko‘rsatmalar;
  • Bu hisobga tegishli ilovalar — aynan joriy hisob uchun yaratilgan OAuth ilovalari;
  • Uchinchi tomon ilovalari — umumiy siyosat va hisobda aniq tasdiqlangan ilovalar.

MCP

Bu bo‘limda Planfix MCP URL manzili ko‘rsatiladi:


https://mcp.planfix.com/mcp


Odatda foydalanuvchi bu URL manzilni mos MCP mijoziga qo‘shishi va OAuth orqali tizimga kirishi kifoya. Hisob nomi Planfix sahifasida tanlanadi va URL manziliga kiritilmaydi. Bosqichma-bosqich ko‘rsatmalar uchun Planfix MCP sahifasiga qarang.

Bu hisobga tegishli ilovalar

Agar integratsiya faqat joriy hisob uchun mo‘ljallangan bo‘lsa va tashqi mijozga oldindan belgilangan client_id kerak bo‘lsa, hisobga tegishli ilova yarating.

Hisobga tegishli ilova:

  • boshqa hisoblarga ulana olmaydi;
  • uchinchi tomon ilovalari siyosatidan qat’i nazar, o‘z egasi bo‘lgan hisobda mavjud bo‘ladi;
  • global OAuth yakuniy nuqtalaridan foydalanadi;
  • tanlangan qamrovlar doirasida REST API yoki MCP bilan ishlashi mumkin.

Ilova yaratish

  1. Ilova yaratish bandini tanlang.
  2. Aniq nom va tavsif kiriting.
  3. OAuth mijoz turini tanlang.
  4. Mijozning qayta yo‘naltirish URI manzillarini qo‘shing.
  5. Kerakli eng kam kirish darajalarini tanlang.
  6. Ilovani saqlang va yaratilgan hisob ma’lumotlarini nusxalang.
Mijoz turi Qachon foydalaniladi
Ommaviy Mobil, kompyuter yoki brauzer ilovasi yoxud mahalliy MCP mijozi uchun. Maxfiy kalit berilmaydi; avtorizatsiya jarayoni PKCE orqali himoyalanadi.
Maxfiy Maxfiy mijoz kalitini xavfsiz saqlay oladigan server tomonidagi ilova uchun. Maxfiy kalitni hech qachon mijoz tomonidagi kod, mobil ilova yoki tarqatiladigan konfiguratsiya fayliga kiritmang.

Maxfiy ilova yaratilgach, mijoz maxfiy kaliti ko‘rsatiladi. Uni xavfsiz maxfiy ma’lumotlar boshqaruvchisida saqlang.

Qayta yo‘naltirish URI manzillari va ruxsatlar

Oddiy veb-ilovalar uchun https dan foydalaning. http dan faqat localhost va 127.0.0.1 kabi loopback xostlar uchun foydalanishga ruxsat beriladi.

Integratsiya uchun faqat zarur qamrovlarni tanlang. Qamrovlar ilovaning kirish huquqlarini cheklaydi, lekin unga ulanayotgan foydalanuvchining ruxsatlarini kengaytirmaydi.

Qayta yo‘naltirish URI manzillari yoki qamrovlarni o‘zgartirish ilovaning tasdiqlash versiyasini o‘zgartiradi va avval berilgan tokenlar ilovaga mos kelmay qoladi. Foydalanuvchilar qayta ulanishi kerak bo‘ladi.

Ilovani boshqarish

Ilova kartasidan quyidagilarni bajarishingiz mumkin:

  • nom, tavsif, qayta yo‘naltirish URI manzillari va qamrovlarni tahrirlash;
  • ilovani o‘chirib qo‘yish va qayta yoqish;
  • maxfiy mijoz kalitini yangilash.

Maxfiy kalit yangilangach, avvalgi maxfiy mijoz kaliti darhol ishlamay qoladi. Yangi kalitni nusxalang va integratsiyaning server konfiguratsiyasini yangilang.

Ilovani o‘chirib qo‘yish avtorizatsiyani va u bergan tokenlardan foydalanishni bloklaydi. Ilovani o‘chirishdan oldin hech qanday biznes jarayoni unga bog‘liq emasligiga ishonch hosil qiling.

Uchinchi tomon ilovalari

Uchinchi tomon ilovalariga hamkorlarga tegishli ilovalar, e’lon qilingan ilovalar hamda CIMD yoki DCR orqali ro‘yxatdan o‘tgan MCP mijozlari kiradi.

Uchinchi tomon ilovalari siyosati

Siyosat Natija
E’lon qilingan ilovalarga ruxsat berish Planfix tomonidan e’lon qilingan ilovalardan alohida tasdiqsiz foydalanish mumkin. Hamkorlarning xususiy ilovalari va avtomatik ro‘yxatdan o‘tgan MCP mijozlari uchun administratorning alohida tasdig‘i talab qilinadi.
Faqat tasdiqlangan ilovalar Har bir uchinchi tomon ilovasi administratorning alohida tasdig‘ini talab qiladi.
Uchinchi tomon ilovalarini bloklash Uchinchi tomonning OAuth va MCP ilovalari bloklanadi. Hisobga tegishli ilovalar ishlashda davom etadi.

Har bir integratsiyani alohida ko‘rib chiqish talab etiladigan hisoblar uchun Faqat tasdiqlangan ilovalar siyosati tavsiya etiladi.

Ilovani tasdiqlash

Tasdiqlash so‘rovi ikki xil holatda paydo bo‘lishi mumkin:

  • foydalanuvchi OAuth ulanishini boshlaydi va Planfix tasdiqlash kerakligi haqida xabar beradi;
  • hamkor administratorga ilovaning bevosita havolasini yuboradi.

Ilovani tasdiqlashdan oldin quyidagilarni tekshiring:

  • uning nomi, tavsifi va egasi;
  • qayta yo‘naltirish URI manzili yoki qayta chaqiruv xosti;
  • so‘ralayotgan qamrovlar;
  • xodimlarga bu integratsiya kerak yoki kerak emasligi.

Administrator tasdig‘i hisobga tatbiq etiladi, lekin har bir foydalanuvchini avtomatik tarzda ulamaydi. Har bir xodim alohida tizimga kiradi va o‘z nomidan rozilik beradi. Agar ilovani administrator ulayotgan bo‘lsa, Tasdiqlash va ulash amali ikkala ishni ham bajaradi.

Ishlab chiquvchi uchinchi tomon ilovasining qayta yo‘naltirish URI manzillari yoki qamrovlarini o‘zgartirsa, yangi versiyani tasdiqlash kerak.

Tasdiqni bekor qilish

Ilovani hisob uchun bloklash uchun uni tasdiqlangan ilovalar ro‘yxatidan toping va unga berilgan ruxsatni bekor qiling. Bu hisobdagi foydalanuvchilarga tegishli OAuth tokenlari bekor qilinadi.

Siyosat E’lon qilingan ilovalarga ruxsat berish bo‘lsa, alohida tasdiqni bekor qilish e’lon qilingan ilovani bloklamaydi, chunki umumiy siyosat unga baribir ruxsat beradi. Ilovani bloklash uchun Faqat tasdiqlangan ilovalar yoki Uchinchi tomon ilovalarini bloklash siyosatini tanlang.

Foydalanuvchining shaxsiy ulanishlari

Hisob darajasidagi tasdiq va alohida foydalanuvchining ulanishi — boshqaruvning ikki alohida darajasi.

Xodim o‘z OAuth ulanishlarini ko‘rishi va bekor qilishi mumkin:

  1. Foydalanuvchi kartangizni oching.
  2. Seanslarni boshqarish bo‘limiga o‘ting.
  3. Ilovani toping; MCP ulanishlari MCP deb belgilanadi.
  4. Seansni o‘chiring.

Seansni o‘chirish unga tegishli tokenlarni bekor qiladi. Ruxsatni tiklash uchun foydalanuvchi OAuth orqali qayta avtorizatsiyadan o‘tishi kerak.

Administratorlar uchun tavsiyalar

  • Har bir integratsiyani alohida ko‘rib chiqish kerak bo‘lsa, Faqat tasdiqlangan ilovalar siyosatidan foydalaning.
  • Faqat nomini emas, ilova egasi va qayta yo‘naltirish URI manzilini ham tekshiring.
  • Ayniqsa, ma’lumotlarni o‘zgartirish va o‘chirish uchun zarur bo‘lgan eng kam qamrovlarni tasdiqlang.
  • Uchinchi tomon ilovalari ro‘yxatini vaqti-vaqti bilan ko‘rib chiqing va ishlatilmaydigan ilovalarni olib tashlang.
  • Mahalliy va kompyuter mijozlari uchun ommaviy mijoz turidan, server tomonidagi integratsiyalar uchun esa maxfiy mijoz turidan foydalaning.
  • Maxfiy ilovaning hisob ma’lumotlari oshkor bo‘lgan bo‘lishi mumkin bo‘lsa, uning maxfiy kalitini darhol yangilang va zarur bo‘lsa, integratsiyani qayta ulang.

O‘tish