Az MCP-szerver hozzáadása
Add hozzá a Polturát a Claude Code, Codex, Claude, ChatGPT, Cursor vagy Visual Studio Code eszközökhöz, jelentkezz be, és futtasd az első promptot.
Ezen az oldalon
A Poltura MCP-szerverével egy AI-eszköz a bejelentkezéskor kiválasztott jogosultságok keretein belül olvashatja és módosíthatja a boltjaidat. Válaszd ki az eszközödet; mindegyik a https://api.poltura.com/mcp címet használja.
Nem vagy fejlesztő? Kapcsold össze a Polturát a Claude-dal vagy ChatGPT-vel terminál nélkül →
claude mcp add --transport http poltura https://api.poltura.com/mcpEzután futtasd a /mcp parancsot a Claude Code-ban, válaszd ki a poltura elemet, majd válaszd az Authenticate lehetőséget. A böngésződben megnyílik a Poltura bejelentkezési felülete.
codex mcp add poltura --url https://api.poltura.com/mcp
codex mcp login polturaA bejelentkezés megnyitja a böngésződet. A szerver a ~/.codex/config.toml fájlba kerül.
A claude.ai felületén vagy a Claude Desktop alkalmazásban:
- Nyisd meg a Customize menüt, majd a Connectors pontot, és válaszd a + Add, utána az Add custom connector lehetőséget.
- Add meg névként a
Polturanevet, illeszd be ahttps://api.poltura.com/mcpcímet, majd válaszd az Add gombot. - Jelentkezz be, amikor megnyílik a Poltura oldala.
- Egy csevegésben válaszd a + jelet, nyisd meg a Connectors menüt, és kapcsold be a Poltura kapcsolót.
A Team és Enterprise csomagoknál először egy tulajdonosnak kell hozzáadnia az összekötőt az Organization settings, Connectors menüpont alatt. A weben hozzáadott összekötők a Claude mobilalkalmazásokban is működnek.
A chatgpt.com felületén a böngészőben:
- Nyisd meg a Plugins menüt, válaszd a + jelet, majd az Add custom MCP server lehetőséget.
- Add meg névként a
Polturanevet, illeszd be ahttps://api.poltura.com/mcpcímet a Server URL mezőbe, és válaszd az OAuth lehetőséget. - Fogadd el a figyelmeztetést, válaszd a Create as a plugin lehetőséget, majd telepítsd és jelentkezz be.
- Egy csevegésben írd be a
@karaktert, és válaszd ki a Poltura elemet.
A módosításokhoz Business, Enterprise vagy Edu workspace szükséges; a Pro csomagban az extension csak olvasni tud.
Vagy add hozzá a szervert a ~/.cursor/mcp.json (minden projekt) vagy a .cursor/mcp.json (egy projekt) fájlhoz:
{
"mcpServers": {
"poltura": { "url": "https://api.poltura.com/mcp" }
}
}Nyisd meg a Cursor Settings, majd az MCP menüt, és csatlakoztasd a poltura elemet a bejelentkezéshez.
Vagy add hozzá a szervert a .vscode/mcp.json fájlhoz:
{
"servers": {
"poltura": { "type": "http", "url": "https://api.poltura.com/mcp" }
}
}Kattints a bejegyzés feletti Start gombra. A VS Code megkérdezi, hogy a szerver bejelentkezhet-e: engedélyezd, és a böngésződben megnyílik a Poltura bejelentkezési felülete.
A poltura mcp connect minden olyan eszköz konfigurációját beírja, amelyet ezen a gépen talál, vagy a megadott eszközét. Tokent soha nem ír be. Még nincs npm-en
poltura mcp connect
poltura mcp connect cursor --global| Opció | Leírás |
|---|---|
claude, cursor, vscode, codex | A konfigurálandó eszköz. Ha nem adod meg, az összes itt talált eszközt beállítja. |
--global | Az eszköz felhasználói szintű konfigurációja az aktuális projekt helyett (VS Code esetén nem használható). |
--mode typed | Rekordtípusonként és műveletenként külön eszköz azoknak a klienseknek, amelyek maguk keresnek eszközöket. |
--store <id> | A kapcsolat rögzítése egy adott bolthoz. |
--token-env [name] | Ebből a változóból származó API token használata (alapértelmezetten POLTURA_TOKEN) a bejelentkezés helyett. |
--dry-run | Kiírja a bejegyzést anélkül, hogy bármit módosítana. |
Minden eszközhöz kiírja a következő lépést, például: Open /mcp in Claude Code and sign in to Poltura.
Szkriptek és CI esetén hagyd ki a bejelentkezést, és küldj egy API tokent bearer headerként. Az egyes kliensek tokenbeállításait az AI-eszköz csatlakoztatása oldalon találod.
Bejelentkezés és hozzáférés kiválasztása
Az első hívás megnyit egy oldalt a Poltura ID felületén, amelynek címében az eszköz neve szerepel, például: „A Cursor hozzá szeretne férni a boltjaidhoz”.
Jelentkezz be a Polturába, ha még nem tetted meg.
Ellenőrizd, ki kéri a hozzáférést. A Poltura által ismert eszközöknél, mint a Claude, Claude Code, Codex vagy VS Code, megjelenik A Poltura által ellenőrizve felirat a címükkel együtt. Minden más alkalmazás figyelmeztetést kap: csak akkor folytasd, ha te magad indítottad el.
Válaszd ki a boltokat, amelyeket az eszköz elérhet. A Hozzáférés minden bolthoz opció a később hozzáadott boltokat is magában foglalja.
Kapcsold be a jogosultságokat területenként. Minden sor a Csak láthatja, Módosíthatja, Törölhet vagy Személyes adat címkével van ellátva. Kezdj az olvasási jogosultsággal; később újra csatlakozhatsz továbbiak hozzáadásához.
Válaszd ki a lejáratot (alapértelmezetten 30 nap), majd válaszd az Engedélyezem lehetőséget. Írási jogosultság megadásakor először meg kell erősítened, hogy valóban te vagy az.
Az eszköz ezután egy rövid élettartamú tokent kap, amelyet automatikusan frissít. Soha nem tehet többet, mint amit a saját szerepköröd megenged, a törlések és a visszatérítések pedig mindig emberi jóváhagyásra várnak az AI-ügynök kérései menüben. Lásd: Hogyan járnak el az ügynökök a boltodban.
Próbáld ki az első promptot
Kérdezd meg egy új csevegésben:
Használd a Polturát. Add meg az elmúlt 7 nap értékesítéseit csatornánként,
és a legkelendőbb öt terméket.Ezután próbálj ki egy módosítást, hogy lásd, hogyan működik a jóváhagyás:
Keresd meg az 1042-es rendelést a Polturában, és készíts elő egy teljes visszatérítést.
Mielőtt bármi lefutna, mutasd meg, mi történne.A visszatérítés egy dry run eredményeként jelenik meg, a tényleges végrehajtás pedig az AI-ügynök kérései menüben várakozik, amíg jóvá nem hagyod.
Hibaelhárítás
| Hiba | Teendő |
|---|---|
| A böngésző nem nyílik meg | Claude Code: futtasd a /mcp parancsot, és válaszd újra az Authenticate lehetőséget. Codex: futtasd a codex mcp login poltura parancsot. |
| „Ez a kérés lejárt” | Indítsd újra a bejelentkezést az eszközből. |
insufficient_scope | A felhatalmazásból hiányzik egy jogosultság. Csatlakozz újra; az oldal megjelöli, melyiket kérte a hívás. |
access_disabled | Egy tulajdonos kikapcsolta az AI-ügynökök engedélyezése (MCP) beállítást a boltban, vagy a harmadik féltől származó alkalmazásokat és ügynököket a szervezetben. |
| Az eszköz több száz eszközt listáz, vagy lelassul | Használd az alapértelmezett címet. A ?mode=typed csak olyan kliensekhez való, amelyek maguk keresnek eszközöket. |
| A munkahelyi hálózat blokkolja a kapcsolatot | Kérd meg az informatikai csapatot az api.poltura.com engedélyezésére. |
Egy eszköz eltávolításához vond vissza a jogosultságát a Poltura ID Fiók, Kapcsolt alkalmazások menüpontjában, vagy az adminfelületen a Beállítások, AI-ügynökök alatt. A működése 30 másodpercen belül leáll. Az összes elutasítási kód megtalálható a Hozzáférési hibák oldalon.