Eseptik jazbadağı OAuth jäne MCP qosımşaları

OAuth jäne MCP qosımşaları bölimi Planfix akkawntına sırtqı qosımşalardı qosw parametrlerin qamtïdı.

Aşıñız: Account management → API → OAuth and MCP applications. Bul bölim akkawnt äkimşilerine jäne texnïkalıq äkimşilerge qoljetimdi.

Ol üş bölimnen turadı:

MCP — MCP serveriniñ mekenjaýı jäne qosılwğa qısqaşa nusqawlar;
Applications owned by this account — ağımdağı akkawnt üşin arnaýı jasalğan OAuth qosımşaları;
Third-party applications — jalpı sayasat jäne akkawntta naqtı maquldanğan üşinşi tarap qosımşaları.

MCP

Bul jerde Planfix MCP URL körsetiledi:

https://mcp.planfix.com/mcp

Qoldanwşı ädette osı URL-di üýlesimdi MCP klïyentke qoswdı jäne OAuth arqılı kirwdi ayaqtawdı qajet etedi. Akkawnt atawı Planfix betinde tañdaladı jäne URL-ge kirmeýdi. Quramdastırılğan nusqawlar üşin Planfix MCP qarañız.

Applications owned by this account

Ïntegracïya tek ağımdağı akkawntqa arnalğan kezde jäne sırtqı klïyentke aldın ala anıqtalğan client_id qajet bolğanda akkawntqa tïyesili qosımşanı jasañız.

Akkawntqa tïyesili qosımşa:

basqa akkawnttarğa qosıla almaýdı;
üşinşi tarap qosımşa sayasatına qaramastan öziniñ ïyesi akkawntında qoljetimdi;
jalpı OAuth soñğı nüktelerin paýdalanadı;
tañdalğan masştabtar ayasında REST API nemese MCP-pen jumıs isteý aladı.

Qosımşa jasaw

Create application tañdañız.
Anıq ataw men sïpattama engiziñiz.
OAuth klïyent türin tañdañız.
Klïyenttiñ redirect URI-ların qosıñız.
Qajetti mïnïmaldı qol jetkizw deñgeýlerin tañdañız.
Qosımşanı saqtap, jasalğan tirkelgilerdi köşirip alıñız.

Klïyent türi	Qaşan qoldanw qajet
Public	Mobïlʹdi, desktop nemese brawzerlik qosımşa, nemese jergilikti MCP klïyenti. Qupïya söz (secret) şığarılmaýdı; avtorïzacïya ağının PKCE qorğaýdı.
Confidential	Klïyent qupïyasın senimdi türde saqtaý alatın serverlik qosımşa. Qupïyanı klïyent jağındağı kodqa, mobïlʹdi qosımşağa nemese taralımdı konfïgwracïya faýlına eşqaşan qospañız.

Confidential tïpti qosımşa jasalğannan keýin klïyent qupïyası körsetiledi. Onı senimdi qupïyalardı basqarw jüýesine saqtañız.

Redirect URI-lar jäne ruqsattar

Turaqtı veb-qosımşalar üşin https paýdalanıñız. http tek localhost nemese 127.0.0.1 sïyaqtı loopback xosttarı üşin ğana ruqsat etiledi.

Ïntegracïya üşin tek qajetti masştabtardı tañdañız. Masştabtar qosımşanıñ qoljetimdiligin şekteýdi, biraq qosımşanı qosqan qoldanwşınıñ ruqsattarın keñeýtpeýdi.

Redirect URI-lardı nemese masştabtardı özgertken kezde qosımşanıñ maquldaw nusqası özgeredi jäne burın berilgen tokender qosımşağa säýkes kelmeýdi. Paýdalanwşılarğa qaýta qosılw qajet boladı.

Qosımşanı basqarw

Qosımşa kartasınan siz:

atawın, sïpattamasın, redirect URI-ların jäne masştabtardı öñdeý alasız;
qosımşanı öşirip, qaýta qoswğa boladı;
confidential klïyenttiñ klïyent qupïyasın (secret) jañarta alasız.

Qupïyanı jañartqannan keýin burınğı klïyent qupïyası derew jumısın toqtatadı. Jaña qupïyanı köşirip alıp, ïntegracïyanıñ serverlik konfïgwracïyasın jañartıñız.

