Planfix MCP

MCP (Model Context Protocol) AI كومەكشىلەرىنە جانە باسقا ۇيلەسىمدى قولدانبالارعا ستاندارتتى پروتوكول ارقىلى Planfix دەرەكتەرىمەن جۇمىس ىستەۋگە مۇمكىندىك بەرەدى.

قوسىلىم ورناتىلعاننان كەيىن كلىييەنت تەك ناقتى رۇقسات ەتىلگەن مۇمكىندىكتەردى الادى جانە جۇيەگە كىرگەن قىزمەتكەر اتىنان ارەكەت ەتەدى. Planfix جۇيەسىندەگى ستاندارتتى قاتىناس قۇقىقتارى بۇرىنعىداي قولدانىلادى: AI كومەكشىسى سول پايدالانۋشىعا قولجەتىمدى ەمەس اقپاراتتى كورە نەمەسە وزگەرتە المايدى.

قولجەتىمدى ارەكەتتەر MCP كلىييەنتىنە، بەرىلگەن رۇقساتتارعا جانە سەرۆەردىڭ اعىمداعى نۇسقاسىنا بايلانىستى. مىسالى، ٴتىيىستى رۇقساتتار بەرىلسە، كلىييەنت تاپسىرمالار مەن كونتاكتىلەردى تاۋىپ، ولاردىڭ مالىمەتتەرىن وقىي جانە پىكىر قوسا الادى.

تالاپتار

Planfix قىزمەتكەر تىركەلگىسى؛
Streamable HTTP جانە OAuth قولدايتىن MCP كلىييەنتى.

MCP سەرۆەرىنىڭ مەكەنجايى

وسى MCP سەرۆەرىنىڭ URL مەكەنجايىن پايدالانىڭىز:

https://mcp.planfix.com/mcp

URL مەكەنجايى بارلىق Planfix تىركەلگىلەرى ٴۇشىن بىردەي. وعان تىركەلگى اتاۋىن قوسپاڭىز جانە بولەك تىركەلگى تاقىرىبىن جىبەرمەڭىز. تىركەلگى OAuth اۆتورىيزاتسىيياسى كەزىندە تاڭدالادى.

كەز كەلگەن MCP كلىييەنتىن قوسۋ

كلىييەنتتەگى MCP سەرۆەرىنىڭ باپتاۋلارىن اشىڭىز.
Streamable HTTP تاسىمالداۋ ٴتۇرىن پايدالانىپ، جاڭا سەرۆەر قوسىڭىز.
Planfix سىيياقتى اتاۋ مەن MCP URL مەكەنجايىن ەنگىزىڭىز.
باپتاۋلاردى ساقتاپ، OAuth اۋتەنتىيفىيكاتسىيياسىن باستاڭىز.
اشىلعان براۋزەر تەرەزەسىندە Planfix تىركەلگىسىن تاڭداڭىز. ونى اتاۋى، URL مەكەنجايى نەمەسە ەلەكتروندىق پوشتا مەكەنجايى بويىنشا تابۋعا بولادى.
قولدانبا اتاۋى مەن سۇرالعان رۇقساتتاردى تەكسەرىپ، قوسىلىمدى راستاڭىز.

ەگەر قولدانباعا تىركەلگىدە ٴالى رۇقسات بەرىلمەسە، Planfix اكىمشىنىڭ ماقۇلداۋى قاجەت ەكەنىن كورسەتەدى. قولدانبانى تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى ماقۇلداي الادى. ەگەر قوسىلىمدى ورناتىپ جاتقان ادام اكىمشى بولسا، ول قولدانبانى ٴبىر ارەكەتپەن ماقۇلداپ، قوسا الادى.

