Macaly Cloud MCP-server - Macaly Documentation

Macaly Cloud is een MCP-server die van Macaly de infrastructuur achter uw eigen AI-codeeragent maakt. Uw agent schrijft elke regel code; Macaly levert de git-repository, de cloudsandbox, de database en platformmogelijkheden, de build, de deelbare preview en productiehosting op macaly.app. Er wordt niets op uw computer gegenereerd en de agent van Macaly draait nooit. De app staat vanaf het eerste bestand in uw Macaly-workspace, dus u kunt hem altijd in de Macaly-editor openen en daar verder bouwen.

Wat u nodig hebt

U hebt een MCP-client nodig die externe servers via Streamable HTTP ondersteunt - Claude (claude.ai, Desktop, Cowork), Claude Code, ChatGPT, Cursor, Grok Bot of Codex.

Verbind uw client

Claude, ChatGPT, Cursor en Grok Bot installeren Macaly Cloud vanuit hun officiële directory’s. In Macaly staat onder Instellingen → Verbindingen voor Claude en voor ChatGPT een kaart met dezelfde stappen en een link naar de vermelding. Andere clients voegen de server toe op:

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

In beide gevallen opent uw client een browservenster waarin u zich bij Macaly aanmeldt en toegang goedkeurt (OAuth). Er zijn geen sleutels om te kopiëren.

Open de Macaly Cloud-vermelding in de Claude-connectordirectory. Die werkt in claude.ai, de desktopapp en op mobiel.
Klik op Connect.
Meld u aan bij Macaly en keur de toegang goed in het venster dat opent.

Voer uit in uw terminal:

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

Start daarna Claude Code en voer /mcp uit om u bij Macaly aan te melden.

Open de Macaly Cloud-plugin in de Cursor Marketplace en voeg hem toe. U kunt ook /add-plugin macaly-code uitvoeren in de Cursor-chat.
Wanneer Cursor uw browser opent, meldt u zich aan bij Macaly en keurt u de toegang goed.

Voer uit in uw terminal:

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

In plaats daarvan een API-sleutel gebruiken

U kunt zich in plaats van met OAuth ook met een Macaly API-sleutel authenticeren - handig voor headless agents en automatisering. Geef de sleutel mee als bearer token:

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

API-sleutels horen bij één workspace, dus tools met een teamId vullen die zelf in.

Bouw een app van begin tot eind

Maak de app

Uw agent roept create_app aan met een naam en krijgt een chatId en de projectbriefing terug. De app wordt leeg aangemaakt: geen startprompt, geen AI-build.

Schrijf de code

Elke write_file- en delete_file-aanroep is één atomaire git-commit met een eigen vermelding in de geschiedenis van de app. De eerste schrijfactie in een koude workspace duurt zo’n 20-30 seconden langer terwijl de sandbox opstart.

Voeg platformmogelijkheden toe

Voor database, betalingen, AI, media of zoeken leest de agent de handleiding met skill_info en voert hij de commando’s uit met bash - de sandbox bevat al de inloggegevens die de handleidingen nodig hebben.

Controleer de typen

Na de laatste schrijfactie voert de agent bash ".sandbox/check-errors" uit - dat vangt type-, stijl- en serverfouten in één keer. Bij een fout geeft get_logs de echte uitvoer.

Preview

De preview wordt enkele seconden na de laatste schrijfactie automatisch opnieuw gebouwd. Zodra dat lukt, geeft preview_app de live-URL om te openen of te delen.

Publiceer

Wanneer u expliciet vraagt om live te gaan, roept de agent publish_app aan en peilt get_deployment tot de status READY is. connect_domain koppelt een eigen domein of hernoemt het Macaly-subdomein.

Beschikbare tools

Macaly Cloud biedt 18 tools.

Workspaces en apps

Tool	Wat het doet
`list_teams`	Toont de workspaces waarin u kunt bouwen
`create_app`	Maakt een nieuwe, lege app op de standaardstack en geeft de briefing terug
`list_projects`	Toont de apps van een workspace, recentst bijgewerkt eerst, met zoeken en paginering
`get_project`	Statusoverzicht: buildstatus van de preview, preview- en live-URL, de briefing en wie er aan de app werkt
`get_messages`	Leest de chatgeschiedenis van de app - wat er gevraagd en al gebouwd is - voordat er iets wordt gewijzigd
`duplicate_app`	Dupliceert een app met geschiedenis naar een nieuwe

Code

