Macaly Cloud MCP Server - Macaly Documentation

Macaly Cloud är en MCP-server som gör Macaly till infrastrukturen bakom din egen AI-kodagent. Din agent skriver varje rad kod, och Macaly står för git-repositoryt, molnsandlådan, databasen och plattformsfunktionerna, bygget, den delbara förhandsvisningen och produktionshostingen på macaly.app. Inget genereras på din dator och Macalys egen agent körs aldrig. Appen finns i ditt Macaly-workspace från första filen, så du kan öppna den i Macaly-editorn när du vill och fortsätta bygga där.

Det här behöver du

Du behöver en MCP-klient som stöder fjärrservrar över Streamable HTTP: Claude (claude.ai, Desktop, Cowork), Claude Code, ChatGPT, Cursor, Grok Bot eller Codex.

Anslut din klient

Claude, ChatGPT, Cursor och Grok Bot installerar Macaly Cloud från sina officiella kataloger. I Macaly finns under Inställningar → Anslutningar ett kort för var och en av dem, med samma steg och en länk till katalogposten. Andra klienter lägger till servern på adressen:

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

I båda fallen öppnar klienten ett webbläsarfönster där du loggar in på Macaly och godkänner åtkomsten (OAuth). Du behöver inte kopiera några nycklar.

Öppna Macaly Cloud-posten i Claudes katalog över kopplingar. Den fungerar i claude.ai, i skrivbordsappen och på mobilen.
Klicka på Connect.
Logga in på Macaly och godkänn åtkomsten i fönstret som öppnas.

Kör i terminalen:

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

Starta sedan Claude Code och kör /mcp för att logga in på Macaly.

Öppna Macaly Cloud-pluginet i Cursor Marketplace och lägg till det. Du kan också köra /add-plugin macaly-code i Cursors chatt.
När Cursor öppnar din webbläsare loggar du in på Macaly och godkänner åtkomsten.

Kör i terminalen:

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

Använd en API-nyckel i stället

Du kan autentisera med en Macaly API-nyckel i stället för OAuth, vilket är användbart för headless-agenter och automatisering. Skicka nyckeln som bearer-token:

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

API-nycklar gäller för ett enda workspace, så verktyg som tar emot ett teamId räknar ut det automatiskt.

Bygg en app från början till slut

Skapa appen

Din agent anropar create_app med ett namn. Den får tillbaka ett chatId och projektbriefen. Appen skapas tom, utan startprompt och utan AI-bygge.

Skriv koden

write_file skriver en hel fil och edit_file ersätter exakt text i en befintlig fil, så en liten ändring i en stor fil kräver inte att hela filen skickas igen. Varje anrop till write_file, edit_file och delete_file är en atomisk git-commit med en egen post i appens historik. Den första skrivningen i ett kallt workspace tar ca 20–30 sekunder extra medan sandlådan startar klart.

Lägg till plattformsfunktioner

För databas, betalningar, AI, media eller sök läser agenten guiden med skill_info och kör dess kommandon med bash. Sandlådan innehåller redan de inloggningsuppgifter som guiderna behöver.

Typkontrollera

Efter den sista skrivningen kör agenten bash ".sandbox/check-errors --strict", som fångar typ-, stil- och serverfel i ett enda svep, avslutar med en sammanfattning av resultatet och returnerar en felkod när TypeScript- eller CSS-kontrollen misslyckas. Vid fel returnerar get_logs den verkliga utdatan.

Förhandsvisa

Förhandsvisningen byggs om automatiskt några sekunder efter den sista skrivningen. När bygget lyckats returnerar preview_app den live-URL som du kan öppna eller dela. Med path öppnar länken en undersida direkt, till exempel /pricing. Agenten anropar preview_app i slutet av varje tur som ändrade appen, även när en tidigare länk fortfarande gäller. Det anropet talar om för Macaly att turen är klar.

Publicera

När du uttryckligen ber om att gå live anropar agenten publish_app och frågar av get_deployment med det returnerade deploymentId tills statusen är READY. Sedan ger den dig liveUrl, adressen till den version som är live. connect_domain kopplar en egen domän eller byter namn på Macaly-subdomänen.

Tillgängliga verktyg

Macaly Cloud erbjuder 20 verktyg.

Workspaces och appar

