Az MCP áttekintése

A Model Context Protocol (MCP) egy nyílt szabvány, amellyel egy AI-kliens eszközöket hívhat meg egy távoli szerveren. A StickyPrompts MCP-szervere eszközökként teszi elérhetővé a munkaterületedet: kereshetsz egy tudásbázisban, futtathatsz egy mentett promptot, megkereshetsz egy CRM-kontaktot, lekérdezhetsz egy csatlakoztatott adatbázist, küldhetsz e-mailt vagy generálhatsz egy képet. Elég egyszer csatlakoztatnod, és az asszisztensed valódi munkát végezhet ugyanazokkal a modellekkel, adatokkal és szabályokkal, amelyeket a csapatod az alkalmazásban használ.

Oktatóvideó 13/14 · 1:54 Az MCP-szerver: StickyPrompts az AI-eszközeidben Magyar narrációval, az élő alkalmazásban rögzítve

Röviden

Végpont	https://api.stickyprompts.com/mcp/
Átviteli mód	Csak Streamable HTTP. Nincs régi típusú /sse végpont és stdio-szerver sem.
Hitelesítés	Authorization: Bearer STICKY-API-... - ugyanaz az API-kulcs, mint a REST API-hoz
Képességek	Csak eszközök. Nincsenek MCP-erőforrások, erőforrássablonok és promptok.
A szerver neve	StickyPrompts, verzió: 1.0.0 (az initialize válaszában)

Használd a záró perjelet

A végpont címe /mcp/, záró perjellel. A /mcp címre küldött kérést a szerver átirányítja a /mcp/ címre (GET esetén 301, POST és DELETE esetén 307 kóddal). A legtöbb kliens követi az átirányítást, de érdemes közvetlenül a https://api.stickyprompts.com/mcp/ címet beállítani: így megspórolsz egy felesleges oda-vissza kört, és azokkal a kliensekkel is működik, amelyek nem követik az átirányítást.

Hitelesítés

Az API-kulcsodat az Authorization headerben küldd, pontosan úgy, mint a REST API-nál. Kulcsot a Settings > API keys oldalon hozhatsz létre; részletek: API-kulcsok és hitelesítés.

Helyzet	HTTP-válasz
Nincs Authorization header, vagy a token nem Bearer STICKY-API-... formájú	401 {"error":"unauthorized"}
Ismeretlen kulcs, hibás titok, vagy a kulcs tulajdonosa már nem létezik	401 {"error":"Invalid API key"}
A kulcs tulajdonosának fiókja nem aktív	403 {"error":"user is not verified"}
A kérés olyan régióból érkezik, amelyet a szolgáltatás nem szolgál ki	403 {"error":"access from your region is not supported"}

A csatlakozáshoz nem kell semmilyen külön jogosultság. Bármely aktív fiókhoz tartozó érvényes kulcs nyithat munkamenetet - hogy utána mit tehet, azt eszközönként a jogosultságok döntik el.

A kulcs annak a felhasználónak a nevében jár el, aki létrehozta: ugyanaz a munkaterület, ugyanazok a projektek, ugyanazok a megosztott erőforrások, a kulcs jogosultságaival szűkítve. Minden, amit MCP-n keresztül hozol létre (beszélgetések, projektek, generált fájlok), a tiéd, és megjelenik az alkalmazásban.

Munkamenetek

A szerver szabványos Streamable HTTP-munkameneteket használ. Az MCP-kliensek mindezt automatikusan kezelik; csak akkor számít, ha kézzel kommunikálsz a protokollon.

• Az initialize kérést tartalmazó POST /mcp/ a válasz Mcp-Session-Id headerében adja vissza a munkamenet-azonosítót (formátuma: mcp-session-<uuid>).
• Minden további POST kérésnek el kell küldenie ezt az Mcp-Session-Id headert. Hiányzó vagy hibás formátumú azonosító esetén a válasz 404 Invalid session ID.
• A munkamenetek a szerveren állapotmentesek: a szerver csak az azonosító formátumát ellenőrzi. A munkamenetek túlélik a szerver újraindítását, így egy új verzió telepítése után sem kell újracsatlakoznod.
• A POST kérésekhez Content-Type: application/json kell. A válaszok a gyakorlatban JSON-formátumúak, mert egyik eszköz sem küld folyamatjelző értesítést.
• A GET /mcp/ egy opcionális értesítési streamet nyit, amely többnyire tétlen. A DELETE /mcp/ kérést a szerver elfogadja, de nem csinál vele semmit.

A jogosultságok döntik el, mely eszközöket látod

Minden eszközhöz pontosan egy jogosultság kell. A szerver a tools/list és a tools/call kéréseket is a kulcs jogosultságai alapján szűri:

• A kulcs csak azokat az eszközöket látja, amelyekhez megvan a jogosultsága. Az a kulcs, amelynek nincs az MCP szempontjából releváns jogosultsága, sikeresen csatlakozik, de üres eszközlistát lát.
• Ha olyan eszközt hívsz meg, amelyet a kulcs nem használhat, -32602 kódú JSON-RPC-hibát kapsz tool '<name>' not found üzenettel - pontosan ugyanazt, mint egy nem létező eszköz hívásakor.

