Планфіх МЦП

МЦП (Модел Цонтехт Протоцол) АЫ көмекшілеріне және басқа үйлесімді қолданбаларға стандартты протокол арқылы Планфіх деректерімен жұмыс істеуге мүмкіндік береді.

Қосылым орнатылғаннан кейін клиент тек нақты рұқсат етілген мүмкіндіктерді алады және жүйеге кірген Қызметкер атынан әрекет етеді. Планфіх жүйесіндегі стандартты қатынас құқықтары бұрынғыдай қолданылады: АЫ көмекшісі сол пайдаланушыға қолжетімді емес ақпаратты көре немесе өзгерте алмайды.

Қолжетімді әрекеттер МЦП клиентіне, берілген рұқсаттарға және сервердің ағымдағы нұсқасына байланысты. Мысалы, тиісті рұқсаттар берілсе, клиент тапсырмалар мен контактілерді тауып, олардың мәліметтерін оқи және пікір қоса алады.

Талаптар

Планфіх Қызметкер тіркелгісі;
Стреамабле ҺТТП және ОАұтһ қолдайтын МЦП клиенті.

МЦП серверінің мекенжайы

Осы МЦП серверінің ҰРЛ мекенжайын пайдаланыңыз:

https://mcp.planfix.com/mcp

ҰРЛ мекенжайы барлық Планфіх тіркелгілері үшін бірдей. Оған тіркелгі атауын қоспаңыз және бөлек тіркелгі тақырыбын жібермеңіз. Тіркелгі ОАұтһ авторизациясы кезінде таңдалады.

Кез келген МЦП клиентін қосу

Клиенттегі МЦП серверінің баптауларын ашыңыз.
Стреамабле ҺТТП тасымалдау түрін пайдаланып, жаңа сервер қосыңыз.
Planfix сияқты атау мен МЦП ҰРЛ мекенжайын енгізіңіз.
Баптауларды сақтап, ОАұтһ аутентификациясын бастаңыз.
Ашылған браузер терезесінде Планфіх тіркелгісін таңдаңыз. Оны атауы, ҰРЛ мекенжайы немесе электрондық пошта мекенжайы бойынша табуға болады.
Қолданба атауы мен сұралған рұқсаттарды тексеріп, қосылымды растаңыз.

Егер қолданбаға тіркелгіде әлі рұқсат берілмесе, Планфіх әкімшінің мақұлдауы қажет екенін көрсетеді. Қолданбаны тіркелгі әкімшісі немесе техникалық әкімші мақұлдай алады. Егер қосылымды орнатып жатқан адам әкімші болса, ол қолданбаны бір әрекетпен мақұлдап, қоса алады.

Цодех жүйесінде ДЦР арқылы қосылғанда, жүйеге кіргеннен кейін сұрауды әкімшіге қайта бағыттау мүмкін емес. Сондықтан келесі бөлімнен сәйкес сценарийді алдын ала таңдаңыз.
Цодех үшін мұндай мақұлдау ЦЫМД қолданбасы тіркелгіге алғаш рет қосылғанда ғана қажет. Оны әкімші орындауы керек. Осыдан кейін Қызметкерлер өздері қоса алады.

Цодех жүйесін қосу

Қосылатын тіркелгінің әкімшісі екеніңізге қарай нұсқаны таңдаңыз.

Ұсынылады: ЦЫМД арқылы қосу

планфіх.цом сайтында Цодех ЦЫМД әдісін автоматты түрде таңдайды. Әкімші тіркелгідегі ЦЫМД қолданбасын бір рет мақұлдайды, содан кейін Қызметкерлер басқа қолданбаны мақұлдамай-ақ ОАұтһ арқылы өздері кіре алады. Бұл әдіс үшін қолданбаны қолмен жасаудың, client_id ұсынудың, қайта бағыттау ҰРЫ мекенжайын қосудың немесе клиент құпиясөзін сақтаудың қажеті жоқ.

Алғаш рет қосу үшін тіркелгі әкімшісі немесе техникалық әкімші мына пәрмендерді орындайды:

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

Цодех браузерді ашады. Әкімші құқықтары бар Планфіх тіркелгісін таңдап, сұралған рұқсаттарды қарап шығып, Мақұлдау және қосу түймесін басыңыз. ЦЫМД қолданбасын сол тіркелгіде бір рет қана мақұлдау қажет.

Осыдан кейін қатынас қажет әр Қызметкер дәл сол пәрмендерді орындайды:

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

Қызметкер өзінің Планфіх тіркелгісімен кіріп, қатынасты өзі растайды. Әкімшіге ЦЫМД қолданбасын қайта мақұлдаудың қажеті жоқ.

Балама: тіркелгіге тиесілі қолданбаны пайдалану