Verktyg	Vad det gör
`list_teams`	Listar de workspaces där du kan bygga
`create_app`	Skapar en ny, tom app på standardstacken och returnerar dess brief
`list_projects`	Listar en workspaces appar, senast uppdaterade först, med sök och sidindelning. Fästa appar kommer med på första sidan
`get_project`	Statusögonblicksbild: byggstatus för förhandsvisningen, förhandsvisningens URL, status för den senaste publiceringen och `liveUrl`, briefen och vem som för tillfället arbetar i appen
`get_messages`	Läser appens chatthistorik, alltså vad som har efterfrågats och byggts hittills, innan du gör ändringar
`duplicate_app`	Förgrenar en app med dess historik till en ny app

Kod

Verktyg	Vad det gör
`list_files`	Listar appens källfiler
`read_file`	Läser en fil via sökväg, eller bara ett radintervall med `startLine` och `endLine`
`write_file`	Skriver en fil i sin helhet och committar den direkt
`edit_file`	Ersätter exakt text i en befintlig fil och committar den direkt: upp till 20 ersättningar per anrop, där antingen alla eller inga tillämpas
`delete_file`	Tar bort en fil och committar borttagningen direkt
`bash`	Kör ett skalkommando i appens sandlåda: installationer, CLI-verktyg, färdighetsskript och typkontrollen `.sandbox/check-errors --strict`. Ett kommando kan ha upp till 32 000 tecken och köras i upp till 240 sekunder

Media

Verktyg	Vad det gör
`upload_file`	Lägger till en fil i appens mediebibliotek och returnerar dess permanenta publika URL (upp till 1 GB). Filen kommer från en offentligt nåbar URL, eller från din dator eller appens sandlåda via ett färdigt `curl`-kommando
`list_media`	Listar filerna i appens mediebibliotek med deras publika URL:er och ger en länk där du kan släppa en lokal fil

Inget verktyg tar emot råa filbytes. För en fil på din dator returnerar upload_file ett curl-kommando som din agent kör i ditt eget skal. För en fil som agenten har skapat i sandlådan kör den kommandot i sandlådan. Om din agent inte har något skal släpper du filen i mediebiblioteket via länken från list_media.

Håll genererade eller nedladdade bilder, ljud och videor utanför appens mapp public/. Varje bygge av förhandsvisningen laddar upp public/ på nytt, så många eller stora filer gör bygget långsammare och kan få det att misslyckas. Ladda upp media med upload_file och använd den returnerade URL:en.

Funktioner och diagnostik

Verktyg	Vad det gör
`skill_info`	Läser en plattformsfunktions guide, med färdiga kommandon och de kodmönster som ska användas
`get_logs`	Hämtar loggar för bygge, utvecklingsserver eller driftsättning
`preview_app`	Returnerar en förhandsvisningslänk att dela som gäller i tre timmar, eventuellt till en undersida

Publicering

Verktyg	Vad det gör
`publish_app`	Publicerar appen i produktion på dess `macaly.app`-URL
`get_deployment`	Kontrollerar det senaste publiceringsförsöket (eller ett visst via `deploymentId`), `liveUrl` och anslutna domäner
`connect_domain`	Ansluter en egen domän eller byter namn på appens Macaly-subdomän

Cloud-åtgärder

Cloud-åtgärder är det din externa agent gör via Macaly Cloud. Abonnemanget Gratis innehåller 100 Cloud-åtgärder per månad. Betalda abonnemang har ingen månadsgräns för Cloud-åtgärder. Dessa åtgärder räknas:

Skapa eller duplicera en app (create_app, duplicate_app)
Skriva, redigera eller radera filer (write_file, edit_file, delete_file)
Köra kommandon (bash)
Ladda upp filer (upload_file)
Publicera (publish_app)
Ansluta en domän (connect_domain)

Att läsa filer (read_file), lista och förhandsvisa (preview_app) är gratis. Att chatta med Macalys egen agent i appen använder inga Cloud-åtgärder. Kvoten i Gratis delas av hela workspacen, återställs den 1:a varje månad (UTC) och förs inte över. När den är slut avvisas fler räknade åtgärder, med återställningsdatumet och en länk till Fakturering. Läsningar, appar som redan är live och chatt med Macaly i appen fortsätter fungera. Fakturering och Inställningar → Användning och begränsningar visar hur många Cloud-åtgärder du har använt. Se Användning och begränsningar.

Arbeta tillsammans med Macaly-editorn

