Planfix MCP

MCP (Model Context Protocol) AI kömekşilerine jäne basqa üýlesimdi qoldanbalarğa standarttı protokol arqılı Planfix derekterimen jumıs istewge mümkindik beredi.

Qosılım ornatılğannan keýin klïyent tek naqtı ruqsat etilgen mümkindikterdi aladı jäne jüýege kirgen Qızmetker atınan äreket etedi. Planfix jüýesindegi standarttı qatınas quqıqtarı burınğıdaý qoldanıladı: AI kömekşisi sol paýdalanwşığa qoljetimdi emes aqparattı köre nemese özgerte almaýdı.

Qoljetimdi äreketter MCP klïyentine, berilgen ruqsattarğa jäne serverdiñ ağımdağı nusqasına baýlanıstı. Mısalı, tïisti ruqsattar berilse, klïyent tapsırmalar men kontaktilerdi tawıp, olardıñ mälimetterin oqï jäne pikir qosa aladı.

Talaptar

Planfix Qızmetker tirkelgisi;
Streamable HTTP jäne OAuth qoldaýtın MCP klïyenti.

MCP serveriniñ mekenjaýı

Osı MCP serveriniñ URL mekenjaýın paýdalanıñız:

https://mcp.planfix.com/mcp

URL mekenjaýı barlıq Planfix tirkelgileri üşin birdeý. Oğan tirkelgi atawın qospañız jäne bölek tirkelgi taqırıbın jibermeñiz. Tirkelgi OAuth avtorïzacïyası kezinde tañdaladı.

Kez kelgen MCP klïyentin qosw

Klïyenttegi MCP serveriniñ baptawların aşıñız.
Streamable HTTP tasımaldaw türin paýdalanıp, jaña server qosıñız.
Planfix sïyaqtı ataw men MCP URL mekenjaýın engiziñiz.
Baptawlardı saqtap, OAuth awtentïfïkacïyasın bastañız.
Aşılğan brawzer terezesinde Planfix tirkelgisin tañdañız. Onı atawı, URL mekenjaýı nemese élektrondıq poşta mekenjaýı boýınşa tabwğa boladı.
Qoldanba atawı men suralğan ruqsattardı tekserip, qosılımdı rastañız.

Eger qoldanbağa tirkelgide äli ruqsat berilmese, Planfix äkimşiniñ maquldawı qajet ekenin körsetedi. Qoldanbanı tirkelgi äkimşisi nemese texnïkalıq äkimşi maquldaý aladı. Eger qosılımdı ornatıp jatqan adam äkimşi bolsa, ol qoldanbanı bir äreketpen maquldap, qosa aladı.

Codex jüýesinde DCR arqılı qosılğanda, jüýege kirgennen keýin surawdı äkimşige qaýta bağıttaw mümkin emes. Sondıqtan kelesi bölimnen säýkes scenarïýdi aldın ala tañdañız.
Codex üşin mundaý maquldaw CIMD qoldanbası tirkelgige alğaş ret qosılğanda ğana qajet. Onı äkimşi orındawı kerek. Osıdan keýin Qızmetkerler özderi qosa aladı.

Codex jüýesin qosw

Qosılatın tirkelginiñ äkimşisi ekeniñizge qaraý nusqanı tañdañız.

Usınıladı: CIMD arqılı qosw

planfix.com saýtında Codex CIMD ädisin avtomattı türde tañdaýdı. Äkimşi tirkelgidegi CIMD qoldanbasın bir ret maquldaýdı, sodan keýin Qızmetkerler basqa qoldanbanı maquldamaý-aq OAuth arqılı özderi kire aladı. Bul ädis üşin qoldanbanı qolmen jasawdıñ, client_id usınwdıñ, qaýta bağıttaw URI mekenjaýın qoswdıñ nemese klïyent qupïyasözin saqtawdıñ qajeti joq.

Alğaş ret qosw üşin tirkelgi äkimşisi nemese texnïkalıq äkimşi mına pärmenderdi orındaýdı:

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

Codex brawzerdi aşadı. Äkimşi quqıqtarı bar Planfix tirkelgisin tañdap, suralğan ruqsattardı qarap şığıp, Maquldaw jäne qosw tüýmesin basıñız. CIMD qoldanbasın sol tirkelgide bir ret qana maquldaw qajet.

Osıdan keýin qatınas qajet är Qızmetker däl sol pärmenderdi orındaýdı:

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

Qızmetker öziniñ Planfix tirkelgisimen kirip, qatınastı özi rastaýdı. Äkimşige CIMD qoldanbasın qaýta maquldawdıñ qajeti joq.

Balama: tirkelgige tïyesili qoldanbanı paýdalanw

