> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Macaly Cloud MCP Server
> Claude, ChatGPT, Cursor, Grok Bot vagy Codex írja a kódot, a Macaly futtatja, buildeli és hosztolja
A Macaly Cloud egy [MCP](https://modelcontextprotocol.io)-szerver, amely a Macalyt a saját AI-kódolóügynököd infrastruktúrájává teszi. Az ügynököd írja a kód minden sorát; a Macaly adja a git-repót, a felhős sandboxot, az adatbázist és a platformképességeket, a buildet, a megosztható előnézetet és az éles hosztolást a `macaly.app` címen.
Semmi sem készül a te gépeden, és a Macaly saját ügynöke sem fut le. Az alkalmazás az első fájltól a Macaly-munkaterületeden él, így bármikor megnyithatod a Macaly szerkesztőjében, és ott folytathatod az építést.
## Mire lesz szükséged
Olyan MCP-kliensre van szükséged, amely támogatja a távoli szervereket Streamable HTTP-n keresztül: Claude (claude.ai, Desktop, Cowork), Claude Code, ChatGPT, Cursor, Grok Bot vagy Codex.
## Csatlakoztasd a klienst
A Claude, a ChatGPT, a Cursor és a Grok Bot a hivatalos katalógusából telepíti a Macaly Cloudot. A Macalyban a **Beállítások → Kapcsolatok** oldalon mindegyikhez van egy kártya, ugyanazokkal a lépésekkel és a katalógusbejegyzés linkjével. A többi kliensben a szervert ezen a címen add hozzá:
```
https://www.macaly.com/api/cloud/mcp
```
Mindkét esetben a kliens megnyit egy böngészőablakot, ahol bejelentkezel a Macalyba, és jóváhagyod a hozzáférést (OAuth). Nem kell kulcsokat másolnod.
1. Nyisd meg a [Macaly Cloud bejegyzést](https://claude.ai/directory/macaly-cloud) a Claude-összekötők katalógusában. Működik a claude.ai-on, az asztali alkalmazásban és mobilon is.
2. Kattints a **Connect** gombra.
3. Jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést a megnyíló ablakban.
Futtasd a terminálban:
```bash theme={null}
claude mcp add macaly-cloud --transport http https://www.macaly.com/api/cloud/mcp
```
Ezután indítsd el a Claude Code-ot, és a `/mcp` paranccsal jelentkezz be a Macalyba.
1. Nyisd meg a [Macaly Cloud pluginjét](https://chatgpt.com/plugins/plugin_asdk_app_6a732e22122c8191ac404137c0514300) a ChatGPT-plugin-katalógusban. Ugyanaz a plugin működik a böngészőben és az asztali alkalmazásban is.
2. Kattints az **Install** gombra.
3. Amikor a ChatGPT kéri a fiókod csatlakoztatását, jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést a megnyíló ablakban.
1. Nyisd meg a [Macaly Cloud pluginjét](https://cursor.com/marketplace/macaly) a Cursor Marketplace-en, és add hozzá. A Cursor chatjében a `/add-plugin macaly-code` parancsot is futtathatod.
2. Amikor a Cursor megnyitja a böngésződet, jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést.
1. A Grok Botban válaszd a **Plugins** elemet az oldalsávon. A mobilalkalmazásban koppints az avatarodra, és válaszd a **Plugins** elemet.
2. Keress rá a **Macaly Cloud** kifejezésre, és add hozzá.
3. Amikor a Grok Bot az **Authorize** gombot kéri, jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést a böngészőben.
4. Ellenőrizd, hogy a plugin megjelenik az **Installed** alatt. Ezután minden általad futtatott Botnak elérhető.
Futtasd a terminálban:
```bash theme={null}
codex mcp add macaly-cloud --url https://www.macaly.com/api/cloud/mcp
codex mcp login macaly-cloud
```
### API-kulcs használata helyette
OAuth helyett [Macaly API-kulccsal](/docs/hu/api/authentication) is hitelesítheted magad. Ez headless ügynököknél és automatizálásnál hasznos. A kulcsot bearer tokenként add át:
```json theme={null}
{
"mcpServers": {
"macaly-cloud": {
"url": "https://www.macaly.com/api/cloud/mcp",
"headers": {
"Authorization": "Bearer macaly_your_api_key_here"
}
}
}
}
```
Az API-kulcsok egyetlen munkaterülethez tartoznak, ezért a `teamId`-t váró eszközök ezt automatikusan kitalálják.
## Építs meg egy alkalmazást az elejétől a végéig
Az ügynököd meghívja a `create_app` eszközt egy névvel. Visszakap egy `chatId`-t és a projekt-összefoglalót (briefing). Az alkalmazás üresen jön létre, kezdő prompt és AI-build nélkül.
A `write_file` egy teljes fájlt ír ki, az `edit_file` pedig pontos szövegrészt cserél egy meglévő fájlban, így egy nagy fájl kis módosításához nem kell újra elküldeni az egész fájlt. Minden `write_file`, `edit_file` és `delete_file` hívás egy atomi git-commit, saját bejegyzéssel az alkalmazás előzményei között. Hideg munkaterületen az első írás \~20–30 másodperccel tovább tart, amíg a sandbox befejezi az indulást.
Adatbázishoz, fizetésekhez, AI-hoz, médiához vagy kereséshez az ügynök a `skill_info` eszközzel elolvassa az útmutatót, és a `bash` eszközzel lefuttatja a parancsait. A sandbox már tartalmazza az útmutatókhoz szükséges hitelesítő adatokat.
Az utolsó írás után az ügynök lefuttatja a `bash ".sandbox/check-errors --strict"` parancsot, amely egy menetben megtalálja a típus-, stílus- és szerverhibákat, az eredmény összefoglalójával zárul, és hibával lép ki, ha a TypeScript- vagy a CSS-ellenőrzés nem sikerül. Hiba esetén a `get_logs` a valódi kimenetet adja vissza.
Az előnézet az utolsó írás után néhány másodperccel automatikusan újraépül. Ha sikerült, a `preview_app` visszaadja az élő URL-t, amelyet megnyithatsz vagy megoszthatsz. A `path` megadásával a link közvetlenül egy aloldalt nyit meg, például a `/pricing` oldalt. Az ügynök minden olyan kör végén meghívja a `preview_app` eszközt, amelyben módosította az alkalmazást, akkor is, ha egy korábbi link még érvényes: ez a hívás jelzi a Macalynak, hogy a kör véget ért.
Ha kifejezetten kéred az élesítést, az ügynök meghívja a `publish_app` eszközt, és a visszakapott `deploymentId` értékkel a `get_deployment` eszközzel kérdezgeti az állapotot, amíg az `READY` nem lesz. Ezután megadja neked a `liveUrl` értékét, vagyis az élő verzió címét. A `connect_domain` egyéni domaint csatlakoztat, vagy átnevezi a Macaly-aldomaint.
## Elérhető eszközök
A Macaly Cloud 20 eszközt tesz elérhetővé.
### Munkaterületek és alkalmazások
| Eszköz | Mit csinál |
| - | - |
| `list_teams` | Kilistázza a munkaterületeket, amelyekben építhetsz |
| `create_app` | Új, üres alkalmazást hoz létre az alapértelmezett stacken, és visszaadja a projekt-összefoglalóját |
| `list_projects` | Kilistázza egy munkaterület alkalmazásait a legutóbb frissítettel kezdve, kereséssel és lapozással. A kitűzött alkalmazások az első oldalon jelennek meg |
| `get_project` | Állapotkép: az előnézeti build állapota, az előnézeti URL, a legutóbbi közzététel állapota és a `liveUrl`, a projekt-összefoglaló, és hogy ki dolgozik éppen az alkalmazáson |
| `get_messages` | Elolvassa az alkalmazás chat-előzményeit (mit kértek és mi épült eddig), mielőtt módosítasz |
| `duplicate_app` | Az alkalmazást előzményeivel együtt új alkalmazásba másolja |
### Kód
| Eszköz | Mit csinál |
| - | - |
| `list_files` | Kilistázza az alkalmazás forrásfájljait |
| `read_file` | Elolvas egy fájlt az elérési útja alapján, vagy a `startLine` és az `endLine` paraméterrel csak a sorok egy tartományát |
| `write_file` | Egy fájlt teljes egészében kiír, és azonnal commitolja |
| `edit_file` | Pontos szövegrészt cserél egy meglévő fájlban, és azonnal commitolja: hívásonként legfeljebb 20 cserét végez, amelyek vagy mind érvényesülnek, vagy egyik sem |
| `delete_file` | Töröl egy fájlt, és a törlést azonnal commitolja |
| `bash` | Shell-parancsot futtat az alkalmazás sandboxában: telepítéseket, CLI-eszközöket, skill-szkripteket és a `.sandbox/check-errors --strict` típusellenőrzést. Egy parancs legfeljebb 32 000 karakter hosszú lehet, és legfeljebb 240 másodpercig futhat |
### Média
| Eszköz | Mit csinál |
| - | - |
| `upload_file` | Hozzáad egy fájlt az alkalmazás médiatárához, és visszaadja az állandó nyilvános URL-jét (legfeljebb 1 GB). A fájl származhat nyilvánosan elérhető URL-ről, vagy egy kész `curl` paranccsal a gépedről vagy az alkalmazás sandboxából |
| `list_media` | Kilistázza az alkalmazás médiatárában lévő fájlokat a nyilvános URL-jükkel, és ad egy linket, ahová helyi fájlt húzhatsz be |
Egyik eszköz sem fogad nyers fájlbájtokat. A gépeden lévő fájlhoz az `upload_file` egy `curl` parancsot ad vissza, amelyet az ügynököd a saját shelledben futtat le. Ha a fájlt az ügynök a sandboxban hozta létre, a parancsot a sandboxban futtatja. Ha az ügynöködnek nincs shellje, húzd be a fájlt a médiatárba a `list_media` által adott linken.
Ne tedd az alkalmazás `public/` mappájába a generált vagy letöltött képeket, hangfájlokat és videókat. Minden előnézeti build újra feltölti a `public/` mappát, így a sok vagy nagy fájl lelassítja a buildet, és akár sikertelenné is teheti. A médiát az `upload_file` eszközzel töltsd fel, és a visszakapott URL-t használd.
### Képességek és diagnosztika
| Eszköz | Mit csinál |
| - | - |
| `skill_info` | Elolvassa egy platformképesség útmutatóját, kész parancsokkal és az alkalmazandó kódmintákkal |
| `get_logs` | Lekéri a build-, a fejlesztői szerver- vagy a telepítési naplókat |
| `preview_app` | Visszaad egy három órán át érvényes, megosztható előnézeti linket, igény szerint egy aloldalhoz |
### Közzététel
| Eszköz | Mit csinál |
| - | - |
| `publish_app` | Élesbe teszi az alkalmazást a `macaly.app` URL-jén |
| `get_deployment` | Ellenőrzi a legutóbbi közzétételi kísérletet (vagy a `deploymentId` által megadottat), a `liveUrl` értékét és a csatlakoztatott domaineket |
| `connect_domain` | Egyéni domaint csatlakoztat, vagy átnevezi az alkalmazás Macaly-aldomainjét |
## Cloud-műveletek
A Cloud-műveletek azok a lépések, amelyeket a külső ügynököd a Macaly Cloudon keresztül végez. Az Ingyenes csomag **havi 100 Cloud-műveletet** tartalmaz. A fizetős csomagokban nincs havi Cloud-műveleti korlát.
Ezek a műveletek számítanak:
* Alkalmazás létrehozása vagy duplikálása (`create_app`, `duplicate_app`)
* Fájlok írása, szerkesztése vagy törlése (`write_file`, `edit_file`, `delete_file`)
* Parancsok futtatása (`bash`)
* Fájlok feltöltése (`upload_file`)
* Közzététel (`publish_app`)
* Domain csatlakoztatása (`connect_domain`)
A fájlok olvasása (`read_file`), a listázás és az előnézetek (`preview_app`) ingyenesek. A Macaly saját ügynökével az alkalmazáson belül folytatott csevegés nem használ Cloud-műveleteket.
Az Ingyenes csomag kerete az egész munkaterületen közös, minden hónap 1-jén (UTC) nullázódik, és nem vihető át a következő hónapra. Ha elfogy, a további számított műveleteket elutasítjuk, az üzenetben a nullázás dátumával és a Számlázás oldalra mutató linkkel. Az olvasás, az már élő alkalmazások és a Macalyval az alkalmazáson belül folytatott csevegés továbbra is működik. A Számlázás oldal és a **Beállítások → Használat és korlátok** mutatja, hány Cloud-műveletet használtál fel. Lásd: [Használat és korlátok](/docs/hu/account/workspaces/usage).
## Együttműködés a Macaly szerkesztővel
A Macaly Cloudon keresztül épített alkalmazás teljesen hétköznapi Macaly-alkalmazás. Megnyithatod a szerkesztőben, megnézheted a verzióelőzményeket, visszagörgethetsz, vagy a Macaly saját ügynökével folytathatod.
* **Minden változás rögzítésre kerül.** Minden írás az ügynököd rövid magyarázatát hordozza, amely az alkalmazás chat-előzményei között kártyaként jelenik meg, a változtatást végző kliens nevével, így a Macaly ügynöke ismeri a kontextust, ha később ott folytatod. Amikor egy több módosítást tartalmazó futás véget ér, a kártyája összefoglalja, mi változott.
* **Vissza is léphetsz.** Egy kártyán az **Előző verzió visszaállítása** gombra kattintva az alkalmazást visszaállíthatod arra az állapotra, amelyben az adott futás után volt. Ez minden későbbi tartalmat töröl a chatből. A **Duplikálás** az adott verziót egy új projektbe másolja.
* **Körönként egy kártya.** A Macaly nem látja az ügynöködnek küldött üzeneteidet, csak az ügynök eszközhívásait. Egy futás akkor ér véget, amikor az ügynököd a `preview_app` vagy a `publish_app` eszközzel visszaadja az alkalmazást. Ha kihagyja ezt a hívást, több kérésed is egyetlen kártyába kerülhet.
* **Egyszerre csak egy ügynök.** Amíg a külső ügynököd dolgozik, a chat zárolva van: a Macaly ügynöke nem indít kört, és az üzenetmező megmutatja, kinél van az alkalmazás. A zárolás magától feloldódik az utolsó írás után néhány perccel, vagy amint az ügynököd megmutatja az előnézetet.
* **Az előnézet megvárja a kész alkalmazást.** A menet közbeni újraépítések visszatartásra kerülnek, így az előnézeti panel a futás végéig a korábbi alkalmazást mutatja.
## Példa promptok
```
Építs nekem egy Macaly-alkalmazást: egy kávéelőfizetés-szolgáltatás
landing oldalát hero résszel, árazással és e-mail-feliratkozó űrlappal.
```
```
Adj egy sötét mód kapcsolót a Macalyban lévő kávés alkalmazásomhoz,
futtass rajta típusellenőrzést, és add meg az előnézeti linket.
```
```
Állíts be egy adatbázist a kávés alkalmazásomhoz, és tárold benne
az e-mail-feliratkozásokat.
```
```
Tedd közzé a kávés alkalmazást, és csatlakoztasd a coffee.example.com domaint.
```
## Hibaelhárítás
Győződj meg róla, hogy a kliensed támogatja a távoli MCP-szervereket OAuth-szal, és hogy a teljes URL-t megadtad, beleértve az `/api/cloud/mcp` útvonalat is.
Valaki más dolgozik az alkalmazáson: a Macaly saját ügynöke éppen egy körben van, vagy egy másik külső szerkesztő írt bele a közelmúltban. Várj, és próbáld újra. A zárolás magától feloldódik az utolsó tevékenység után néhány perccel.
A build kimenete túl nagy, vagy túl sok fájlt tartalmaz, általában a `public/` mappában lévő média miatt. A `get_logs` a `log_type: "build"` paraméterrel megmutatja a fájlok számát és méretét. Az `upload_file` eszközzel vidd ki a médiát a `public/` mappából, használd a visszakapott URL-eket, és hagyd, hogy az előnézet újraépüljön.
Az előnézetek kész buildből szolgálódnak ki. Ellenőrizd a `previewBuildStatus` értékét a `get_project` eszközzel, és ha a build nem sikerült, olvasd el a `get_logs` kimenetét a `log_type: "build"` paraméterrel.
Az Ingyenes csomag havi 100 Cloud-műveletet tartalmaz. Az elutasító üzenet megmutatja a nullázás dátumát (a hónap 1-je, UTC) és a Számlázás oldalra mutató linket. Az olvasás és az előnézetek továbbra is működnek. A havi korlát megszüntetéséhez válts Starter vagy Pro csomagra.
Vagy a munkaterületen, amelyen dolgozol, ki van kapcsolva a Macaly Cloud, vagy a művelethez olyan csomagfunkció kell, amellyel nem rendelkezel, például az egyéni domainre való közzétételhez.
Még mindig elakadtál? Írj nekünk a Macaly chatjében, vagy nézd meg a [GYIK-et](/docs/hu/welcome/faq).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.