Codex جۇيەسىندە DCR ارقىلى قوسىلعاندا، جۇيەگە كىرگەننەن كەيىن سۇراۋدى اكىمشىگە قايتا باعىتتاۋ مۇمكىن ەمەس. سوندىقتان كەلەسى بولىمنەن سايكەس ستسەنارىييدى الدىن الا تاڭداڭىز.
Codex ٴۇشىن مۇنداي ماقۇلداۋ CIMD قولدانباسى تىركەلگىگە العاش رەت قوسىلعاندا عانا قاجەت. ونى اكىمشى ورىنداۋى كەرەك. وسىدان كەيىن قىزمەتكەرلەر وزدەرى قوسا الادى.

Codex جۇيەسىن قوسۋ

قوسىلاتىن تىركەلگىنىڭ اكىمشىسى ەكەنىڭىزگە قاراي نۇسقانى تاڭداڭىز.

ۇسىنىلادى: CIMD ارقىلى قوسۋ

planfix.com سايتىندا Codex CIMD ٴادىسىن اۆتوماتتى تۇردە تاڭدايدى. اكىمشى تىركەلگىدەگى CIMD قولدانباسىن ٴبىر رەت ماقۇلدايدى، سودان كەيىن قىزمەتكەرلەر باسقا قولدانبانى ماقۇلداماي-اق OAuth ارقىلى وزدەرى كىرە الادى. بۇل ٴادىس ٴۇشىن قولدانبانى قولمەن جاساۋدىڭ، client_id ۇسىنۋدىڭ، قايتا باعىتتاۋ URI مەكەنجايىن قوسۋدىڭ نەمەسە كلىييەنت قۇپىيياسوزىن ساقتاۋدىڭ قاجەتى جوق.

العاش رەت قوسۋ ٴۇشىن تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى مىنا پارمەندەردى ورىندايدى:

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

Codex براۋزەردى اشادى. اكىمشى قۇقىقتارى بار Planfix تىركەلگىسىن تاڭداپ، سۇرالعان رۇقساتتاردى قاراپ شىعىپ، ماقۇلداۋ جانە قوسۋ تۇيمەسىن باسىڭىز. CIMD قولدانباسىن سول تىركەلگىدە ٴبىر رەت قانا ماقۇلداۋ قاجەت.

وسىدان كەيىن قاتىناس قاجەت ٴار قىزمەتكەر ٴدال سول پارمەندەردى ورىندايدى:

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

قىزمەتكەر ٴوزىنىڭ Planfix تىركەلگىسىمەن كىرىپ، قاتىناستى ٴوزى راستايدى. اكىمشىگە CIMD قولدانباسىن قايتا ماقۇلداۋدىڭ قاجەتى جوق.

بالاما: تىركەلگىگە تىييەسىلى قولدانبانى پايدالانۋ

تىركەلگى باسقاراتىن، تۇراقتى client_id ىيدەنتىيفىيكاتورى بار الدىن الا انىقتالعان OAuth كلىييەنتى قاجەت بولسا نەمەسە كونفىيگۋراتسىيياڭىزدا CIMD قولدانباسىن پايدالانۋ مۇمكىن بولماسا، وسى ٴادىستى تاڭداڭىز.

تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى قولدانبا جاسايدى:

تىركەلگىنى باسقارۋ → API → OAuth جانە MCP قولدانبالارى بولىمىنە ٴوتىڭىز.
وسى تىركەلگىگە تىييەسىلى قولدانبالار بولىمىنەن قولدانبا جاساۋ پارمەنىن تاڭداڭىز.
Codex سىيياقتى اتاۋ ەنگىزىڭىز.
جارىييا كلىييەنت وپتسىيياسىن تاڭداڭىز. Codex كلىييەنت قۇپىيياسوزىن قاجەت ەتپەيدى.
قايتا باعىتتاۋ URI مەكەنجايى رەتىندە http://127.0.0.1/callback قوسىڭىز.
قاجەتتى ەڭ از رۇقساتتاردى تاڭداپ، قولدانبانى ساقتاڭىز.
جاسالعان client_id ىيدەنتىيفىيكاتورىن قوسىلاتىن قىزمەتكەرلەرگە بەرىڭىز.