Qosımşanı öşirw avtorïzacïyanı jäne şığarılğan tokenderdi qoldanwdı bloktaýdı. Onı öşirmes burın eşqandaý bïznes-procester oğan täweldi emes ekenine köz jetkiziñiz.

Third-party applications

Üşinşi tarap qosımşalarına seriktesterge tïyesili qosımşalar, jarïyalanğan qosımşalar jäne CIMD nemese DCR arqılı tirkelgen MCP klïyentteri jatadı.

Üşinşi tarap qosımşa sayasatı

Sayasat	Nätïje
Allow published applications	Planfix jarïyalağan qosımşalar jeke maquldawsız qoljetimdi. Jeke seriktes qosımşalar jäne avtomattı türde tirkelgen MCP klïyentteri äli de äkimşi maquldawın talap etedi.
Approved applications only	Ärbir üşinşi tarap qosımşası äkimşiniñ naqtı maquldawın talap etedi.
Block third-party applications	Üşinşi tarap OAuth jäne MCP qosımşaları bloktaladı. Akkawntqa tïyesili qosımşalar jumısın jalğastıradı.

Är ïntegracïyanı jeke qarastırw qajet bolatın akkawnttar üşin Approved applications only usınıladı.

Qosımşanı maquldaw

Maquldaw suranısı eki jolmen paýda bolwı mümkin:

qoldanwşı OAuth qosılımın bastaýdı jäne Planfix maquldaw qajet ekenin xabarlaýdı;
seriktes äkimşige qosımşağa tikeleý silteme jiberedi.

Qosımşanı maquldamas burın tekseriñiz:

onıñ atawın, sïpattamasın jäne ïyesin;
onıñ redirect URI-ı nemese callback xostın;
suralğan masştabtardı;
qızmetkerlerge bul ïntegracïya qajet pe.

Äkimşi maquldawı akkawntqa qoldanıladı, biraq ärbir qoldanwşı avtomattı türde qosılmaýdı. Är qızmetker jeke öz atınan kirip, kelisim beredi. Eger äkimşi qosımşanı özi qosa jatsa, Approve and connect eki äreketti de orındaýdı.

Eger äzirlewşi üşinşi tarap qosımşasınıñ redirect URI-ların nemese masştabtarın özgertken bolsa, jaña nusqanı qaýta maquldaw qajet.

Maquldawdı qaýtarw

Akkawnt üşin qosımşanı bloktaw üşin onı maquldanğan tizimnen tawıp, ruqsattı qaýtarıñız. Bul akkawnttağı qoldanwşılarğa qatıstı OAuth tokenderin joyadı.

Sayasat Allow published applications bolğanda, naqtı maquldawdı qaýtarw jarïyalanğan qosımşanı bloktamaýdı, sebebi jalpı sayasat onı äli de ruqsat etedi. Qosımşanı bloktaw üşin Approved applications only nemese Block third-party applications tañdañız.

Jeke qoldanwşı qosılımdarı

Akkawnt maquldawı men jeke qoldanwşınıñ qosılımı — bölek baqılaw deñgeýleri.

Qızmetker öz jeke OAuth qosılımdarın körip, joya aladı:

Öz qoldanwşı kartasın aşıñız.
Session management bölimine ötiñiz.
Qosımşanı tabıñız; MCP qosılımdarı MCP dep belgilengen.
Sessïyanı öşiriñiz.

Sessïyanı joyu baýlanıstı tokenderdi alıp tastaýdı. Qol jetkizwdi qalpına keltirw üşin qoldanwşı OAuth avtorïzacïyasın qaýta orındawı qajet.

Äkimşige usınıstar

Är ïntegracïyanı jeke talqılaw qajet bolsa, Approved applications only paýdalanıñız.
Tek qana atawın emes, qosımşanıñ ïyesin jäne redirect URI-ın tekseriñiz.
Mälimetterdi özgertw men joyuğa qatısatın masştabtar üşin eñ az qajetti masştabtardı maquldañız.
Üşinşi tarap qosımşalar tizimin perïodtıq türde qarap, paýdalanılmağan qosımşalardı öşiriñiz.
Jergilikti jäne desktop klïyentter üşin public klïyent türin, serverlik ïntegracïyalar üşin confidential türin paýdalanıñız.
Eger confidential qosımşanıñ tirkelgileri buzılwı mümkin dep esepteseñiz, qupïyasın derew jañartıñız jäne qajet bolsa ïntegracïyanı qaýta qosıñız.

MCP