Tirkelgi basqaratın, turaqtı client_id ïdentïfïkatorı bar aldın ala anıqtalğan OAuth klïyenti qajet bolsa nemese konfïgwracïyañızda CIMD qoldanbasın paýdalanw mümkin bolmasa, osı ädisti tañdañız.

Tirkelgi äkimşisi nemese texnïkalıq äkimşi qoldanba jasaýdı:

Tirkelgini basqarw → API → OAuth jäne MCP qoldanbaları bölimine ötiñiz.
Osı tirkelgige tïyesili qoldanbalar böliminen Qoldanba jasaw pärmenin tañdañız.
Codex sïyaqtı ataw engiziñiz.
Jarïya klïyent opcïyasın tañdañız. Codex klïyent qupïyasözin qajet etpeýdi.
Qaýta bağıttaw URI mekenjaýı retinde http://127.0.0.1/callback qosıñız.
Qajetti eñ az ruqsattardı tañdap, qoldanbanı saqtañız.
Jasalğan client_id ïdentïfïkatorın qosılatın Qızmetkerlerge beriñiz.

Planfix issuer jarïyalaýdı jäne issuer-ge baýlanıstırılğan avtorïzacïya jawaptarın qoldaýdı. Sondıqtan aldın ala tirkelgen, jañadan qosılğan Codex klïyenti turaqtı http://127.0.0.1/callback keri şaqırw mekenjaýın paýdalanadı. Jüýege kirw kezinde Codex waqıtşa loopback portın qosadı, al xost pen jol özgerissiz qalsa, Planfix osı porttı qabıldaýdı.

Är paýdalanwşı berilgen ïdentïfïkator arqılı serverdi qosıp, jüýege kiredi:

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

Codex tolıq keri şaqırw URL mekenjaýın körsetedi. Standarttı konfïgwracïyada ol mınadaý boladı:

OAuth callback URL: http://127.0.0.1/callback

Eger arnaýı keri şaqırw baptawına baýlanıstı Codex basqa mekenjaý körsetse, äkimşiden qoldanbağa däl sol qaýta bağıttaw URI mekenjaýın qoswdı surañız.

--oauth-client-id parametrin berw Codex jüýesine aldın ala tirkelgen klïyentti paýdalanwdı jäne CIMD men DCR ädisterin ötkizip jiberwdi nusqaýdı. Saqtalğan konfïgwracïya mınağan uqsas boladı:

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

Jüýege kirw bastalğanda, Planfix qoldanba ïyesi bolıp tabılatın tirkelgini aşadı. Ruqsattardı qarap şığıp, qosılımdı rastañız.

Codex qoldanbası jäne IDE keñeýtimi

Codex qoldanbası, Codex CLI jäne IDE keñeýtimi bir kompʹyuterdegi MCP konfïgwracïyasın ortaq paýdalanadı. CLI bastapqı baptalğannan keýin qoldanbanı nemese keñeýtimdi qaýta iske qosıñız. Server Baptawlar → MCP serverleri böliminde körsetiledi. Eger onda Awtentïfïkacïyalaw dep körsetilse, sonı tañdap, jüýege kirwdi ayaqtañız.

Belsendi MCP serverlerin körw üşin Codex composer terezesine /mcp dep engiziñiz.

CLI arqılı baptalğan serverler men olardıñ küýin körw üşin mına pärmendi orındañız:

codex mcp list

Codex jüýesiniñ ağımdağı basqarw élementteri, pärmenderi jäne keri şaqırw mekenjaýın tañdaw erejeleri OpenAI MCP resmï qujattamasında sïpattalğan.

Codex jüýesindegi birneşe tirkelgi

Är qosılım bir tirkelgimen jäne bir paýdalanwşımen baýlanıstı.

CIMD qoldanılğanda, qosqıñız keletin är tirkelgide äkimşi qoldanbanı bir ret maquldawı kerek. Är qosılımdı basqa atawmen qosıp, OAuth jüýesine kirw kezinde qajetti tirkelgini tañdañız. Onıñ ornına tirkelgige tïyesili qoldanbalardı paýdalansañız, är tirkelgi üşin bölek qoldanba men client_id qajet.

MCP URL mekenjaýın özgertpeñiz jäne surawlarğa tirkelgi atawın qospañız. Server tirkelgini OAuth tokeni arqılı anıqtaýdı.

Codex qosılımdarındağı aqawlardı joyu

CIMD arqılı alğaş kirgen kezde äkimşiniñ maquldawı qajet bolsa, qosılımdı tirkelgi äkimşisi nemese texnïkalıq äkimşi retinde ornatıp, Maquldaw jäne qosw tüýmesin basıñız. Qoldanba maquldanğannan keýin Qızmetkerler özderi kire aladı.

