MCP сервери

1. Агент муну менен эмне кыла алат

Model Context Protocol кардарын чекитке багыттасаңыз, ал «бул айда кайсы бет эң көп ачуулуу чыкылдатуу жаратты?» же «Германиядан эки мүнөттөн узун үч сеансты көрсөт» деп сурай алат, анан сеансты ачкан шилтемени берет.

Курал	Жооп берет
mp_projects	бул ачкыч кайсы долбоорлорду окуй алары
mp_overview	сеанстар, адамдар, бетти көрүүлөр, узактык, нааразылык белгилери
mp_sessions	өлкө, түзмөк же узактык боюнча чыпкаланган, жаздыруу шилтемелери бар акыркы сеанстар
mp_session	бир сеанс: ирети менен беттер, окуялар, булак, түзмөк
mp_pages	көрүү саны боюнча беттер, уникалдуу коноктору менен
mp_frustration	бет боюнча топтолгон ачуулуу чыкылдатуулар, жоопсуз чыкылдатуулар жана JavaScript каталары
mp_goals	максаттарыңыз жана ар бири канча жолу аткарылганы

2. Туташтыруу

Чекит POST сурамдарын /mcp дарегинде кабыл алып, Streamable HTTP, протоколдун 2026-07-28 версиясы менен иштейт.

Ырастоо кадимки MousePlayer окуу API ачкычы менен жүргүзүлөт — Жөндөөлөр, API ачкычтары бөлүмүнөн түзүлгөн, REST API кабыл алган ошол эле түр. Экинчи кирүү маалыматы жок. Ачкычты жокко чыгаруу ошол замат агенттин кирүүсүн да токтотот.

Андан кийин долбоорду иштетиңиз

API ачкычы бүт жумуш мейкиндигиңизди ачат. Бул атайылап андай кылбайт: ар бир долбоордун интеграциялар бетинде өз которгучу бар, демейкиде өчүк. Иштетилбеген долбоор mp_projects ичинде көрүнбөйт жана агент IDсин тапса да окуй албайт.

Бул бюрократия эмес. Жайгаштыруу скриптиндеги API ачкычы сиз көзөмөлдөгөн бир жерде турат; агенттин жөндөө файлындагы ачкыч моделдин контекстине түшөт жана аны кармоо кыйла бош. Долбоорлорго бирден уруксат берүү — ылайыктуу көзөмөл.

3. Окуу үчүн гана жана эмне үчүн бул өзгөрбөйт

Жети куралдын бири да эч нерсе жазбайт. Бул чекитте өчүрүү, экспорт же жөндөө өзгөртүү жок — убакыт жетпегендиктен эмес, агент чакыра алган куралды жаңылыш да чакыра алары үчүн.

Эмнени кайтарбайт

Жаздыруулардын өзү, DOM сүрөттөрү, IP даректер жок. Агент адам интерфейсте көргөн нерсени жана калганын көрүүгө шилтемени алат.

Жыштык жана аралык чектери

REST APIдагыдай ар бир ачкычка мүнөтүнө алтымыш сурам. Убакыт аралыгы 365 күн, жыйынтык тизмеси 200 сап менен чектелет; кыскартылган жооп муну билдирет, анткени үнсүз кыскартылган тизме толук тизмедей көрүнөт.

4. Кардарды түзгөндөр үчүн

Үч ыкма: server/discover, tools/list, tools/call. Сеанстар, GET агымы, Last-Event-ID жок — булар 2025-11-25 ке чейинки протокол версияларына тиешелүү жана бул версияга кирбейт. GET же DELETE405 алат.

Ар бир POST MCP-Protocol-Version, Mcp-Method жана tools/call үчүн Mcp-Name камтыйт; ар бири денеге дал келиши керек. Дал келбөө 400 жана JSON-RPC катасы -32020 менен кайтарылат; колдоого алынбаган версия 400 жана -32022 менен, колдогон версияларыбыздын тизмесин кайтарат. Ошентип кардарыңыз бирин тандап, кайра аракет кыла алат.

Атайылап эки түрдүү ката

Туура эмес түзүлгөн сурам же белгисиз курал — JSON-RPC катасы. «Бул долбоорго уруксат жок» же «мындай сеанс жок» кадимки жыйынтык катары isError: true менен келет, анткени модель экинчи түрдөн mp_projects сурап, кайра аракет кылуу менен чыга алат; биринчисинен чыга албайт.

Жыйынтыктар structuredContent жана ошол эле маалымат текст блогуна сериалдаштырылган түрдө келет, ошондуктан эски кардарлар да пайдалуу нерсени көрөт.