Tool	Wat het doet
`list_files`	Toont de bronbestanden van de app
`read_file`	Leest één bestand op pad
`write_file`	Schrijft één bestand volledig en commit het direct
`delete_file`	Verwijdert één bestand en commit de verwijdering direct
`bash`	Voert een shell-commando uit in de sandbox van de app - installaties, CLI’s, skill-scripts en de typecontrole `.sandbox/check-errors`

Media

Tool	Wat het doet
`upload_file`	Importeert een bestand vanaf een publiek bereikbare URL in de mediabibliotheek van de app en geeft de permanente publieke URL terug (tot 1 GB)

Geen enkele tool accepteert ruwe bestandsbytes. Een bestand dat alleen op uw computer staat, zet u eerst in de mediabibliotheek van de app in Macaly en geeft u vervolgens als publieke URL door aan uw agent.

Mogelijkheden en diagnostiek

Tool	Wat het doet
`skill_info`	Leest de handleiding van een platformmogelijkheid, met kant-en-klare commando’s en de toe te passen codepatronen
`get_logs`	Haalt build-, dev-server- of deploylogs op
`preview_app`	Geeft de live preview-URL om te delen

Publiceren

Tool	Wat het doet
`publish_app`	Publiceert de app naar productie op zijn `macaly.app`-URL
`get_deployment`	Controleert de deploystatus, de live-URL en gekoppelde domeinen
`connect_domain`	Koppelt een eigen domein of hernoemt het Macaly-subdomein

Samenwerken met de Macaly-editor

Een app die via Macaly Cloud is gebouwd, is een gewone Macaly-app. U kunt hem in de editor openen, de versiegeschiedenis bekijken, terugdraaien of verdergaan met de agent van Macaly.

Elke wijziging wordt vastgelegd. Bij elke schrijfactie hoort een korte toelichting van uw agent, die in de chatgeschiedenis verschijnt als een kaart met de naam van de client die de wijziging maakte - zo heeft de agent van Macaly de context als u daar verdergaat.
Slechts één agent tegelijk. Terwijl uw externe agent werkt, is de chat vergrendeld: de agent van Macaly begint geen beurt en het invoerveld laat zien wie de app onder handen heeft. De vergrendeling valt vanzelf weg enkele minuten na de laatste schrijfactie, of zodra uw agent u de preview toont.
De preview wacht op de afgeronde app. Tussentijdse builds worden achtergehouden, zodat het previewpaneel de app blijft tonen die u al had tot de sessie klaar is.

Voorbeeldprompts

Bouw een app op Macaly: een landingspagina voor een koffieabonnement
met hero, prijzen en een e-mailaanmeldformulier.

Voeg een donkere-modusschakelaar toe aan mijn koffie-app op Macaly,
controleer de typen en geef me de previewlink.

Zet een database op voor mijn koffie-app en sla de e-mailaanmeldingen
daarin op.

Publiceer de koffie-app en koppel het domein coffee.example.com.

Problemen oplossen

Het aanmeldvenster verschijnt niet

Controleer of uw client externe MCP-servers met OAuth ondersteunt en of u de volledige URL inclusief het pad /api/cloud/mcp hebt ingevoerd.

Een schrijfactie geeft CHAT_CLAIMED_BY_AGENT of CHAT_CLAIMED_BY_EDITOR

Iemand anders heeft de app: de agent van Macaly zit midden in een beurt, of een andere externe editor heeft er recent naar geschreven. Wacht even en probeer opnieuw - de vergrendeling valt vanzelf weg enkele minuten na de laatste activiteit.

De preview-URL toont nog niets

Previews worden geserveerd vanuit een voltooide build. Controleer previewBuildStatus met get_project en lees bij een mislukking get_logs met log_type: "build".

Een tool geeft FORBIDDEN

Of Macaly Cloud is uitgeschakeld voor de workspace waarin u werkt, of de actie vereist een pakketfunctie die u niet hebt - publiceren op een eigen domein bijvoorbeeld.

Komt u er niet uit? Neem contact op via de chat in Macaly of raadpleeg de FAQ.

​Wat u nodig hebt

​Verbind uw client

​In plaats daarvan een API-sleutel gebruiken

​Bouw een app van begin tot eind

​Beschikbare tools

​Workspaces en apps

​Code

​Media

​Mogelijkheden en diagnostiek

​Publiceren

​Samenwerken met de Macaly-editor

​Voorbeeldprompts

​Problemen oplossen