AI-eszköz csatlakoztatása

Ha hozzáadnád a Polturát egy eszközhöz, kövesd az MCP-szerver hozzáadása útmutatót. Ez az oldal a mögöttes részleteket mutatja be. Minden AI-kliens ugyanahhoz a címhez csatlakozik:

https://api.poltura.com/mcp

Streamable HTTP-t használ, és nem tárol munkamenetet, így minden olyan kliens használhatja, amely támogatja a távoli MCP-szervereket. Az első hívás általában a get_store_info, amely megadja a kapcsolat által elérhető boltokat.

Válassz módotHivatkozás másolása

A kapcsolatot egyetlen boltra is korlátozhatod a store_id= paraméterrel, például: ?mode=typed&store_id=0199f3a2-7c41-7d2e-9b1a-3c5e8f0a1b2c. Az MCP-szerver oldal a kompakt eszközöket, az eszközreferencia pedig a típusos eszközöket sorolja fel.

Bejelentkezés OAuth-talHivatkozás másolása

Ezt a módot válaszd, amikor egy felhasználó a saját boltjaihoz csatlakoztat egy AI-eszközt. A Claude, a ChatGPT, a Cursor, a VS Code és a Codex mind elindítja a folyamatot, amint megadod a címet. Egyetlen oldal jelenik meg a Poltura ID-ban, semmi mást nem kell beállítanod:

1. A kliens lekéri a https://api.poltura.com/.well-known/oauth-protected-resource/mcp címet, regisztrálja magát a Poltura ID-ban, és megnyitja a böngészőt a Poltura ID felületén. Ha nem vagy bejelentkezve, előbb jelentkezz be.
2. Az oldal címe „A Claude hozzá szeretne férni a boltjaidhoz”, a kliens saját nevével. Megjeleníti a kliens nevét és egy jelvényt: Ellenőrizve („A Poltura ellenőrizte az alkalmazás üzemeltetőjét”) vagy Nem ellenőrzött, valamint a visszairányítási címet. A webes Claude, a ChatGPT és a Cursor ellenőrzött, ahogyan a VS Code is, amikor a vscode.dev-en keresztül jelentkezik be. A saját gépeden futó programok – mint a Claude Code vagy a Codex – mindig nem ellenőrzöttként jelennek meg, és az oldal jelzi, hogy a kliens csak erre a számítógépre irányít vissza.
3. Boltok. Válaszd ki, mely boltokat érheti el. Ha legfeljebb három boltod van, az első csatlakozáskor ezek már be vannak jelölve. A „Hozzáférés minden bolthoz” opció a később hozzáadott boltokra is érvényes.
4. Jogosultságok. Területek szerint vannak csoportosítva, és minden sor közérthetően leírja, mit engedélyez a kliensnek, a következő címkékkel ellátva: Csak láthatja, Módosíthatja, Törölhet, illetve Személyes adatok a vásárlói adatokat érintő jogosultságoknál. A törlési sorok mellett mindig szerepel az „Előtte mindig megkérdez” felirat. A lista alatti sor rögzíti az egész kapcsolatra vonatkozó garanciát: a kliens minden törlés és visszatérítés előtt megerősítést kér tőled, és a hozzáférés lejáratáig kizárólag a kiválasztott boltokban járhat el. Elsőként az olvasási jogosultságok jelennek meg, és csak azt kapcsolod be, amit szeretnél.
5. Lejárat. 7 nap, 30 nap (az alapértelmezett), 90 nap, 1 év, egyénileg megadott dátum vagy nincs lejárat. Újracsatlakozáskor láthatod a jelenlegi jogosultságaidat és a lejáratukat.
6. Engedélyezem vagy Elutasítom. Ha a választás írási jogosultságot ad hozzá, a Poltura először a személyazonosságod megerősítését kéri jelkulccsal, hitelesítő kóddal vagy jelszóval. Ha azonos vagy kevesebb jogosultsággal csatlakozol újra, nincs szükség újabb megerősítésre.
7. A kliens egy rövid élettartamú hozzáférési tokent kap, amelyet automatikusan megújít.

