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 жүйесіндегі қатынас құқықтарын тексеріңіз.