CIMD qoldanbasın paýdalanw mümkin bolmasa jäne Codex jüýesi client_id surasa, joğarıda sïpattalğan tirkelgige tïyesili qoldanbanı paýdalanwdıñ balama ädisin qoldanıñız.

Avtomattı tirkewsiz basqa MCP klïyentteri

Zamanawï MCP klïyentteri CIMD nemese DCR arqılı avtomattı türde tirkele aladı. Avtomattı tirkew özdiginen tirkelgige qatınas bermeýdi: tirkelgi sayasatı men äkimşiniñ maquldawı bäribir qoldanıladı.

Basqa klïyent aldın ala anıqtalğan client_id surasa, äkimşiden tirkelgige tïyesili jarïya qoldanba jasawdı surañız:

Tirkelgini basqarw → API → OAuth jäne MCP qoldanbaları bölimine ötiñiz.
Osı tirkelgige tïyesili qoldanbalar böliminde qoldanba jasañız.
Jarïya klïyent opcïyasın tañdañız.
MCP klïyenti körsetken qaýta bağıttaw URI mekenjaýın qosıñız.
Qajetti eñ az ruqsattardı tañdañız.
Jasalğan client_id ïdentïfïkatorın paýdalanwşığa beriñiz nemese klïyent baptawlarına qosıñız.

Qoldanba tek onı jasağan tirkelgige ğana qosıla aladı. Tolığıraq aqparat Eseptik jazbadağı OAuth jäne MCP qosımşaları böliminde berilgen.

MCP qosılımın ajıratw

Qosılımdı qaýtarıp alw üşin:

Planfix jüýesinde paýdalanwşı kartañızdı aşıñız.
Seanstardı basqarw bölimine ötiñiz.
MCP dep belgilengen qoldanbanı tawıp, seanstı joýıñız.
Qajet bolmasa, MCP klïyentindegi serverdi alıp tastañız nemese öşiriñiz.

Seanstı joyu oğan qatıstı OAuth tokenderin qaýtarıp aladı. Qaýta qosılw üşin jüýege jañadan kirip, kelisim berw qajet.

Äkimşi bükil tirkelgi üşin qoldanbanı Tirkelgini basqarw → API → OAuth jäne MCP qoldanbaları böliminen öşire aladı.

Qawipsizdik

Tek senimdi qoldanbalardı qosıñız.
Maquldamas burın qoldanba atawın, ïyesin, qaýta bağıttaw URI mekenjaýın jäne suralğan ruqsattardı tekseriñiz.
Qajetti eñ az ruqsattardı beriñiz. Tek oqwğa arnalğan scenarïýde özgertw nemese joyu ruqsattarın bermeñiz.
Qatınas tokenin nemese jañartw tokenin çatqa, suraw baptawlarına nemese jwrnaldarğa eşqaşan qoýmañız.
Tapsırmalar, kontaktiler jäne pikirler twralı derekter sırtqı AI qızmetine jiberilwi mümkin ekenin eskeriñiz. Bul sol qızmettiñ derekterdi öñdew şarttarına säýkes jüzege asadı.
Qosılım endi paýdalanılmasa nemese onı tanımasañız, onı Seanstardı basqarw böliminen joýıñız.

Aqawlardı joyu

DCR arqılı kirgende äkimşiniñ maquldawı qajet bolsa, tirkelgi äkimşisi nemese texnïkalıq äkimşi retinde kirip, Ruqsat berw jäne qosw tüýmesin basıñız. Qarapaýım Qızmetker bastalğan DCR surawın bölek maquldaw üşin basqağa jibere almaýdı.
CIMD arqılı alğaş kirgende äkimşiniñ maquldawı qajet bolsa, tirkelgi äkimşisi nemese texnïkalıq äkimşi retinde qosılımdı ornatıp, Ruqsat berw jäne qosw tüýmesin basıñız. Qoldanba maquldanğannan keýin Qızmetkerler özderi kire aladı.

Xabar nemese belgi	Ne istew kerek
Qoldanbağa tirkelgi sayasatı boýınşa tıýım salınğan	Äkimşi naqtı qoldanbanı maquldawı nemese üşinşi tarap qoldanbalarına qatıstı sayasattı özgertwi kerek.
Jüýege kirgennen keýin klïyent avtorïzacïyanı qaýta suraýdı	Klïyentten qosılımdı alıp tastap, qaýta jasañız. MCP URL mekenjaýınıñ däl körsetilgenine köz jetkiziñiz.
Qate tirkelgi tañdalğan	Qosılımdı qaýtarıp alıp, durıs tirkelgini tañdap, qaýta kiriñiz. Tokendi basqa tirkelgige awıstırw mümkin emes.
Äreketti orındaw mümkin emes	Berilgen awqımdardı jäne paýdalanwşınıñ Planfix jüýesindegi qatınas quqıqtarın tekseriñiz.