Build AI-jal
Csatlakoztass egy AI-eszközt a bolthoz MCP-n keresztül, és add át az AI-eszközödnek a Poltura-dokumentációt Markdownként, egy szabályfájlt és kész promptokat.
Ezen az oldalon
A dokumentáció minden oldala úgy készült, hogy az emberek és a velük dolgozó AI-eszközök egyaránt olvashassák. A dokumentáció olvasásához nincs szükség fiókra vagy kulcsra. Egy eszköz bolthoz csatlakoztatásához be kell jelentkezned a Polturába.
Az MCP-szerver hozzáadása
Add hozzá a Polturát a Claude-hoz, a ChatGPT-hez, a Cursorhoz, a VS Code-hoz vagy a Codexhez, és futtasd le az első promptot.
AI-szabályok
AGENTS.md és egy Cursor-szabály a Poltura-kód konvencióival.
Kérdezz egy oldalról
Minden oldal címe alatt van egy Copy page gomb. A menüjéből közvetlenül megnyithatod az oldalt a ChatGPT-ben, a Claude-ban vagy a Cursorban egy olyan prompttal, amely az oldal Markdown-címére mutat, így a válasz az aktuális szövegen alapul, nem pedig azon, amire a modell emlékszik.
Markdown minden oldalhoz
| Ezt szeretnéd | Ezt kérd le |
|---|---|
| Egyetlen oldal Markdownként | Add hozzá a .md kiterjesztést a címéhez: /apps/manifest.md |
| Ugyanez olyan eszközből, ami headereket küld | Accept: text/markdown a normál címen |
| Az összes oldal manifestje, soronként egy oldal | /llms.txt |
| A teljes webhely egyetlen fájlban | /llms-full.txt |
Minden HTML-oldal egy <link rel="alternate" type="text/markdown"> tagben is megadja a Markdown-párját.
curl -H "Accept: text/markdown" -L https://developers.poltura.com/apps/manifestSzabályfájlok
Az AI-szabályok oldal tartalmazza azokat a konvenciókat, amelyekre egy ügynöknek szüksége van a Poltura-kód írása előtt: mely csomagok nyilvánosak, hogyan épülnek fel a workerek és a szekciók, és hogyan kell kezelni a tokeneket és a pénzt. Ugyanez a szöveg két fájlként is elérhető:
curl -o AGENTS.md https://developers.poltura.com/ai/rules/AGENTS.md
mkdir -p .cursor/rules
curl -o .cursor/rules/poltura.mdc https://developers.poltura.com/ai/rules/poltura.mdc- Codex, Cursor és más olyan eszközök, amelyek olvassák az
AGENTS.mdfájlt: helyezd azAGENTS.mdfájlt a projekt gyökerébe. - Cursor-projektszabályok: a
.cursor/rules/poltura.mdcaz app és a téma forrásfájljaira vonatkozik. - A Claude Code a
CLAUDE.mdfájlt olvassa: add hozzá a@AGENTS.mdsort, vagy mentsd el a fájltCLAUDE.mdnéven.
Promptok
Az útmutatók egy olyan prompttal indulnak, amelyet átmásolhatsz az eszközödbe, vagy közvetlenül megnyithatsz benne. Mindegyik prompt megadja az útmutató Markdown-címét és a szabályfájlt, így az eszköz ugyanazokat a lépéseket követi, mint te:
MCP
A Poltura MCP-szerverével egy AI-kliens adatokat kereshet és módosításokat végezhet a boltban, a kereskedő által megadott jogosultságokon belül. Egy csatlakoztatott AI-eszköznél minden olyan művelet, amely pénzbe kerül vagy nem vonható vissza, emberi jóváhagyásra vár.
- MCP-szerver: mit kínál, és a két mód.
- Az MCP-szerver hozzáadása: egykattintásos hozzáadás, kliensenként egy parancs, bejelentkezés és az első prompt.
- AI-eszköz csatlakoztatása: a két mód, az OAuth részletesen és az API tokenek.
- Hogyan hajtanak végre műveleteket az ügynökök a boltodban: olvasás és írás, jóváhagyás, idempotencia, dry run, hibák és korlátok.
- Eszközreferencia: az összes toolset, rekordtípus és művelet.
- API tokenek: scriptek és CI, és hogy miben különbözik egy token a csatlakoztatott ügynöktől.
- Boltparancsok: ugyanezek a műveletek terminálból.