Fejlesztői áttekintés - StickyPrompts Docs

A StickyPrompts REST API-jával és MCP-szerverével automatizálhatod a munkát, belső eszközöket építhetsz, és a munkaterületedet a Claude-ban, a Cursorban és más MCP-kliensekben is elérheted. Egyetlen API-kulcs mindkettőhöz elég.

Mindaz, amit a csapatod a StickyPromptsban létrehoz, a saját kódodból is elérhető: a promptok, az ügynökök, a tudásbázisok, a munkafolyamatok, valamint a csatlakoztatott CRM-ek és adatbázisok. Hívhatod őket egyszerű, JSON-alapú REST API-n keresztül, vagy csatlakoztathatsz egy MCP-klienst, és egy AI-asszisztens eszközkészletként használhatja őket. Mindkettő ugyanazon a motoron fut, mint a webes alkalmazás, így ugyanazok a modellek, védőkorlátok és hozzáférési szabályok érvényesek.

Egy kulcs, két bejárat. Mögöttük minden az, ami a munkaterületeden már megvan.

Mit építhetsz?

Automatizálás

Futtass le egy mentett promptot minden új ügyfélszolgálati jegyre, dolgozz fel egy táblázatot soronként, vagy indíts munkafolyamatot a saját ütemeződből.

Belső eszközök

Egy űrlap, egy chatbot vagy egy adminfelület mögött is elérhetővé teheted azokat a modelleket és ügynököket, amelyeket a munkaterületed már engedélyez.

StickyPrompts az AI-kliensedben

Csatlakoztasd MCP-n keresztül a Claude Code-ot, a Cursort vagy a VS Code-ot, és kérj olyasmit, hogy „a Northwind visszatérítési szabályzata” vagy „írj egy follow-up levelet ehhez az üzlethez”.

REST vagy MCP?

	REST API	MCP-szerver
Alap-URL	`https://api.stickyprompts.com/api/v1`	`https://api.stickyprompts.com/mcp/` (a záró perjelet hagyd meg)
Mire a legjobb?	A saját kódodhoz: backendek, szkriptek, ütemezett feladatok	A Model Context Protocolt használó AI-kliensekhez
Felépítés	Erőforrás-végpontok (`GET /conversation`, `POST /run`, …)	Eszközök (`send_message`, `search_knowledge_base`, `send_email`, …)
Lefedettség	A legszélesebb: promptok, ügynökök, munkafolyamatok, fájlok, projektek, csapatok és média létrehozása és kezelése	Célzott eszközkészlet olvasáshoz, futtatáshoz és műveletekhez
Hitelesítés	`Authorization: Bearer STICKY-API-...`	Ugyanaz a header és ugyanaz a kulcs

Válaszd a REST-et, ha a kódod dönti el, mi történjen. Válaszd az MCP-t, ha azt szeretnéd, hogy a modell döntse el, melyik eszközt hívja meg. Sok csapat egyetlen kulccsal mindkettőt használja: az MCP-t a szerkesztőben, a REST-et az éles feladatokban.

Néhány dolog csak az egyik oldalon érhető el. A tudásbázison belüli szemantikus keresés MCP-eszköz (search_knowledge_base), REST-es megfelelője nincs. Fájlt feltölteni viszont csak REST-en lehet: az MCP-szerver az import_storage_files eszközzel be tud hozni fájlokat a Google Drive-ról, de feltöltőeszköze nincs.

Egy kulcs mindkettőhöz

API-kulcsot te magad hozol létre a Settings > API keys oldalon. Minden kulcsnak van neve és jogosultságkészlete, a teljes kulcs pedig csak egyszer jelenik meg. Ugyanaz a kulcs hitelesíti a REST-hívásokat és az MCP-munkameneteket:

Authorization: Bearer STICKY-API-<64 characters>

A részleteket az API-kulcsok és hitelesítés oldalon találod.

A kulcs a nevedben jár el, a jogosultságai keretein belül

A kulcs nem külön szolgáltatásfiók. Annak a felhasználónak a nevében jár el, aki létrehozta: a munkaterületedet, a projektjeidet és azt látja, amit megosztottak veled, ennél többet nem. A jogosultságai ezt tovább szűkítik. Egy csak knowledge_bases_get jogosultsággal rendelkező kulcs azokat a tudásbázisokat olvashatja, amelyeket te is olvashatsz, a beszélgetéseidhez viszont nem fér hozzá.

Nincs munkaterülethez vagy projekthez kötött kulcs. A kulcs hatókörét a jogosultságai kiválasztásával szabod meg.
A munkaterület szabályai minden hívásra érvényesek: a modellhozzáférés, az adatrezidencia és a védőkorlátok pontosan úgy működnek, mint az alkalmazásban.
MCP-n keresztül az az eszköz, amelyhez a kulcsodnak nincs jogosultsága, meg sem jelenik az eszközlistában.

A teljes lista a Jogosultságok referenciája oldalon található.

A felhasználás ugyanúgy számít, mint az alkalmazásban

Az API- és MCP-hívások ugyanazon a végrehajtási, kvóta- és számlázási útvonalon futnak, mint a webes alkalmazás. A rendszer ezt a felhasználást is, mint bármely mást, a kulcs tulajdonosához és az ő munkaterületéhez rendeli, és ugyanazokból a kreditekből vonja le. Külön API-árlista nincs. Ha a munkaterület kvótája elfogyott, a fizetős munkát indító REST-hívások 429 Quota exceeded választ adnak. Lásd: Hibák, lapozás és kvóták.

Nincsenek webhookok: kérdezd le az eredményt

Az API nem küld webhookokat. A legtöbb hívás szinkron, és a kész eredményt adja vissza. A hosszan futó munkáknál (REST-en a videó, a beszéd, a zene és az átirat készítése, valamint a táblázatfeldolgozás és a munkafolyamatok futtatása) elindítod a feladatot, majd időnként lekérdezed az állapotát. A streamelő végponttal indított beszélgetést élőben követheted a hozzá tartozó WebSocketen, ahol minden keret az üzenet addigi teljes szövegét tartalmazza.