Macaly Cloud MCP Server

Macaly Cloud je MCP server, který z Macaly dělá infrastrukturu pro vašeho vlastního AI agenta. Váš agent píše každý řádek kódu; Macaly poskytuje git repozitář, cloudový sandbox, databázi a platformní schopnosti, build, sdílitelný náhled a produkční hosting na macaly.app. Nic nevzniká na vašem počítači a agent Macaly se vůbec nespustí. Aplikace žije ve vašem workspacu v Macaly od prvního souboru, takže ji kdykoli otevřete v editoru Macaly a pokračujete v práci tam.

Co budete potřebovat

Budete potřebovat MCP klienta, který podporuje vzdálené servery přes Streamable HTTP - Claude (claude.ai, Desktop, Cowork), Claude Code, ChatGPT nebo Codex.

Připojte svého klienta

Server je dostupný na adrese:

https://www.macaly.com/api/cloud/mcp

Když ho přidáte, klient otevře okno prohlížeče, ve kterém se přihlásíte do Macaly a schválíte přístup (OAuth). Žádné klíče kopírovat nemusíte.

Claude
Claude Code
ChatGPT
Codex

Na claude.ai nebo v desktopové aplikaci Claude otevřete Settings → Connectors.
Klikněte na Add custom connector.
Zadejte https://www.macaly.com/api/cloud/mcp a klikněte na Add.
Klikněte na Connect a schvalte přístup v okně Macaly, které se otevře.

Spusťte v terminálu:

claude mcp add macaly-cloud --transport http https://www.macaly.com/api/cloud/mcp

Pak spusťte Claude Code a příkazem /mcp se přihlaste do Macaly.

Otevřete Settings → Plugins. Pokud tam položka není, zapněte nejdřív Developer mode v Settings → Security and login.
Klikněte na Add a zvolte Add MCP server.
Zadejte https://www.macaly.com/api/cloud/mcp a potvrďte.
Schvalte přístup v okně Macaly, které se otevře.

Spusťte v terminálu:

codex mcp add macaly-cloud --url https://www.macaly.com/api/cloud/mcp
codex mcp login macaly-cloud

Při připojení přes OAuth může váš agent pracovat v každém workspacu, jehož jste členem. Pokud jich máte víc, nechte ho nejdřív „vypsat moje týmy v Macaly” - create_app potřebuje vědět, kde má stavět.

Přihlášení pomocí API klíče

Místo OAuth se můžete autentizovat API klíčem Macaly - hodí se pro headless agenty a automatizaci. Klíč předejte jako bearer token:

{
  "mcpServers": {
    "macaly-cloud": {
      "url": "https://www.macaly.com/api/cloud/mcp",
      "headers": {
        "Authorization": "Bearer macaly_your_api_key_here"
      }
    }
  }
}

API klíče jsou vázané na jeden workspace, takže nástroje s parametrem teamId si ho doplní samy.

Postavte aplikaci od začátku do konce

Vytvořte aplikaci

Váš agent zavolá create_app s názvem. Zpět dostane chatId a briefing projektu. Aplikace vznikne prázdná - žádný úvodní prompt, žádný AI build.

Napište kód

Každé volání write_file a delete_file je jeden atomický git commit s vlastním záznamem v historii aplikace. První zápis do studeného workspacu trvá o ~20-30 sekund déle, než se sandbox nastartuje.

Přidejte platformní schopnosti

U databáze, plateb, AI, médií nebo vyhledávání si agent přečte návod přes skill_info a spustí jeho příkazy pomocí bash - sandbox už má přihlašovací údaje, které návody potřebují.

Zkontrolujte typy

Po posledním zápisu agent spustí bash ".sandbox/check-errors" - zachytí typové, stylové i serverové chyby naráz. Při selhání vrátí get_logs skutečný výstup.

Náhled

Náhled se přebuilduje automaticky pár vteřin po posledním zápisu. Jakmile build projde, preview_app vrátí živou URL k otevření nebo sdílení.

Publikujte

Až výslovně řeknete, že chcete jít do provozu, agent zavolá publish_app a dotazuje se get_deployment, dokud stav není READY. connect_domain připojí vlastní doménu nebo přejmenuje subdoménu Macaly.

Dostupné nástroje

Macaly Cloud nabízí 19 nástrojů.

Workspacy a aplikace

Nástroj	Co dělá
`list_teams`	Vypíše workspacy, ve kterých můžete stavět
`create_app`	Vytvoří novou prázdnou aplikaci na výchozím stacku a vrátí její briefing
`list_projects`	Vypíše aplikace workspacu od naposledy upravených, s hledáním a stránkováním
`get_project`	Přehled stavu: stav buildu náhledu, URL náhledu a živé verze, briefing a kdo právě na aplikaci pracuje
`get_messages`	Přečte historii chatu aplikace - co bylo zadáno a co už je postavené - než začne měnit
`duplicate_app`	Naklonuje aplikaci i s historií do nové

Kód

