Macaly Cloud MCP Server - Macaly Documentation

A Macaly Cloud egy MCP-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.

Nyisd meg a Macaly Cloud bejegyzést a Claude-összekötők katalógusában. Működik a claude.ai-on, az asztali alkalmazásban és mobilon is.
Kattints a Connect gombra.
Jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést a megnyíló ablakban.

Futtasd a terminálban:

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.

Nyisd meg a Macaly Cloud pluginjét a Cursor Marketplace-en, és add hozzá. A Cursor chatjében a /add-plugin macaly-code parancsot is futtathatod.
Amikor a Cursor megnyitja a böngésződet, jelentkezz be a Macalyba, és hagyd jóvá a hozzáférést.

Futtasd a terminálban:

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 is hitelesítheted magad. Ez headless ügynököknél és automatizálásnál hasznos. A kulcsot bearer tokenként add át:

{
  "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

Hozd létre az alkalmazást

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.

Írd meg a kódot

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.

Adj hozzá platformképességeket

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.

Típusellenőrzés

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.

Előnézet

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.

Közzététel

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.

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

Nem jelenik meg a bejelentkezési ablak

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.

Egy írás CHAT_CLAIMED_BY_AGENT vagy CHAT_CLAIMED_BY_EDITOR hibát ad vissza

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.

Az előnézeti build feltöltési időtúllépéssel meghiúsul

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ézeti URL még nem mutat semmit

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.

Egy műveletet elutasít, mert elfogytak a Cloud-műveleteim

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.

Egy eszköz FORBIDDEN hibát ad vissza

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.

​Mire lesz szükséged

​Csatlakoztasd a klienst

​API-kulcs használata helyette

​Építs meg egy alkalmazást az elejétől a végéig

​Elérhető eszközök

​Munkaterületek és alkalmazások

​Kód

​Média

​Képességek és diagnosztika

​Közzététel

​Cloud-műveletek

​Együttműködés a Macaly szerkesztővel

​Példa promptok

​Hibaelhárítás

Mire lesz szükséged

Csatlakoztasd a klienst

API-kulcs használata helyette

Építs meg egy alkalmazást az elejétől a végéig

Elérhető eszközök

Munkaterületek és alkalmazások

Kód

Média

Képességek és diagnosztika

Közzététel

Cloud-műveletek

Együttműködés a Macaly szerkesztővel

Példa promptok

Hibaelhárítás