> ## 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
> Låt Claude, ChatGPT, Cursor, Grok Bot eller Codex skriva koden, medan Macaly kör, bygger och hostar den
Macaly Cloud är en [MCP](https://modelcontextprotocol.io)-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.
1. Öppna [Macaly Cloud-posten](https://claude.ai/directory/macaly-cloud) i Claudes katalog över kopplingar. Den fungerar i claude.ai, i skrivbordsappen och på mobilen.
2. Klicka på **Connect**.
3. Logga in på Macaly och godkänn åtkomsten i fönstret som öppnas.
Kör i terminalen:
```bash theme={null}
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.
1. Öppna [Macaly Cloud-pluginet](https://chatgpt.com/plugins/plugin_asdk_app_6a732e22122c8191ac404137c0514300) i ChatGPT:s plugin-katalog. Samma plugin fungerar i webbläsaren och i skrivbordsappen.
2. Klicka på **Install**.
3. När ChatGPT ber om att få ansluta ditt konto loggar du in på Macaly och godkänner åtkomsten i fönstret som öppnas.
1. Öppna [Macaly Cloud-pluginet](https://cursor.com/marketplace/macaly) i Cursor Marketplace och lägg till det. Du kan också köra `/add-plugin macaly-code` i Cursors chatt.
2. När Cursor öppnar din webbläsare loggar du in på Macaly och godkänner åtkomsten.
1. Välj **Plugins** i sidofältet i Grok Bot. I mobilappen trycker du på din avatar och väljer **Plugins**.
2. Sök efter **Macaly Cloud** och lägg till det.
3. När Grok Bot ber dig att **Authorize** loggar du in på Macaly och godkänner åtkomsten i webbläsaren.
4. Kontrollera att pluginet visas under **Installed**. Då är det tillgängligt för varje Bot du kör.
Kör i terminalen:
```bash theme={null}
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](/docs/sv/api/authentication) i stället för OAuth, vilket är användbart för headless-agenter och automatisering. Skicka nyckeln som 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-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
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.
`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.
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.
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ö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.
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](/docs/sv/account/workspaces/usage).
## 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
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`.
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.
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ö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.
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.
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](/docs/sv/welcome/faq).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.