Планфих МCП

МCП (Модел Cонтехт Протоcол) АИ ёрдамчилари ва бошқа мос иловаларга стандарт протокол орқали Планфих маълумотлари билан ишлаш имконини беради.

Уланиш ўрнатилгач, мижоз фақат аниқ рухсат берилган имкониятлардан фойдаланади ва тизимга кирган ходим номидан ишлайди. Планфих’нинг стандарт кириш рухсатлари ҳамон амал қилади: АИ ёрдамчиси ушбу фойдаланувчи учун мавжуд бўлмаган маълумотларни кўра ёки ўзгартира олмайди.

Мавжуд амаллар МCП мижозига, берилган рухсатларга ва сервернинг жорий версиясига боғлиқ. Масалан, тегишли рухсатлар берилганда, мижоз вазифалар ва контактларни топиши, уларнинг тафсилотларини ўқиши ва изоҳлар қўшиши мумкин.

Талаблар

Планфих ходими ҳисоби;
Стреамабле ҲТТП ва ОАутҳ’ни қўллаб-қувватлайдиган МCП мижози.

МCП сервер манзили

Ушбу МCП сервер УРЛ манзилидан фойдаланинг:

https://mcp.planfix.com/mcp

УРЛ барча Планфих ҳисоблари учун бир хил. Унга ҳисоб номини қўшманг ва алоҳида ҳисоб сарлавҳасини юборманг. Ҳисоб ОАутҳ авторизацияси вақтида танланади.

Исталган МCП мижозини улаш

Мижоздаги МCП сервер созламаларини очинг.
Стреамабле ҲТТП транспортидан фойдаланиб, янги сервер қўшинг.
Planfix каби ном ва МCП УРЛ манзилини киритинг.
Созламаларни сақланг ва ОАутҳ орқали аутентификацияни бошланг.
Очилган браузер ойнасида Планфих ҳисобингизни танланг. Уни номи, УРЛ манзили ёки электрон почта манзили орқали топишингиз мумкин.
Илова номи ва сўралган рухсатларни текширинг, сўнг уланишни тасдиқланг.

Агар иловага ҳисобда ҳали рухсат берилмаган бўлса, Планфих администратор тасдиғи кераклигини билдиради. Ҳисоб администратори ёки техник администратор иловани тасдиқлаши мумкин. Агар улаётган шахснинг ўзи администратор бўлса, у иловани бир амал билан тасдиқлаб, улаши мумкин.

Cодех учун ДCР уланишида тизимга кириш бошланганидан кейин сўровни администраторга юбориб бўлмайди, шунинг учун кейинги бўлимдан мос усулыг олдиндан танланг.
Cодех учун бундай тасдиқ CИМД иловаси ҳисобга биринчи марта уланганидагина талаб қилинади. Уни администратор бажариши керак. Шундан сўнг ходимлар мустақил уланишлари мумкин.

Cодех’ни улаш

Уланадиган ҳисобнинг администратори эканингизга қараб, мос вариантни танланг.

Тавсия этилади: CИМД орқали улаш

планфих.cом сайтида Cодех CИМД’ни автоматик танлайди. Администратор ҳисобдаги CИМД иловасини бир марта тасдиқлайди, шундан сўнг ходимлар иловани қайта тасдиқлатмасдан ОАутҳ орқали мустақил тизимга киришлари мумкин. Бу усулда иловани қўлда яратиш, client_id бериш, йўналтириш УРИ манзилини қўшиш ёки мижоз сирини сақлаш шарт эмас.

Биринчи уланишни ҳисоб администратори ёки техник администратор қуйидаги буйруқлар орқали амалга оширади:

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

Cодех браузерни очади. Ўзингиз администратор бўлган Планфих ҳисобини танланг, сўралган рухсатларни кўриб чиқинг ва Тасдиқлаш ва улаш тугмасини босинг. CИМД иловасига ушбу ҳисобда фақат бир марта рухсат бериш керак.

Шундан кейин кириш ҳуқуқи керак бўлган ҳар бир ходим шу буйруқларни бажаради:

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

Ходим ўз Планфих ҳисоби билан тизимга киради ва ўз кириш ҳуқуқини тасдиқлайди. Администратор CИМД иловасини қайта тасдиқлаши шарт эмас.

Муқобил усул: ҳисобга тегишли иловадан фойдаланиш