Nástroj	Co dělá
`list_files`	Vypíše zdrojové soubory aplikace
`read_file`	Přečte jeden soubor podle cesty
`write_file`	Zapíše celý soubor a hned ho commitne
`delete_file`	Smaže soubor a smazání hned commitne
`bash`	Spustí příkaz v sandboxu aplikace - instalace, CLI, skripty skillů a typovou kontrolu `.sandbox/check-errors`

Média

Nástroj	Co dělá
`upload_file`	Naimportuje soubor z veřejně dostupné URL do knihovny médií aplikace a vrátí jeho trvalou veřejnou URL (až 1 GB)
`list_media`	Vypíše knihovnu médií aplikace včetně odkazu, kam můžete přetáhnout soubory ze svého počítače

Žádný nástroj nepřijímá surové bajty souboru. Soubor, který existuje jen na vašem počítači, dostanete do aplikace přes odkaz na knihovnu médií z list_media - agent vám ho pošle, soubor tam přetáhnete a agent si jeho veřejnou URL vyzvedne dalším voláním list_media.

Schopnosti a diagnostika

Nástroj	Co dělá
`skill_info`	Načte návod k platformní schopnosti s hotovými příkazy a vzory kódu
`get_logs`	Stáhne logy buildu, dev serveru nebo nasazení
`preview_app`	Vrátí živou URL náhledu ke sdílení

Publikování

Nástroj	Co dělá
`publish_app`	Publikuje aplikaci do produkce na její `macaly.app` URL
`get_deployment`	Zjistí stav nasazení, živou URL a připojené domény
`connect_domain`	Připojí vlastní doménu nebo přejmenuje subdoménu Macaly

Souběh s editorem Macaly

Aplikace postavená přes Macaly Cloud je běžná aplikace Macaly. Můžete ji otevřít v editoru, prohlédnout si historii verzí, vrátit se zpět nebo pokračovat s agentem Macaly.

Každá změna se zaznamenává. Ke každému zápisu patří krátké vysvětlení od vašeho agenta, které se objeví v historii chatu jako karta s názvem klienta, který změnu provedl - takže agent Macaly má kontext, pokud budete pokračovat tam.
Vždy jen jeden agent. Zatímco pracuje váš externí agent, je chat zamčený: agent Macaly nezačne svůj tah a v okně pro psaní uvidíte, kdo aplikaci právě drží. Zámek se sám uvolní pár minut po posledním zápisu, nebo hned jakmile vám agent ukáže náhled.
Náhled čeká na hotovou aplikaci. Buildy uprostřed práce se zadržují, takže panel náhledu ukazuje aplikaci, kterou jste měli, dokud běh neskončí.

Ukázkové prompty

Postav mi aplikaci na Macaly: landing page pro předplatné kávy
s hero sekcí, ceníkem a formulářem pro sběr e-mailů.

Přidej do mé kávové aplikace na Macaly přepínač tmavého režimu,
zkontroluj typy a pošli mi odkaz na náhled.

Nastav mé kávové aplikaci databázi a ukládej do ní přihlášené e-maily.

Publikuj kávovou aplikaci a připoj doménu coffee.example.com.

Řešení potíží

Neobjeví se přihlašovací okno

Ověřte, že váš klient podporuje vzdálené MCP servery s OAuth a že jste zadali celou URL včetně cesty /api/cloud/mcp.

Zápis vrací CHAT_CLAIMED_BY_AGENT nebo CHAT_CLAIMED_BY_EDITOR

Aplikaci právě drží někdo jiný: buď je uprostřed tahu agent Macaly, nebo do ní nedávno zapisoval jiný externí editor. Počkejte a zkuste to znovu - zámek se sám uvolní pár minut po poslední aktivitě.

URL náhledu zatím nic neukazuje

Náhledy se servírují z dokončeného buildu. Zkontrolujte previewBuildStatus přes get_project a při selhání si přečtěte get_logs s log_type: "build".

Nástroj vrací FORBIDDEN

Buď má workspace, ve kterém pracujete, Macaly Cloud vypnutý, nebo akce vyžaduje funkci plánu, kterou nemáte - třeba publikování na vlastní doménu.

Stále si nevíte rady? Ozvěte se přes chat v Macaly nebo mrkněte do FAQ.

Propojení

Integrace

Co budete potřebovat

Připojte svého klienta

Přihlášení pomocí API klíče

Postavte aplikaci od začátku do konce

Dostupné nástroje

Workspacy a aplikace

Kód

Média

Schopnosti a diagnostika

Publikování

Souběh s editorem Macaly

Ukázkové prompty

Řešení potíží

​Co budete potřebovat

​Připojte svého klienta

​Přihlášení pomocí API klíče

​Postavte aplikaci od začátku do konce

​Dostupné nástroje

​Workspacy a aplikace

​Kód

​Média

​Schopnosti a diagnostika

​Publikování

​Souběh s editorem Macaly

​Ukázkové prompty

​Řešení potíží

Co budete potřebovat

Připojte svého klienta

Přihlášení pomocí API klíče

Postavte aplikaci od začátku do konce

Dostupné nástroje

Workspacy a aplikace

Kód

Média

Schopnosti a diagnostika

Publikování

Souběh s editorem Macaly

Ukázkové prompty

Řešení potíží