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 բանալին ապրում է ձեր վերահսկած մեկ տեղում. գործակալի կարգավորման ֆայլի API բանալին մտնում է մոդելի համատեքստ, որն ավելի թույլ վերահսկողություն է։ Նախագծերը մեկ առ մեկ թույլատրելը համապատասխան վերահսկողությունն է։

3. Միայն ընթերցում. ինչու դա չի փոխվելու

Յոթ գործիքներից ոչ մեկը ոչինչ չի գրում։ Այս վերջնակետի հետևում չկա ջնջում, արտահանում կամ կարգավորման փոփոխություն. ոչ թե ժամանակը չի հերիքել, այլ գործակալի կանչելիք գործիքը կարող է կանչվել նաև սխալմամբ։

Ինչ չի վերադարձնում

Ձայնագրություններն իրենք, DOM պատկերները կամ IP հասցեները։ Գործակալը ստանում է միջերեսում մարդու տեսածը և մնացածը դիտելու հղումը։

Հաճախականության և միջակայքի սահմաններ

Յուրաքանչյուր բանալիին՝ րոպեում վաթսուն հարցում, ինչպես REST API-ում։ Ժամանակային միջակայքը սահմանափակված է 365 օրով, արդյունքի ցանկը՝ 200 տողով. կրճատված պատասխանն այդ մասին ասում է, քանի որ լուռ կրճատված ցանկը ամբողջականի ճիշտ տեսքն ունի։

4. Հաճախորդը կառուցողների համար

Երեք մեթոդ՝ server/discover, tools/list, tools/call։ Չկան աշխատաշրջաններ, GET հոսք կամ Last-Event-ID . դրանք պատկանում են մինչև 2025-11-25 արձանագրության տարբերակներին և այս տարբերակի մաս չեն։ GET-ը կամ DELETE-ը ստանում են 405։

Յուրաքանչյուր POST կրում է MCP-Protocol-Version, Mcp-Method և tools/callհամար՝ Mcp-Name, և յուրաքանչյուրը պետք է համապատասխանի մարմնին։ Անհամապատասխանությունը տալիս է 400 ՝ JSON-RPC սխալով՝ -32020. չաջակցվող տարբերակը՝ 400 ՝ հետևյալով՝ -32022 և աջակցվող տարբերակների ցանկով, որպեսզի հաճախորդը կարողանա ընտրել մեկն ու կրկնել։

Միտումնավոր երկու տեսակի սխալ

Սխալ ձևավորված հարցումը կամ անհայտ գործիքը JSON-RPC սխալ է։ «Այս նախագիծը թույլատրված չէ» կամ «այդպիսի աշխատաշրջան չկա» դեպքերը վերադառնում են որպես սովորական արդյունք՝ isError: true -ով, քանի որ երկրորդ տեսակից մոդելը կարող է վերականգնվել՝ հարցնելով mp_projects և կրկին փորձելով, իսկ առաջինից՝ ոչ։

Արդյունքները կրում են և՛ structuredContent , և՛ նույն տվյալները տեքստային բլոկում շարահյուսված, որպեսզի հին հաճախորդներն էլ օգտակար բան տեսնեն։