Macaly Cloud MCP-server

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 elk van hen 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.

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

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

Beschikbare tools

Macaly Cloud biedt 20 tools.

Workspaces en apps

Code

Media

Geen enkele tool accepteert ruwe bestandsbytes. Voor een bestand op uw computer geeft upload_file een curl-commando terug dat uw agent in uw eigen shell uitvoert. Voor een bestand dat de agent in de sandbox heeft gemaakt, voert hij het commando in de sandbox uit. Heeft uw agent geen shell, zet het bestand dan in de mediabibliotheek via de link van list_media.

Mogelijkheden en diagnostiek

Publiceren

Cloud-acties

Cloud-acties zijn wat uw externe agent via Macaly Cloud doet. Het gratis pakket bevat 100 Cloud-acties per maand. Betaalde pakketten hebben geen maandelijkse limiet voor Cloud-acties.

Deze acties tellen mee:

• Een app aanmaken of dupliceren (create_app, duplicate_app)
• Bestanden schrijven, bewerken of verwijderen (write_file, edit_file, delete_file)
• Commando’s uitvoeren (bash)
• Bestanden uploaden (upload_file)
• Publiceren (publish_app)
• Een domein koppelen (connect_domain)

Bestanden lezen (read_file), lijsten opvragen en previews (preview_app) zijn gratis. Chatten met de eigen agent van Macaly in de app gebruikt geen Cloud-acties.

De gratis hoeveelheid wordt gedeeld door de hele workspace, begint op de 1e van elke maand (UTC) opnieuw en wordt niet doorgeschoven. Is de hoeveelheid op, dan worden verdere meetellende acties geweigerd, met de datum waarop het tegoed weer wordt vernieuwd en een link naar Facturering. Lezen, apps die al live staan en chatten met Macaly in de app blijven werken. Facturering en Instellingen → Gebruik en limieten tonen hoeveel Cloud-acties u hebt gebruikt. Zie Gebruik en limieten.

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. Wanneer een sessie met meerdere wijzigingen klaar is, vat de kaart samen wat er is veranderd.
• U kunt teruggaan. Klik op een kaart op Vorige versie herstellen om de app terug te zetten naar de stand na die sessie. Alles wat daarna kwam, wordt dan uit de chat verwijderd. Dupliceren kopieert die versie naar een nieuw project.
• Eén kaart per beurt. Macaly ziet uw berichten aan uw agent niet, alleen de tool-aanroepen van de agent. Een sessie eindigt wanneer uw agent de app teruggeeft met preview_app of publish_app. Slaat hij die aanroep over, dan kunnen meerdere verzoeken van u in één kaart terechtkomen.
• 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

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