Planfix issuer جارىييالايدى جانە issuer-گە بايلانىستىرىلعان اۆتورىيزاتسىييا جاۋاپتارىن قولدايدى. سوندىقتان الدىن الا تىركەلگەن، جاڭادان قوسىلعان Codex كلىييەنتى تۇراقتى http://127.0.0.1/callback كەرى شاقىرۋ مەكەنجايىن پايدالانادى. جۇيەگە كىرۋ كەزىندە Codex ۋاقىتشا loopback پورتىن قوسادى، ال حوست پەن جول وزگەرىسسىز قالسا، Planfix وسى پورتتى قابىلدايدى.

ٴار پايدالانۋشى بەرىلگەن ىيدەنتىيفىيكاتور ارقىلى سەرۆەردى قوسىپ، جۇيەگە كىرەدى:

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

Codex تولىق كەرى شاقىرۋ URL مەكەنجايىن كورسەتەدى. ستاندارتتى كونفىيگۋراتسىييادا ول مىناداي بولادى:

OAuth callback URL: http://127.0.0.1/callback

ەگەر ارنايى كەرى شاقىرۋ باپتاۋىنا بايلانىستى Codex باسقا مەكەنجاي كورسەتسە، اكىمشىدەن قولدانباعا ٴدال سول قايتا باعىتتاۋ URI مەكەنجايىن قوسۋدى سۇراڭىز.

--oauth-client-id پارامەترىن بەرۋ Codex جۇيەسىنە الدىن الا تىركەلگەن كلىييەنتتى پايدالانۋدى جانە CIMD مەن DCR ادىستەرىن وتكىزىپ جىبەرۋدى نۇسقايدى. ساقتالعان كونفىيگۋراتسىييا مىناعان ۇقساس بولادى:

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

جۇيەگە كىرۋ باستالعاندا، Planfix قولدانبا ىييەسى بولىپ تابىلاتىن تىركەلگىنى اشادى. رۇقساتتاردى قاراپ شىعىپ، قوسىلىمدى راستاڭىز.

Codex قولدانباسى جانە IDE كەڭەيتىمى

Codex قولدانباسى، Codex CLI جانە IDE كەڭەيتىمى ٴبىر كومپيۋتەردەگى MCP كونفىيگۋراتسىيياسىن ورتاق پايدالانادى. CLI باستاپقى باپتالعاننان كەيىن قولدانبانى نەمەسە كەڭەيتىمدى قايتا ىسكە قوسىڭىز. سەرۆەر باپتاۋلار → MCP سەرۆەرلەرى بولىمىندە كورسەتىلەدى. ەگەر وندا اۋتەنتىيفىيكاتسىييالاۋ دەپ كورسەتىلسە، سونى تاڭداپ، جۇيەگە كىرۋدى اياقتاڭىز.

بەلسەندى MCP سەرۆەرلەرىن كورۋ ٴۇشىن Codex composer تەرەزەسىنە /mcp دەپ ەنگىزىڭىز.

CLI ارقىلى باپتالعان سەرۆەرلەر مەن ولاردىڭ كۇيىن كورۋ ٴۇشىن مىنا پارمەندى ورىنداڭىز:

codex mcp list

Codex جۇيەسىنىڭ اعىمداعى باسقارۋ ەلەمەنتتەرى، پارمەندەرى جانە كەرى شاقىرۋ مەكەنجايىن تاڭداۋ ەرەجەلەرى OpenAI MCP رەسمىي قۇجاتتاماسىندا سىيپاتتالعان.

Codex جۇيەسىندەگى بىرنەشە تىركەلگى

ٴار قوسىلىم ٴبىر تىركەلگىمەن جانە ٴبىر پايدالانۋشىمەن بايلانىستى.

CIMD قولدانىلعاندا، قوسقىڭىز كەلەتىن ٴار تىركەلگىدە اكىمشى قولدانبانى ٴبىر رەت ماقۇلداۋى كەرەك. ٴار قوسىلىمدى باسقا اتاۋمەن قوسىپ، OAuth جۇيەسىنە كىرۋ كەزىندە قاجەتتى تىركەلگىنى تاڭداڭىز. ونىڭ ورنىنا تىركەلگىگە تىييەسىلى قولدانبالاردى پايدالانساڭىز، ٴار تىركەلگى ٴۇشىن بولەك قولدانبا مەن client_id قاجەت.

