ەسەپتىك جازباداعى OAuth جانە MCP قوسىمشالارى
OAuth جانە MCP قوسىمشالارى ٴبولىمى Planfix اككاۋنتىنا سىرتقى قوسىمشالاردى قوسۋ پارامەترلەرىن قامتىيدى.
اشىڭىز: Account management → API → OAuth and MCP applications. بۇل ٴبولىم اككاۋنت اكىمشىلەرىنە جانە تەحنىيكالىق اكىمشىلەرگە قولجەتىمدى.
ول ٴۇش بولىمنەن تۇرادى:
- MCP — MCP سەرۆەرىنىڭ مەكەنجايى جانە قوسىلۋعا قىسقاشا نۇسقاۋلار؛
- Applications owned by this account — اعىمداعى اككاۋنت ٴۇشىن ارنايى جاسالعان OAuth قوسىمشالارى؛
- Third-party applications — جالپى ساياسات جانە اككاۋنتتا ناقتى ماقۇلدانعان ٴۇشىنشى تاراپ قوسىمشالارى.
MCP
بۇل جەردە Planfix MCP URL كورسەتىلەدى:
https://mcp.planfix.com/mcp
قولدانۋشى ادەتتە وسى URL-ٴدى ۇيلەسىمدى MCP كلىييەنتكە قوسۋدى جانە OAuth ارقىلى كىرۋدى اياقتاۋدى قاجەت ەتەدى. اككاۋنت اتاۋى Planfix بەتىندە تاڭدالادى جانە URL-گە كىرمەيدى. قۇرامداستىرىلعان نۇسقاۋلار ٴۇشىن Planfix MCP قاراڭىز.
Applications owned by this account
ىينتەگراتسىييا تەك اعىمداعى اككاۋنتقا ارنالعان كەزدە جانە سىرتقى كلىييەنتكە الدىن الا انىقتالعان client_id قاجەت بولعاندا اككاۋنتقا تىييەسىلى قوسىمشانى جاساڭىز.
اككاۋنتقا تىييەسىلى قوسىمشا:
- باسقا اككاۋنتتارعا قوسىلا المايدى؛
- ٴۇشىنشى تاراپ قوسىمشا ساياساتىنا قاراماستان ٴوزىنىڭ ىييەسى اككاۋنتىندا قولجەتىمدى؛
- جالپى OAuth سوڭعى نۇكتەلەرىن پايدالانادى؛
- تاڭدالعان ماسشتابتار اياسىندا REST API نەمەسە MCP-پەن جۇمىس ىستەي الادى.
قوسىمشا جاساۋ
- Create application تاڭداڭىز.
- انىق اتاۋ مەن سىيپاتتاما ەنگىزىڭىز.
- OAuth كلىييەنت ٴتۇرىن تاڭداڭىز.
- كلىييەنتتىڭ redirect URI-لارىن قوسىڭىز.
- قاجەتتى مىينىيمالدى قول جەتكىزۋ دەڭگەيلەرىن تاڭداڭىز.
- قوسىمشانى ساقتاپ، جاسالعان تىركەلگىلەردى كوشىرىپ الىڭىز.
| كلىييەنت ٴتۇرى | قاشان قولدانۋ قاجەت |
|---|---|
| Public | ٴموبىيلدى، دەسكتوپ نەمەسە براۋزەرلىك قوسىمشا، نەمەسە جەرگىلىكتى MCP كلىييەنتى. قۇپىييا ٴسوز (secret) شىعارىلمايدى؛ اۆتورىيزاتسىييا اعىنىن PKCE قورعايدى. |
| Confidential | كلىييەنت قۇپىيياسىن سەنىمدى تۇردە ساقتاي الاتىن سەرۆەرلىك قوسىمشا. قۇپىييانى كلىييەنت جاعىنداعى كودقا، ٴموبىيلدى قوسىمشاعا نەمەسە تارالىمدى كونفىيگۋراتسىييا فايلىنا ەشقاشان قوسپاڭىز. |
Confidential ٴتىيپتى قوسىمشا جاسالعاننان كەيىن كلىييەنت قۇپىيياسى كورسەتىلەدى. ونى سەنىمدى قۇپىييالاردى باسقارۋ جۇيەسىنە ساقتاڭىز.
Redirect URI-لار جانە رۇقساتتار
تۇراقتى ۆەب-قوسىمشالار ٴۇشىن https پايدالانىڭىز. http تەك localhost نەمەسە 127.0.0.1 سىيياقتى loopback حوستتارى ٴۇشىن عانا رۇقسات ەتىلەدى.
ىينتەگراتسىييا ٴۇشىن تەك قاجەتتى ماسشتابتاردى تاڭداڭىز. ماسشتابتار قوسىمشانىڭ قولجەتىمدىلىگىن شەكتەيدى، بىراق قوسىمشانى قوسقان قولدانۋشىنىڭ رۇقساتتارىن كەڭەيتپەيدى.
Redirect URI-لاردى نەمەسە ماسشتابتاردى وزگەرتكەن كەزدە قوسىمشانىڭ ماقۇلداۋ نۇسقاسى وزگەرەدى جانە بۇرىن بەرىلگەن توكەندەر قوسىمشاعا سايكەس كەلمەيدى. پايدالانۋشىلارعا قايتا قوسىلۋ قاجەت بولادى.
قوسىمشانى باسقارۋ
قوسىمشا كارتاسىنان ٴسىز:
- اتاۋىن، سىيپاتتاماسىن، redirect URI-لارىن جانە ماسشتابتاردى وڭدەي الاسىز؛
- قوسىمشانى ٴوشىرىپ، قايتا قوسۋعا بولادى؛
- confidential كلىييەنتتىڭ كلىييەنت قۇپىيياسىن (secret) جاڭارتا الاسىز.
قۇپىييانى جاڭارتقاننان كەيىن بۇرىنعى كلىييەنت قۇپىيياسى دەرەۋ جۇمىسىن توقتاتادى. جاڭا قۇپىييانى كوشىرىپ الىپ، ىينتەگراتسىييانىڭ سەرۆەرلىك كونفىيگۋراتسىيياسىن جاڭارتىڭىز.
قوسىمشانى ٴوشىرۋ اۆتورىيزاتسىييانى جانە شىعارىلعان توكەندەردى قولدانۋدى بلوكتايدى. ونى وشىرمەس بۇرىن ەشقانداي بىيزنەس-پروتسەستەر وعان تاۋەلدى ەمەس ەكەنىنە كوز جەتكىزىڭىز.
Third-party applications
ٴۇشىنشى تاراپ قوسىمشالارىنا سەرىكتەستەرگە تىييەسىلى قوسىمشالار، جارىييالانعان قوسىمشالار جانە CIMD نەمەسە DCR ارقىلى تىركەلگەن MCP كلىييەنتتەرى جاتادى.
ٴۇشىنشى تاراپ قوسىمشا ٴساياساتى
| ساياسات | ناتىيجە |
|---|---|
| Allow published applications | Planfix جارىييالاعان قوسىمشالار جەكە ماقۇلداۋسىز قولجەتىمدى. جەكە سەرىكتەس قوسىمشالار جانە اۆتوماتتى تۇردە تىركەلگەن MCP كلىييەنتتەرى ٴالى دە اكىمشى ماقۇلداۋىن تالاپ ەتەدى. |
| Approved applications only | ٴاربىر ٴۇشىنشى تاراپ قوسىمشاسى اكىمشىنىڭ ناقتى ماقۇلداۋىن تالاپ ەتەدى. |
| Block third-party applications | ٴۇشىنشى تاراپ OAuth جانە MCP قوسىمشالارى بلوكتالادى. اككاۋنتقا تىييەسىلى قوسىمشالار جۇمىسىن جالعاستىرادى. |
ٴار ىينتەگراتسىييانى جەكە قاراستىرۋ قاجەت بولاتىن اككاۋنتتار ٴۇشىن Approved applications only ۇسىنىلادى.
قوسىمشانى ماقۇلداۋ
ماقۇلداۋ سۇرانىسى ەكى جولمەن پايدا بولۋى مۇمكىن:
- قولدانۋشى OAuth قوسىلىمىن باستايدى جانە Planfix ماقۇلداۋ قاجەت ەكەنىن حابارلايدى؛
- سەرىكتەس اكىمشىگە قوسىمشاعا تىكەلەي سىلتەمە جىبەرەدى.
قوسىمشانى ماقۇلداماس بۇرىن تەكسەرىڭىز:
- ونىڭ اتاۋىن، سىيپاتتاماسىن جانە ىييەسىن؛
- ونىڭ redirect URI-ى نەمەسە callback حوستىن؛
- سۇرالعان ماسشتابتاردى؛
- قىزمەتكەرلەرگە بۇل ىينتەگراتسىييا قاجەت پە.
اكىمشى ماقۇلداۋى اككاۋنتقا قولدانىلادى، بىراق ٴاربىر قولدانۋشى اۆتوماتتى تۇردە قوسىلمايدى. ٴار قىزمەتكەر جەكە ٴوز اتىنان كىرىپ، كەلىسىم بەرەدى. ەگەر اكىمشى قوسىمشانى ٴوزى قوسا جاتسا، Approve and connect ەكى ارەكەتتى دە ورىندايدى.
ەگەر ازىرلەۋشى ٴۇشىنشى تاراپ قوسىمشاسىنىڭ redirect URI-لارىن نەمەسە ماسشتابتارىن وزگەرتكەن بولسا، جاڭا نۇسقانى قايتا ماقۇلداۋ قاجەت.
ماقۇلداۋدى قايتارۋ
اككاۋنت ٴۇشىن قوسىمشانى بلوكتاۋ ٴۇشىن ونى ماقۇلدانعان تىزىمنەن تاۋىپ، رۇقساتتى قايتارىڭىز. بۇل اككاۋنتتاعى قولدانۋشىلارعا قاتىستى OAuth توكەندەرىن جويادى.
ساياسات Allow published applications بولعاندا، ناقتى ماقۇلداۋدى قايتارۋ جارىييالانعان قوسىمشانى بلوكتامايدى، سەبەبى جالپى ساياسات ونى ٴالى دە رۇقسات ەتەدى. قوسىمشانى بلوكتاۋ ٴۇشىن Approved applications only نەمەسە Block third-party applications تاڭداڭىز.
جەكە قولدانۋشى قوسىلىمدارى
اككاۋنت ماقۇلداۋى مەن جەكە قولدانۋشىنىڭ قوسىلىمى — بولەك باقىلاۋ دەڭگەيلەرى.
قىزمەتكەر ٴوز جەكە OAuth قوسىلىمدارىن كورىپ، جويا الادى:
- ٴوز قولدانۋشى كارتاسىن اشىڭىز.
- Session management بولىمىنە ٴوتىڭىز.
- قوسىمشانى تابىڭىز؛ MCP قوسىلىمدارى MCP دەپ بەلگىلەنگەن.
- سەسسىييانى ٴوشىرىڭىز.
سەسسىييانى جويۋ بايلانىستى توكەندەردى الىپ تاستايدى. قول جەتكىزۋدى قالپىنا كەلتىرۋ ٴۇشىن قولدانۋشى OAuth اۆتورىيزاتسىيياسىن قايتا ورىنداۋى قاجەت.
اكىمشىگە ۇسىنىستار
- ٴار ىينتەگراتسىييانى جەكە تالقىلاۋ قاجەت بولسا، Approved applications only پايدالانىڭىز.
- تەك قانا اتاۋىن ەمەس، قوسىمشانىڭ ىييەسىن جانە redirect URI-ىن تەكسەرىڭىز.
- مالىمەتتەردى وزگەرتۋ مەن جويۋعا قاتىساتىن ماسشتابتار ٴۇشىن ەڭ از قاجەتتى ماسشتابتاردى ماقۇلداڭىز.
- ٴۇشىنشى تاراپ قوسىمشالار ٴتىزىمىن پەرىيودتىق تۇردە قاراپ، پايدالانىلماعان قوسىمشالاردى ٴوشىرىڭىز.
- جەرگىلىكتى جانە دەسكتوپ كلىييەنتتەر ٴۇشىن public كلىييەنت ٴتۇرىن، سەرۆەرلىك ىينتەگراتسىييالار ٴۇشىن confidential ٴتۇرىن پايدالانىڭىز.
- ەگەر confidential قوسىمشانىڭ تىركەلگىلەرى بۇزىلۋى مۇمكىن دەپ ەسەپتەسەڭىز، قۇپىيياسىن دەرەۋ جاڭارتىڭىز جانە قاجەت بولسا ىينتەگراتسىييانى قايتا قوسىڭىز.