A kapcsolat soha nem rendelkezhet több jogosultsággal, mint te. Egy hívás csak akkor engedélyezett, ha a jóváhagyott hozzáférés és az adott boltban betöltött saját szerepköröd is megengedi; így a csapat azon tagja, aki nem jogosult visszatérítésre, AI-ügynökön keresztül sem indíthat visszatérítést. Ha a jóváhagyás nem terjed ki a hívásra, a válasz insufficient_scope, és megjelöli a szükséges jogosultságot; a kliens ekkor újra megjeleníti az oldalt a bejelölt új jogosultsággal. Lásd a Hozzáférési hibák részt.

Ha a Poltura nem tudja csatlakoztatni a klienst, az űrlap helyett megjelenik a hiba oka: a Poltura letiltotta a klienst, a szervezeted kikapcsolta a külső alkalmazásokat és ügynököket, a fiókod nem tartozik szervezethez, vagy a kérés lejárt, és újra el kell indítanod a csatlakozást a kliensből.

A kapcsolatokat a Poltura ID Fiók, Kapcsolt alkalmazások menüpontjában kezelheted: szűkítheted a kapcsolatot, lerövidítheted a lejáratát, vagy visszavonhatod. A bolt tulajdonosa az adminfelület Beállítások, AI-ügynökök részében is látja őket az utolsó használat idejével és a legutóbbi módosításokkal, és innen is visszavonhatja a hozzáférést. A visszavont kapcsolat 30 másodpercen belül megszűnik működni.

A kapcsolatot letiltó kapcsolókHivatkozás másolása

• A Külső alkalmazások és ügynökök engedélyezése egy szervezeti kapcsoló. Ha a tulajdonos kikapcsolja, a szervezet összes OAuth-kapcsolata leáll a visszakapcsolásig.
• Az AI-ügynökök (MCP) boltonként elérhető kapcsoló, alapértelmezés szerint bekapcsolva. Ha a tulajdonos kikapcsolja, az adott bolt minden OAuth-tal bejelentkezett kapcsolatot access_disabled hibával utasít el a /mcp endpointon és az admin API-n egyaránt, beleértve az olvasást is. Az API-tokeneket és a hivatalos Poltura CLI-t ez nem érinti.

API-token használataHivatkozás másolása

Használj tokent szkriptekhez, CI-hez és olyan kliensekhez, amelyek nem tudnak böngészős bejelentkezést futtatni.

1. Hozz létre egy tokent a Poltura ID Fiók, API-tokenek menüpontjában (személyes pltu_ token), vagy a szervezeted API és hozzáférés felületén (szervezeti plto_ token).
2. Válaszd ki a boltokat, a jogosultságokat és a lejáratot, majd másold ki a titkos kulcsot. Csak egyszer jelenik meg.
3. Küldd el bearer tokenként:

curl https://api.poltura.com/v1/tokens/verify -H "Authorization: Bearer $POLTURA_TOKEN"

Egyetlen boltra korlátozott tokenhez nem szükséges store_id. A több boltot elérő tokeneknél használd a ?store_id= paramétert vagy az eszközök store_id argumentumát. A /mcp endpointon ugyanazok a jogosultság-ellenőrzések, jóváhagyások és korlátok érvényesek, mint az OAuth esetében. Az adminfelület saját session tokenjeit a /mcp nem fogadja el.

A token közvetlenül is hívhatja a bolt admin API-ját. Ott az írások, törlések és visszatérítések azonnal lefutnak, jóváhagyás és napi limitek nélkül. Csak a jogosultságai, a boltjai, a lejárata, az IP-szűrője és a pontkerete korlátozza. Az a garancia, hogy a törlés és visszatérítés előtt mindig megkérdeznek egy embert, a kapcsolt alkalmazásokra és az ügynökökre vonatkozik, az API-tokenekre és a hivatalos Poltura CLI-re nem – utóbbiak ugyanúgy a te nevedben járnak el. Lásd az Ügynökök működése a boltodban oldalt.

Token megadása a különböző kliensekbenHivatkozás másolása

A poltura mcp connect <tool> --token-env parancs automatikusan létrehozza az alábbi bejegyzést, a tokent a POLTURA_TOKEN környezeti változóból olvasva.

Hibaüzenetek és elutasításokHivatkozás másolása

A teljes lista a Hozzáférési hibák oldalon, a tool callokon belüli hibák pedig az Ügynökök működése a boltodban oldalon találhatók.