Boltparancsok
A poltura store parancsokkal rekordokat olvashatsz és műveleteket futtathatsz egy boltban terminálból, a poltura mcp connect pedig beállítja az AI-eszközöket.
Ezen az oldalon
A poltura store ugyanazokat a rekordokat és műveleteket biztosítja a terminál és a scriptek számára, mint egy AI-kliensnek, ugyanazokkal a jogosultság-ellenőrzésekkel, jóváhagyásokkal és korlátokkal. A poltura mcp connect megírja az MCP-konfigurációt egy AI-eszközhöz. Mindkettő a @poltura/cli része; a telepítésről, a poltura login parancsról és a közös flagekről a CLI-oldalon olvashatsz. Még nincs npm-en
Csatlakozás
A poltura store sorrendben a --token flaget, a POLTURA_TOKEN környezeti változót (egy API token), majd a poltura login bejelentkezésedet használja, amely még a lejárata előtt megújul. Ha terminálból dolgozol, jelentkezz be:
poltura login
poltura store infoScriptek esetén hozz létre egy tokent a parancsokhoz szükséges jogosultságokkal, és állítsd be a környezetben:
export POLTURA_TOKEN=pltu_...
poltura store info| Flag | Környezeti változó | Jelentés |
|---|---|---|
--token <token> | POLTURA_TOKEN | Az API token. Enélkül a parancs a tárolt bejelentkezést használja. |
--store <id> | POLTURA_STORE | A bolt, ha a hitelesítési adattal több is elérhető. Egyetlen boltra érvényes hitelesítési adatnál nem kell flag. |
--api <url> | POLTURA_API | Az API címe. Alapértelmezett értéke a https://api.poltura.com, vagy a legutóbbi bejelentkezésed címe. |
Minden poltura store parancs elfogadja a --json flaget a géppel olvasható kimenethez. Ha egy hívást a pontkeret visszautasít, a parancs nem próbálkozik újra helyetted; várd meg az üzenetben megadott időt, majd futtasd újra ugyanazzal az --idempotency-key értékkel. (A poltura theme parancsok várnak és újrapróbálkoznak; lásd: Kilépési kódok és újrapróbálkozások.)
Tájékozódás
| Parancs | Funkció |
|---|---|
poltura store info | A bolt, mit tehet benne a token, és mi érhető el. |
poltura store search <query> | Rekordokat keres név alapján a típusok között. A --type szűkíti, a --limit beállítja a találatok számát (1 és 50 között). |
poltura store actions [query] | Kilistázza a token által futtatható műveleteket, szavak alapján szűrve. |
poltura store describe <action> | Egy adott művelet: mit csinál, a bemenete, a flagjei és a jóváhagyási szabálya. |
poltura store analytics <pql> | Lefuttat egy analitikai queryt. |
Rekordok olvasása
Minden olyan rekordtípus, amelyet a token olvashat, paranccsá válik a bolt saját sémája alapján, így egy új rekordtípushoz nincs szükség új CLI-release-re.
poltura store product list --limit 5
poltura store order get 019bb3ef-6501-7dc3-a2e7-726e91520b7a --include payments- A
poltura store <record_type> listelfogadja a rekordtípus szűrőit flagként, vagy JSON-ként a--filter '{"status":"pending"}'flaggel, valamint a--sort,--fields,--limit(1 és 100 között, alapértelmezett: 20),--cursorés--detailedflageket. - A
poltura store <record_type> get <id>az--include,--fieldsés--detailedflageket fogadja.
Futtasd a poltura store <record_type> list --help parancsot, ha látni szeretnéd egy adott típus szűrőit és rendezési lehetőségeit.
Műveletek futtatása
poltura store run product.update --product-id 019bb58e-0ec1-79c1-9f40-d39d8d07674b --title "Linen apron"
poltura store run payment.refund --payment-id 019bb4b5-6430-7a01-8e17-6df1bfccb8e5 --amount 1200 --dry-run
poltura store run payment.refund --payment-id 019bb4b5-6430-7a01-8e17-6df1bfccb8e5 --amount 1200 --destructive --waitMűveletként az eszközreferenciában szereplő kulcsot add meg (például product.update), vagy az eszköz nevét. A művelet bemeneti mezői flagekké válnak, vagy átadhatók JSON-fájlból az --input <file> opcióval (a - a szabványos bemenetet olvassa). A poltura store describe <action> felsorolja őket.
| Flag | Jelentés |
|---|---|
--dry-run | Ellenőriz és előnézetet ad anélkül, hogy bármit módosítana. Csak a „Dry run” jelölésű műveleteknél. |
--idempotency-key <key> | Egy 8 és 200 karakter közötti kulcs. A parancs megismétlése ugyanazzal a kulccsal az első eredményt adja vissza. |
--destructive | Kötelező a visszavonhatatlan műveletekhez. Enélkül a parancs leáll, és figyelmeztet, hogy előbb ellenőrizd a --dry-run segítségével. |
--wait | Ha a művelet jóváhagyást igényel, megvárja a döntést ahelyett, hogy visszatérne. |
--input <file> | A művelet bemenete JSON-objektumként. A flagek felülbírálják. |
Ha egy művelet jóváhagyást igényel, a parancs kiírja a jóváhagyási hivatkozást, a lejárati időt és a futtatási azonosítót. A --wait nélkül ezután 3-as kóddal lép ki. Ezt a bolt adminfelületén hagyhatod jóvá az AI-ügynök kérései alatt, ahogy az Így hajtanak végre műveleteket az ügynökök a boltodban oldalon szerepel.
| Kilépési kód | Jelentés |
|---|---|
| 0 | Kész. |
| 1 | A művelet meghiúsult, elutasították vagy lejárt. |
| 2 | Helytelen használat, például hiányzó flag. |
| 3 | Jóváhagyásra vár. |
AI-eszköz csatlakoztatása
A poltura mcp connect [tool] hozzáadja a Poltura MCP-szervert az eszköz konfigurációs fájljához. Az eszköz értéke claude, cursor, vscode vagy codex lehet; név nélkül mindegyiket beállítja, amit megtalál ezen a gépen.
poltura mcp connect claude
poltura mcp connect cursor --mode typed
poltura mcp connect codex --token-env| Opció | Jelentés |
|---|---|
--mode <mode> | compact (alapértelmezett) vagy typed. Lásd: MCP-szerver. |
--store <id> | Egyetlen bolthoz rögzíti a kapcsolatot. |
--token-env [name] | Környezeti változóból (alapértelmezés szerint POLTURA_TOKEN) beolvasott API tokennel hitelesít a bejelentkezés helyett. Maga a token soha nem kerül fájlba. |
--global | A projektfájl helyett az eszköz felhasználói szintű fájljába ír. |
--name <name> | A szerver neve a fájlban. Alapértelmezett értéke poltura. |
--url <url> | Másik szervercím. |
--dry-run | Kiírja, mit írna be, és nem módosít semmit. |
A parancs által módosított fájlok:
| Eszköz | Fájl |
|---|---|
| Claude Code | .mcp.json a projektben, vagy ~/.claude.json a --global opcióval |
| Cursor | .cursor/mcp.json, vagy ~/.cursor/mcp.json a --global opcióval |
| VS Code | .vscode/mcp.json |
| Codex | ~/.codex/config.toml |
A parancs minden mást megőriz a fájlban, csak a poltura bejegyzést adja hozzá vagy frissíti, és érvénytelen fájlhoz nem nyúl. A végén kiírja a következő lépést: általában az eszköz megnyitását és a bejelentkezést a Polturába, vagy Codex esetén a codex mcp login poltura futtatását.