Ҳисоб бошқарадиган, доимий client_id’га эга олдиндан белгиланган ОАутҳ мижозига эҳтиёж бўлса ёки конфигурациянгизда CИМД’дан фойдаланиб бўлмаса, ушбу усулни танланг.

Ҳисоб администратори ёки техник администратор илова яратади:

Ҳисоб бошқаруви → АПИ → ОАутҳ ва МCП иловалари бўлимини очинг.
Ушбу ҳисобга тегишли иловалар бўлимида Илова яратиш бандини танланг.
Codex каби ном киритинг.
Оммавий мижоз бандини танланг. Cодех’га мижоз сири керак эмас.
Йўналтириш УРИ манзили сифатида http://127.0.0.1/callback манзилини қўшинг.
Керакли энг кам рухсатларни танланг ва иловани сақланг.
Яратилган client_id’ни уланишни амалга оширадиган ходимларга беринг.

Планфих иссуэр’ни эълон қилади ва иссуэр’га боғланган авторизация жавобларини қўллаб-қувватлайди. Шу сабабли, олдиндан рўйхатдан ўтказилган янги Cодех мижозида барқарор http://127.0.0.1/callback қайта чақирув манзили ишлатилади. Тизимга кириш вақтида Cодех вақтинчалик лоопбаcк портини қўшади. Ҳост ва йўл ўзгармаса, Планфих ушбу портни қабул қилади.

Ҳар бир фойдаланувчи берилган ИД орқали серверни қўшади ва тизимга киради:

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

Cодех тўлиқ қайта чақирув УРЛ манзилини кўрсатади. Стандарт конфигурацияда у қуйидагича бўлади:

OAuth callback URL: http://127.0.0.1/callback

Агар Cодех махсус қайта чақирув созламаси сабабли бошқа манзилни кўрсаца, администратордан иловага айнан шу йўналтириш УРИ манзилини қўшишни сўранг.

--oauth-client-id параметри Cодех’га олдиндан рўйхатдан ўтказилган мижоздан фойдаланишни ва CИМД ҳамда ДCР’ни ўтказиб юборишни билдиради. Сақланган конфигурация қуйидагига ўхшайди:

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

Тизимга кириш бошланганда, Планфих иловага эгалик қилувчи ҳисобни очади. Рухсатларни кўриб чиқинг ва уланишни тасдиқланг.

Cодех иловаси ва ИДЕ кенгайтмаси

Cодех иловаси, Cодех CЛИ ва ИДЕ кенгайтмаси бир компютерда МCП конфигурациясидан биргаликда фойдаланади. CЛИ’да дастлабки созлашдан сўнг илова ёки кенгайтмани қайта ишга туширинг. Сервер Созламалар → МCП серверлари бўлимида пайдо бўлади. Агар унда Аутентификация қилиш кўрсатилса, шу бандни танлаб, тизимга киришни якунланг.

Фаол МCП серверларини кўриш учун Cодех cомпосер’ига /mcp деб киритинг.

CЛИ орқали созланган серверлар ва уларнинг ҳолатини кўриш учун қуйидаги буйруқни бажаринг:

codex mcp list

Cодех’нинг жорий бошқарув элементлари, буйруқлари ва қайта чақирув манзилини танлаш қоидалари ОпенАИ’нинг расмий МCП ҳужжатларида баён қилинган.

Cодех’да бир нечта ҳисобдан фойдаланиш

Ҳар бир уланиш битта ҳисоб ва битта фойдаланувчига боғланади.

CИМД’дан фойдаланганда, уланмоқчи бўлган ҳар бир ҳисобда администратор иловага бир марта рухсат бериши керак. Ҳар бир уланишни бошқа ном билан қўшинг ва ОАутҳ орқали тизимга киришда керакли ҳисобни танланг. Ҳисобга тегишли иловалардан фойдалансангиз, ҳар бир ҳисоб учун алоҳида илова ва client_id керак бўлади.

МCП УРЛ манзилини ўзгартирманг ва сўровларга ҳисоб номини қўшманг. Сервер ҳисобни ОАутҳ токени орқали аниқлайди.

Cодех уланишидаги муаммоларни бартараф этиш

Агар биринчи CИМД орқали тизимга киришда администратор тасдиғи талаб қилинса, уланишни ҳисоб администратори ёки техник администратор сифатида якунланг ва Тасдиқлаш ва улаш тугмасини босинг. Иловага рухсат берилгач, ходимлар мустақил тизимга киришлари мумкин.