Ha tehát a kliensed szerint hiányzik egy StickyPrompts-eszköz, először a kulcs jogosultságait ellenőrizd. A Jogosultságok referenciája oldalon az MCP jelvénnyel jelölt jogosultságok adnak hozzáférést eszközökhöz, az Eszközreferencia pedig minden eszköznél megnevezi a szükséges jogosultságot.

A legkisebb jogosultság elve itt a szokásosnál is fontosabb: egy AI-kliens minden eszközt használni fog, amelyet lát. Az asszisztensnek szánt kulcs csak olyan eszközöket kapjon, amelyek hívását nyugodtan rábízod, az író eszközöket (például a send_email vagy a run_database_query eszközt) pedig hagyd kikapcsolva, hacsak nincs rájuk szükséged.

Eredmények és hibák

Minden eszköz egyetlen szöveges tartalomelemet ad vissza, amelynek a szövege egy JSON-dokumentum. A szöveget JSON-ként dolgozd fel. Nincs structuredContent és nincs kimeneti séma; az egyes eredmények szerkezetét az Eszközreferencia írja le.

{
  "content": [
    { "type": "text", "text": "{\"conversation_id\": 5120, \"text\": \"Here are three options ...\"}" }
  ]
}

A hibák kétféleképpen érkezhetnek:

Típus	Így néz ki	Mikor fordul elő
Eszközhiba	Egy eredmény isError: true értékkel és egyszerű szöveges üzenettel, például conversation not found	Sok „nem található vagy nincs hozzáférés” jellegű lekérdezésnél
-32603 kódú JSON-RPC-hiba	Sikertelen hívás a szerver üzenetével, például required argument "prompt" not found	Hiányzó kötelező argumentumok, a legtöbb validációs hiba, szolgáltatói és integrációs hibák

A bemeneti sémákat a szerver közli a klienseddel, de maga nem validálja őket, így egy rossz típusú argumentum nem sémahibaként, hanem a fenti hibák egyikeként jelenik meg.

Hosszan futó eszközök

A legtöbb eszköz szinkron: akkor tér vissza, amikor a munka elkészült. Néhány azonnal visszatér, és az állapotát ismételt lekérdezéssel (pollinggal) kell figyelni.

Indítás	Visszatérési érték	Lekérdezés	Kész, ha
generate_video	{"id", "status"}	get_video_generation_status	a status értéke done vagy error
start_spreadsheet_processing	{"task_id"}	get_spreadsheet_processing_task	a status értéke done vagy error
run_workflow_task	{"execution_id", "status"}	MCP-n nincs állapotlekérdező eszköz	Utólag a get_workflow_task eszközzel nézd meg a total_run_count és a success_rate értékét

A videókészítés több percig is eltarthat; az eszköz saját leírása arra kéri a modellt, hogy két lekérdezés között 15-60 másodpercet várjon. A generate_speech, a generate_music és a transcribe szinkron eszköz - addig blokkol, amíg el nem készül a hanganyag vagy az átirat. Ezekhez, valamint a lassú modellel használt send_message eszközhöz állíts be bőséges kérési időkorlátot a kliensedben.

Kreditek és hozzáférési szabályok

• A valódi munkát végző eszközök (send_message, run_prompt, custom_run, a médiaeszközök, search_knowledge_base, a táblázatfeldolgozás és a munkafolyamat-futtatások) felhasználása a kulcs tulajdonosának fiókján számolódik, ugyanúgy, mintha ugyanezt az alkalmazásban tenné.
• A run_workflow_task eszközzel indított munkafolyamat quota exceeded hibával meghiúsul, ha a tulajdonos kvótája elfogyott.
• A modellhozzáférési szabályok és az adatrezidencia-szűrők a modell kiválasztásakor érvényesülnek. Ha a munkaterületed nem engedélyez egy modellt, a hívás sikertelen lesz. A list_ai_models eleve kihagyja azokat a modelleket, amelyeket nem használhatsz.

Modell kiválasztása

A run_prompt, a custom_run és a start_spreadsheet_processing eszköznek egy ai_model_id kell a list_ai_models eredményéből. "auto" érték nincs. A send_message opcionálisan fogad ai_model_id értéket, de új beszélgetés indításakor mindig add meg: enélkül a hívás jelenleg no AI model is selected, try reselecting model hibával meghiúsul. A médiaeszközök nem fogadnak modellargumentumot.

Amire az MCP-szerver nem képes

• Nincs fájlfeltöltés. Fájlokat a Google Drive-ról hozhatsz be az import_storage_files eszközzel, vagy a REST API-n keresztül töltheted fel őket.
• Tetszőleges fájlokhoz nincs letöltési link. A list_files és a get_file csak az azonosítót, a nevet és a típust adja vissza. A médiaeredményekben van egy path érték, amely a tárolt fájlra mutat.
• Nincsenek MCP-erőforrások és -promptok. A mentett promptjaidat a list_prompts, a get_prompt és a run_prompt eszközzel éred el.
• Nincs OAuth. Azok a kliensek, amelyek távoli szervert csak OAuth-bejelentkezéssel tudnak hozzáadni, API-kulccsal nem tudnak csatlakozni.