MCP URL مەكەنجايىن وزگەرتپەڭىز جانە سۇراۋلارعا تىركەلگى اتاۋىن قوسپاڭىز. سەرۆەر تىركەلگىنى OAuth توكەنى ارقىلى انىقتايدى.

Codex قوسىلىمدارىنداعى اقاۋلاردى جويۋ

CIMD ارقىلى العاش كىرگەن كەزدە اكىمشىنىڭ ماقۇلداۋى قاجەت بولسا، قوسىلىمدى تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى رەتىندە ورناتىپ، ماقۇلداۋ جانە قوسۋ تۇيمەسىن باسىڭىز. قولدانبا ماقۇلدانعاننان كەيىن قىزمەتكەرلەر وزدەرى كىرە الادى.

CIMD قولدانباسىن پايدالانۋ مۇمكىن بولماسا جانە Codex جۇيەسى client_id سۇراسا، جوعارىدا سىيپاتتالعان تىركەلگىگە تىييەسىلى قولدانبانى پايدالانۋدىڭ بالاما ٴادىسىن قولدانىڭىز.

اۆتوماتتى تىركەۋسىز باسقا MCP كلىييەنتتەرى

زاماناۋىي MCP كلىييەنتتەرى CIMD نەمەسە DCR ارقىلى اۆتوماتتى تۇردە تىركەلە الادى. اۆتوماتتى تىركەۋ وزدىگىنەن تىركەلگىگە قاتىناس بەرمەيدى: تىركەلگى ساياساتى مەن اكىمشىنىڭ ماقۇلداۋى ٴبارىبىر قولدانىلادى.

باسقا كلىييەنت الدىن الا انىقتالعان client_id سۇراسا، اكىمشىدەن تىركەلگىگە تىييەسىلى جارىييا قولدانبا جاساۋدى سۇراڭىز:

تىركەلگىنى باسقارۋ → API → OAuth جانە MCP قولدانبالارى بولىمىنە ٴوتىڭىز.
وسى تىركەلگىگە تىييەسىلى قولدانبالار بولىمىندە قولدانبا جاساڭىز.
جارىييا كلىييەنت وپتسىيياسىن تاڭداڭىز.
MCP كلىييەنتى كورسەتكەن قايتا باعىتتاۋ URI مەكەنجايىن قوسىڭىز.
قاجەتتى ەڭ از رۇقساتتاردى تاڭداڭىز.
جاسالعان client_id ىيدەنتىيفىيكاتورىن پايدالانۋشىعا بەرىڭىز نەمەسە كلىييەنت باپتاۋلارىنا قوسىڭىز.

قولدانبا تەك ونى جاساعان تىركەلگىگە عانا قوسىلا الادى. تولىعىراق اقپارات ەسەپتىك جازباداعى OAuth جانە MCP قوسىمشالارى بولىمىندە بەرىلگەن.

MCP قوسىلىمىن اجىراتۋ

قوسىلىمدى قايتارىپ الۋ ٴۇشىن:

Planfix جۇيەسىندە پايدالانۋشى كارتاڭىزدى اشىڭىز.
سەانستاردى باسقارۋ بولىمىنە ٴوتىڭىز.
MCP دەپ بەلگىلەنگەن قولدانبانى تاۋىپ، سەانستى جويىڭىز.
قاجەت بولماسا، MCP كلىييەنتىندەگى سەرۆەردى الىپ تاستاڭىز نەمەسە ٴوشىرىڭىز.

سەانستى جويۋ وعان قاتىستى OAuth توكەندەرىن قايتارىپ الادى. قايتا قوسىلۋ ٴۇشىن جۇيەگە جاڭادان كىرىپ، كەلىسىم بەرۋ قاجەت.