Агар CИМД’дан фойдаланиб бўлмаса ва Cодех client_id сўраса, юқорида баён қилинган ҳисобга тегишли иловадан фойдаланиш усулини танланг.

Автоматик рўйхатдан ўтказиш имконияти бўлмаган бошқа МCП мижозлари

Замонавий МCП мижозлари CИМД ёки ДCР орқали автоматик рўйхатдан ўтиши мумкин. Автоматик рўйхатдан ўтишнинг ўзи ҳисобга кириш ҳуқуқини бермайди: ҳисоб сиёсати ва администратор тасдиғи барибир талаб қилинади.

Агар бошқа мижоз олдиндан белгиланган client_id талаб қилса, администратордан ҳисобга тегишли оммавий илова яратишни сўранг:

Ҳисоб бошқаруви → АПИ → ОАутҳ ва МCП иловалари бўлимини очинг.
Ушбу ҳисобга тегишли иловалар бўлимида илова яратинг.
Оммавий мижоз бандини танланг.
МCП мижози кўрсатган йўналтириш УРИ манзилини қўшинг.
Керакли энг кам рухсатларни танланг.
Яратилган client_id’ни фойдаланувчига беринг ёки мижоз созламаларига киритинг.

Илова фақат уни яратган ҳисобга уланиши мумкин. Тафсилотлар учун Ҳисобдаги ОАутҳ ва МCП иловалари саҳифасига қаранг.

МCП уланишини узиш

Уланишни бекор қилиш учун:

Планфих’да фойдаланувчи картангизни очинг.
Сеансларни бошқариш бўлимига ўтинг.
МCП деб белгиланган иловани топинг ва сеансни ўчиринг.
Агар МCП мижозидаги сервер энди керак бўлмаса, уни олиб ташланг ёки ўчириб қўйинг.

Сеансни ўчириш унга тегишли ОАутҳ токенларини бекор қилади. Қайта уланиш учун тизимга янгидан кириш ва розилик бериш керак.

Администратор бутун ҳисоб учун илованинг рухсатини Ҳисоб бошқаруви → АПИ → ОАутҳ ва МCП иловалари бўлимида бекор қилиши мумкин.

Хавфсизлик

Фақат ишончли иловаларни уланг.
Тасдиқлашдан олдин илова номи, эгаси, йўналтириш УРИ манзили ва сўралган рухсатларни текширинг.
Керакли энг кам рухсатларни беринг. Фақат ўқиш учун фойдаланиладиган ҳолатларда ўзгартириш ёки ўчириш рухсатларини берманг.
Кириш токени ёки янгилаш токенини ҳеч қачон чатга, сўров созламаларига ёки журналларга жойламанг.
Вазифа, контакт ва изоҳлар мазмуни тегишли хизматнинг маълумотларни қайта ишлаш шартларига мувофиқ ташқи АИ хизматига юборилиши мумкинлигини унутманг.
Уланиш энди ишлатилмаса ёки таниш бўлмаса, уни Сеансларни бошқариш бўлимидан олиб ташланг.

Муаммоларни бартараф этиш

ДCР орқали тизимга киришда администратор тасдиғи талаб қилинса, ҳисоб администратори ёки техник администратор сифатида тизимга киринг ва Рухсат бериш ва улаш тугмасини босинг. Оддий ходим бошланган ДCР сўровини алоҳида тасдиқлаш учун бошқа шахсга юбора олмайди.
Биринчи CИМД орқали тизимга киришда администратор тасдиғи талаб қилинса, уланишни ҳисоб администратори ёки техник администратор сифатида якунланг ва Рухсат бериш ва улаш тугмасини босинг. Иловага рухсат берилгач, ходимлар мустақил тизимга кира олади.

Хабар ёки аломат	Нима қилиш керак
Илова ҳисоб сиёсати томонидан блокланган	Администратор муайян иловани тасдиқлаши ёки учинчи томон иловалари сиёсатини ўзгартириши керак.
Мижоз тизимга киргандан кейин авторизацияни яна сўрайди	Уланишни мижоздан олиб ташланг ва қайтадан яратинг. Айнан МCП УРЛ манзилидан фойдаланаётганингизни текширинг.
Нотўғри ҳисоб танланган	Уланишни бекор қилинг ва тўғри ҳисобни танлаб, қайта тизимга киринг. Токенни бошқа ҳисобга ўтказиб бўлмайди.
Амални бажариб бўлмайди	Берилган рухсатлар доирасини ва фойдаланувчининг Планфих’даги ўз кириш рухсатларини текширинг.