Тіркелгі басқаратын, тұрақты client_id идентификаторы бар алдын ала анықталған ОАұтһ клиенті қажет болса немесе конфигурацияңызда ЦЫМД қолданбасын пайдалану мүмкін болмаса, осы әдісті таңдаңыз.

Тіркелгі әкімшісі немесе техникалық әкімші қолданба жасайды:

Тіркелгіні басқару → АПЫ → ОАұтһ және МЦП қолданбалары бөліміне өтіңіз.
Осы тіркелгіге тиесілі қолданбалар бөлімінен Қолданба жасау пәрменін таңдаңыз.
Codex сияқты атау енгізіңіз.
Жария клиент опциясын таңдаңыз. Цодех клиент құпиясөзін қажет етпейді.
Қайта бағыттау ҰРЫ мекенжайы ретінде http://127.0.0.1/callback қосыңыз.
Қажетті ең аз рұқсаттарды таңдап, қолданбаны сақтаңыз.
Жасалған client_id идентификаторын қосылатын Қызметкерлерге беріңіз.

Планфіх іссұер жариялайды және іссұер-ге байланыстырылған авторизация жауаптарын қолдайды. Сондықтан алдын ала тіркелген, жаңадан қосылған Цодех клиенті тұрақты http://127.0.0.1/callback кері шақыру мекенжайын пайдаланады. Жүйеге кіру кезінде Цодех уақытша лоопбацк портын қосады, ал хост пен жол өзгеріссіз қалса, Планфіх осы портты қабылдайды.

Әр пайдаланушы берілген идентификатор арқылы серверді қосып, жүйеге кіреді:

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

Цодех толық кері шақыру ҰРЛ мекенжайын көрсетеді. Стандартты конфигурацияда ол мынадай болады:

OAuth callback URL: http://127.0.0.1/callback

Егер арнайы кері шақыру баптауына байланысты Цодех басқа мекенжай көрсетсе, әкімшіден қолданбаға дәл сол қайта бағыттау ҰРЫ мекенжайын қосуды сұраңыз.

--oauth-client-id параметрін беру Цодех жүйесіне алдын ала тіркелген клиентті пайдалануды және ЦЫМД мен ДЦР әдістерін өткізіп жіберуді нұсқайды. Сақталған конфигурация мынаған ұқсас болады:

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

Жүйеге кіру басталғанда, Планфіх қолданба иесі болып табылатын тіркелгіні ашады. Рұқсаттарды қарап шығып, қосылымды растаңыз.

Цодех қолданбасы және ЫДЕ кеңейтімі

Цодех қолданбасы, Цодех ЦЛЫ және ЫДЕ кеңейтімі бір компьютердегі МЦП конфигурациясын ортақ пайдаланады. ЦЛЫ бастапқы бапталғаннан кейін қолданбаны немесе кеңейтімді қайта іске қосыңыз. Сервер Баптаулар → МЦП серверлері бөлімінде көрсетіледі. Егер онда Аутентификациялау деп көрсетілсе, соны таңдап, жүйеге кіруді аяқтаңыз.

Белсенді МЦП серверлерін көру үшін Цодех цомпосер терезесіне /mcp деп енгізіңіз.

ЦЛЫ арқылы бапталған серверлер мен олардың күйін көру үшін мына пәрменді орындаңыз:

codex mcp list

Цодех жүйесінің ағымдағы басқару элементтері, пәрмендері және кері шақыру мекенжайын таңдау ережелері ОпенАЫ МЦП ресми құжаттамасында сипатталған.

Цодех жүйесіндегі бірнеше тіркелгі

Әр қосылым бір тіркелгімен және бір пайдаланушымен байланысты.

ЦЫМД қолданылғанда, қосқыңыз келетін әр тіркелгіде әкімші қолданбаны бір рет мақұлдауы керек. Әр қосылымды басқа атаумен қосып, ОАұтһ жүйесіне кіру кезінде қажетті тіркелгіні таңдаңыз. Оның орнына тіркелгіге тиесілі қолданбаларды пайдалансаңыз, әр тіркелгі үшін бөлек қолданба мен client_id қажет.

МЦП ҰРЛ мекенжайын өзгертпеңіз және сұрауларға тіркелгі атауын қоспаңыз. Сервер тіркелгіні ОАұтһ токені арқылы анықтайды.

Цодех қосылымдарындағы ақауларды жою

ЦЫМД арқылы алғаш кірген кезде әкімшінің мақұлдауы қажет болса, қосылымды тіркелгі әкімшісі немесе техникалық әкімші ретінде орнатып, Мақұлдау және қосу түймесін басыңыз. Қолданба мақұлданғаннан кейін Қызметкерлер өздері кіре алады.