En app som byggts via Macaly Cloud är en vanlig Macaly-app. Du kan öppna den i editorn, titta på versionshistoriken, återställa eller fortsätta med Macalys egen agent.

Varje ändring registreras. Varje skrivning har en kort förklaring från din agent, som visas i appens chatthistorik som ett kort med namnet på den klient som gjorde ändringen. Då har Macalys agent sammanhanget om du fortsätter där senare. När en körning med flera ändringar är klar sammanfattar dess kort vad som ändrades.
Du kan gå tillbaka. Klicka på Återställ föregående version på ett kort för att återställa appen till hur den var efter den körningen. Allt som kom efter tas då bort från chatten. Duplicera kopierar den versionen till ett nytt projekt.
Ett kort per tur. Macaly ser inte dina meddelanden till din agent, bara dess verktygsanrop. En körning avslutas när din agent lämnar tillbaka appen med preview_app eller publish_app. Om den hoppar över det anropet kan flera av dina förfrågningar hamna i ett och samma kort.
Bara en agent åt gången. Medan din externa agent arbetar är chatten låst: Macalys agent startar ingen tur, och inmatningsfältet visar vem som har appen. Låset släpps av sig självt några minuter efter den sista skrivningen, eller så snart din agent visar dig förhandsvisningen.
Förhandsvisningen väntar på den färdiga appen. Ombyggen under pågående bygge hålls tillbaka, så förhandsvisningspanelen fortsätter visa den app du redan hade tills körningen är klar.

Exempelprompter

Bygg en Macaly-app åt mig: en landningssida för en kaffeprenumeration
med hero, priser och ett registreringsformulär för e-post.

Lägg till en omkopplare för mörkt läge i min kaffeapp på Macaly,
typkontrollera den och ge mig förhandsvisningslänken.

Sätt upp en databas för min kaffeapp och spara e-postregistreringarna i den.

Publicera kaffeappen och anslut domänen coffee.example.com.

Felsökning

Inloggningsfönstret visas inte

Kontrollera att din klient stöder MCP-fjärrservrar med OAuth och att du har angett hela URL:en inklusive sökvägen /api/cloud/mcp.

En skrivning returnerar CHAT_CLAIMED_BY_AGENT eller CHAT_CLAIMED_BY_EDITOR

Någon annan har appen: Macalys egen agent är mitt i en tur, eller så har en annan extern editor skrivit till den nyligen. Vänta och försök igen. Låset släpps av sig självt några minuter efter den senaste aktiviteten.

Bygget av förhandsvisningen misslyckas på grund av en tidsgräns vid uppladdning

Byggets utdata är för stor eller har för många filer, oftast media i public/. get_logs med log_type: "build" visar antalet filer och deras storlek. Flytta ut media ur public/ med upload_file, använd de returnerade URL:erna och låt förhandsvisningen byggas igen.

Förhandsvisningens URL visar inget än

Förhandsvisningar serveras från ett slutfört bygge. Kontrollera previewBuildStatus med get_project och läs get_logs med log_type: "build" om bygget misslyckades.

En åtgärd avvisas för att mina Cloud-åtgärder är slut

Abonnemanget Gratis innehåller 100 Cloud-åtgärder per månad. Meddelandet visar datumet då de återställs (den 1:a i månaden, UTC) och en länk till Fakturering. Läsningar och förhandsvisningar fungerar fortfarande. Uppgradera till Starter eller Pro för att ta bort månadsgränsen.

Ett verktyg returnerar FORBIDDEN

Antingen har den workspace du agerar i Macaly Cloud avstängt, eller så kräver åtgärden en funktion som ditt abonnemang saknar, till exempel publicering på en egen domän.

Kommer du inte vidare? Hör av dig via chatten i Macaly eller läs de vanliga frågorna.

​Det här behöver du

​Anslut din klient

​Använd en API-nyckel i stället

​Bygg en app från början till slut

​Tillgängliga verktyg

​Workspaces och appar

​Kod

​Media

​Funktioner och diagnostik

​Publicering

​Cloud-åtgärder

​Arbeta tillsammans med Macaly-editorn

​Exempelprompter

​Felsökning

Det här behöver du

Anslut din klient

Använd en API-nyckel i stället

Bygg en app från början till slut

Tillgängliga verktyg

Workspaces och appar

Kod

Media

Funktioner och diagnostik

Publicering

Cloud-åtgärder

Arbeta tillsammans med Macaly-editorn

Exempelprompter

Felsökning