MCP — сыртқы ЖИ агентін Omniscol-ға қосу

Агент не істей алады

MCP агенті деректер Omniscol-да болатын анықтамалық сұрақтарда өте жақсы жұмыс істейді:

• «Осы аптада жұмыс уақытына қатысты кабинеттердің бос еместік деңгейін беріңіз.»
• «Қазан айындағы үш дүйсенбіде бірдей 2 сағаттық уақыт аралығында бос кабинет тауып беріңіз.»
• «Н. Әбенов ағымдағы оқу жылында неше сағат сабақ өткізді?»
• «Бүгінгі барлық математика сабақтарының тізімі қандай?»
• «Осы тоқсанда жұмыс сағаттарының 70 %-ынан азын орындаған мұғалімдердің тізімін шығарыңыз.»

Мұндай сұраулар әдетте бірнеше құралды кесіп өтеді: кесте, статистикалық бақылау тақталары, есептелген қолжетімділік, мұғалім карточкалары. Агент шақыруларды үйлестіріп, жауапты табиғи тілде тұжырымдайды.

Ұсынылатын құралдар

MCP сервері өз құралдарын MCP үшін рұқсат етілген Omniscol API маршруттарынан жасайды. Анық еленбейтін маршруттар және кейбір техникалық модульдер (мысалы, пайдаланушыларды аутентификациялауға қатысты) құрал болмайды. Сондықтан тізім қолданбаның ішкі бүкіл құрамын емес, MCP-ге ұсынылған API-ді көрсетеді. Дегенмен бұл — өте үлкен бөлігі. Оның үстіне MCP-ге арналған және Omniscol пайдаланбайтын бірқатар маршруттар бар. Мысалы, нысанды белгілейтін еркін мәтін («мұғалім Н. Әбенов», «6А сыныбы») Omniscol-да техникалық идентификаторымен табылуы үшін кеңейтілген іздеу құралдары бар, оны кейін деректерді дәл сұрау үшін пайдаланады. Сондай-ақ Omniscol-да графикалық интерфейс жоқ күрделі құралдар бар, өйткені олар сұраныс мәтініне (prompt) жақсырақ келеді: мысалы, нысанның бос еместігі мен қолжетімділігін іздеу («түстен кейін 2 сағатқа қатарынан 3 дүйсенбіге бос кабинет тауып беріңіз», «14 қазандағы аптада математика мұғалімі 3 сағатқа бос па?»).

Құралдар негізінен мыналарды қамтиды:

• Әкімшілік модулі (пайдаланушылар, пәндер, оқу жылдары, баптаулар),
• Кестені басқару модулі (конфигурация, алаңдар, кабинеттер, сыныптар, курстар),
• Кесте модулі (жоспар, бақылау тақталары, іздеулер),
• Қатыспауды басқару модулі (жариялау, статистика),
• жаһандық іздеу.

Оқу маршруттары агенттік қолданысқа ең қолайлы. Жазу операцияларының кейбірі токеннің құқықтарына және қолжетімді API-ге қарай каталогта болуы мүмкін, бірақ олар бақылауда болуы тиіс: бірнеше бизнес-нысанды өзгертетін сұрауды сенімді деп санамас бұрын пайдаланушы тексеруі қажет.

MCP серверін қосу

MCP сервері Premium есептік жазбаларында қолжетімді. Барлығы MCP экранынан басталады, ол Әкімшілік модулінен Баптау батырмасымен ашылады: ол сервер URL-ын көрсетеді және клиентіңіздің конфигурация элементтерін көшіруге дайын күйде береді.

MCP-дің стандартты аутентификациясы — OAuth2. Үйлесімді клиент (мысалы, Claude) жай ғана сервер URL-ына қосылады, онда есептік жазбаның OAuth2 конфигурациясын табады, ал пайдаланушы қол жеткізуді келісім экраны арқылы бекітеді: URL-дан басқа ештеңе беру қажет емес. Берілетін ауқым есептік жазбаның құқықтарына және көріну шектеулеріне сүйенеді. Omniscol OAuth2 сервері, оның клиенттерді басқару экраны және келісімнің егжей-тегжейі OAuth2 / OIDC (провайдер) бетінде сипатталған.

OAuth2-ні қолдамайтын клиент үшін сол экран токен жасайды (API кілті, жаһандық немесе модульмен шектелген ауқым, мерзімі, қосымша байланысқан пайдаланушы, белгіленетін жазу құқықтары), содан кейін жағдайға қарай қажетті пішімдерді қоюға дайын күйде ұсынады: Authorization: Bearer тақырыбы, Claude Desktop конфигурация блогы (тегін режим) және жергілікті прокси командасы. Токен Omniscol API бетінде сипатталған кілттер жүйесіне сүйенеді.

Қауіпсіздік бойынша ең жақсы тәжірибелер

• OAuth2 аутентификациясы — ыңғайлырақ және агентіңіз қолдағанда таңдалуы тиіс (Claude-тың ақылы нұсқасы).
• ЖИ-ге арналған токен — қажет болса, кері қайтарып алуға болатын түсінікті атаумен (ЖИ агенті — Claude desktop) токен жасаңыз.
• Ең аз ауқым — API токенімен тек қажетті API қол жеткізу нүктелерін таңдаңыз. OAuth токенімен рұқсат ауқымдарын (scopes) нақты қажеттілікпен шектеңіз.
• Әрекет журналдары — тиісті маршрут журналға жазылатын болса, шақыру токенмен байланысты журналдарда көрінеді. Бұл журналдар шақыруды тіркейді; қайтарылған деректердің егжей-тегжейін де, сұраудың қайта орындалатын мазмұнын да сақтамайды.
• Көріну шектеулері — агент Omniscol оған қайтарғанды ғана көреді. Токен рөлі үшін қатаң көріну шектеулерін баптаған болсаңыз, олар қолданылады.