ЦЫМД қолданбасын пайдалану мүмкін болмаса және Цодех жүйесі client_id сұраса, жоғарыда сипатталған тіркелгіге тиесілі қолданбаны пайдаланудың балама әдісін қолданыңыз.

Автоматты тіркеусіз басқа МЦП клиенттері

Заманауи МЦП клиенттері ЦЫМД немесе ДЦР арқылы автоматты түрде тіркеле алады. Автоматты тіркеу өздігінен тіркелгіге қатынас бермейді: тіркелгі саясаты мен әкімшінің мақұлдауы бәрібір қолданылады.

Басқа клиент алдын ала анықталған client_id сұраса, әкімшіден тіркелгіге тиесілі жария қолданба жасауды сұраңыз:

Тіркелгіні басқару → АПЫ → ОАұтһ және МЦП қолданбалары бөліміне өтіңіз.
Осы тіркелгіге тиесілі қолданбалар бөлімінде қолданба жасаңыз.
Жария клиент опциясын таңдаңыз.
МЦП клиенті көрсеткен қайта бағыттау ҰРЫ мекенжайын қосыңыз.
Қажетті ең аз рұқсаттарды таңдаңыз.
Жасалған client_id идентификаторын пайдаланушыға беріңіз немесе клиент баптауларына қосыңыз.

Қолданба тек оны жасаған тіркелгіге ғана қосыла алады. Толығырақ ақпарат Есептік жазбадағы ОАұтһ және МЦП қосымшалары бөлімінде берілген.

МЦП қосылымын ажырату

Қосылымды қайтарып алу үшін:

Планфіх жүйесінде пайдаланушы картаңызды ашыңыз.
Сеанстарды басқару бөліміне өтіңіз.
МЦП деп белгіленген қолданбаны тауып, сеансты жойыңыз.
Қажет болмаса, МЦП клиентіндегі серверді алып тастаңыз немесе өшіріңіз.

Сеансты жою оған қатысты ОАұтһ токендерін қайтарып алады. Қайта қосылу үшін жүйеге жаңадан кіріп, келісім беру қажет.

Әкімші бүкіл тіркелгі үшін қолданбаны Тіркелгіні басқару → АПЫ → ОАұтһ және МЦП қолданбалары бөлімінен өшіре алады.

Қауіпсіздік

Тек сенімді қолданбаларды қосыңыз.
Мақұлдамас бұрын қолданба атауын, иесін, қайта бағыттау ҰРЫ мекенжайын және сұралған рұқсаттарды тексеріңіз.
Қажетті ең аз рұқсаттарды беріңіз. Тек оқуға арналған сценарийде өзгерту немесе жою рұқсаттарын бермеңіз.
Қатынас токенін немесе жаңарту токенін чатқа, сұрау баптауларына немесе журналдарға ешқашан қоймаңыз.
Тапсырмалар, контактілер және пікірлер туралы деректер сыртқы АЫ қызметіне жіберілуі мүмкін екенін ескеріңіз. Бұл сол қызметтің деректерді өңдеу шарттарына сәйкес жүзеге асады.
Қосылым енді пайдаланылмаса немесе оны танымасаңыз, оны Сеанстарды басқару бөлімінен жойыңыз.

Ақауларды жою

ДЦР арқылы кіргенде әкімшінің мақұлдауы қажет болса, тіркелгі әкімшісі немесе техникалық әкімші ретінде кіріп, Рұқсат беру және қосу түймесін басыңыз. Қарапайым Қызметкер басталған ДЦР сұрауын бөлек мақұлдау үшін басқаға жібере алмайды.
ЦЫМД арқылы алғаш кіргенде әкімшінің мақұлдауы қажет болса, тіркелгі әкімшісі немесе техникалық әкімші ретінде қосылымды орнатып, Рұқсат беру және қосу түймесін басыңыз. Қолданба мақұлданғаннан кейін Қызметкерлер өздері кіре алады.

Хабар немесе белгі	Не істеу керек
Қолданбаға тіркелгі саясаты бойынша тыйым салынған	Әкімші нақты қолданбаны мақұлдауы немесе үшінші тарап қолданбаларына қатысты саясатты өзгертуі керек.
Жүйеге кіргеннен кейін клиент авторизацияны қайта сұрайды	Клиенттен қосылымды алып тастап, қайта жасаңыз. МЦП ҰРЛ мекенжайының дәл көрсетілгеніне көз жеткізіңіз.
Қате тіркелгі таңдалған	Қосылымды қайтарып алып, дұрыс тіркелгіні таңдап, қайта кіріңіз. Токенді басқа тіркелгіге ауыстыру мүмкін емес.
Әрекетті орындау мүмкін емес	Берілген ауқымдарды және пайдаланушының Планфіх жүйесіндегі қатынас құқықтарын тексеріңіз.