اكىمشى بۇكىل تىركەلگى ٴۇشىن قولدانبانى تىركەلگىنى باسقارۋ → API → OAuth جانە MCP قولدانبالارى بولىمىنەن وشىرە الادى.

قاۋىپسىزدىك

تەك سەنىمدى قولدانبالاردى قوسىڭىز.
ماقۇلداماس بۇرىن قولدانبا اتاۋىن، ىييەسىن، قايتا باعىتتاۋ URI مەكەنجايىن جانە سۇرالعان رۇقساتتاردى تەكسەرىڭىز.
قاجەتتى ەڭ از رۇقساتتاردى بەرىڭىز. تەك وقۋعا ارنالعان ستسەنارىييدە وزگەرتۋ نەمەسە جويۋ رۇقساتتارىن بەرمەڭىز.
قاتىناس توكەنىن نەمەسە جاڭارتۋ توكەنىن تشاتقا، سۇراۋ باپتاۋلارىنا نەمەسە جۋرنالدارعا ەشقاشان قويماڭىز.
تاپسىرمالار، كونتاكتىلەر جانە پىكىرلەر تۋرالى دەرەكتەر سىرتقى AI قىزمەتىنە جىبەرىلۋى مۇمكىن ەكەنىن ەسكەرىڭىز. بۇل سول قىزمەتتىڭ دەرەكتەردى وڭدەۋ شارتتارىنا سايكەس جۇزەگە اسادى.
قوسىلىم ەندى پايدالانىلماسا نەمەسە ونى تانىماساڭىز، ونى سەانستاردى باسقارۋ بولىمىنەن جويىڭىز.

اقاۋلاردى جويۋ

DCR ارقىلى كىرگەندە اكىمشىنىڭ ماقۇلداۋى قاجەت بولسا، تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى رەتىندە كىرىپ، رۇقسات بەرۋ جانە قوسۋ تۇيمەسىن باسىڭىز. قاراپايىم قىزمەتكەر باستالعان DCR سۇراۋىن بولەك ماقۇلداۋ ٴۇشىن باسقاعا جىبەرە المايدى.
CIMD ارقىلى العاش كىرگەندە اكىمشىنىڭ ماقۇلداۋى قاجەت بولسا، تىركەلگى اكىمشىسى نەمەسە تەحنىيكالىق اكىمشى رەتىندە قوسىلىمدى ورناتىپ، رۇقسات بەرۋ جانە قوسۋ تۇيمەسىن باسىڭىز. قولدانبا ماقۇلدانعاننان كەيىن قىزمەتكەرلەر وزدەرى كىرە الادى.

حابار نەمەسە بەلگى	نە ىستەۋ كەرەك
قولدانباعا تىركەلگى ساياساتى بويىنشا تىيىم سالىنعان	اكىمشى ناقتى قولدانبانى ماقۇلداۋى نەمەسە ٴۇشىنشى تاراپ قولدانبالارىنا قاتىستى ساياساتتى وزگەرتۋى كەرەك.
جۇيەگە كىرگەننەن كەيىن كلىييەنت اۆتورىيزاتسىييانى قايتا سۇرايدى	كلىييەنتتەن قوسىلىمدى الىپ تاستاپ، قايتا جاساڭىز. MCP URL مەكەنجايىنىڭ ٴدال كورسەتىلگەنىنە كوز جەتكىزىڭىز.
قاتە تىركەلگى تاڭدالعان	قوسىلىمدى قايتارىپ الىپ، دۇرىس تىركەلگىنى تاڭداپ، قايتا كىرىڭىز. توكەندى باسقا تىركەلگىگە اۋىستىرۋ مۇمكىن ەمەس.
ارەكەتتى ورىنداۋ مۇمكىن ەمەس	بەرىلگەن اۋقىمداردى جانە پايدالانۋشىنىڭ Planfix جۇيەسىندەگى قاتىناس قۇقىقتارىن تەكسەرىڭىز.