> ## 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 > Kód píše Claude, ChatGPT nebo Codex - Macaly ho spouští, builduje a hostuje Macaly Cloud je [MCP](https://modelcontextprotocol.io) 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. 1. Na [claude.ai](https://claude.ai) nebo v desktopové aplikaci Claude otevřete **Settings → Connectors**. 2. Klikněte na **Add custom connector**. 3. Zadejte `https://www.macaly.com/api/cloud/mcp` a klikněte na **Add**. 4. Klikněte na **Connect** a schvalte přístup v okně Macaly, které se otevře. Spusťte v terminálu: ```bash theme={null} 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. 1. Otevřete **Settings → Plugins**. Pokud tam položka není, zapněte nejdřív **Developer mode** v **Settings → Security and login**. 2. Klikněte na **Add** a zvolte **Add MCP server**. 3. Zadejte `https://www.macaly.com/api/cloud/mcp` a potvrďte. 4. Schvalte přístup v okně Macaly, které se otevře. Spusťte v terminálu: ```bash theme={null} 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](/docs/cs/api/authentication) - hodí se pro headless agenty a automatizaci. Klíč předejte jako bearer token: ```json theme={null} { "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 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. 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. 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í. 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 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í. 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íží Ověřte, že váš klient podporuje vzdálené MCP servery s OAuth a že jste zadali celou URL včetně cesty `/api/cloud/mcp`. 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ě. 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"`. 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](/docs/cs/welcome/faq).