> ## 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
> Laat Claude, ChatGPT, Cursor, Grok Bot of Codex de code schrijven - Macaly draait, bouwt en host hem
Macaly Cloud is een [MCP](https://modelcontextprotocol.io)-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.
1. Open de [Macaly Cloud-vermelding](https://claude.ai/directory/macaly-cloud) in de Claude-connectordirectory. Die werkt in claude.ai, de desktopapp en op mobiel.
2. Klik op **Connect**.
3. Meld u aan bij Macaly en keur de toegang goed in het venster dat opent.
Voer uit in uw terminal:
```bash theme={null}
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.
1. Open de [Macaly Cloud-plugin](https://chatgpt.com/plugins/plugin_asdk_app_6a732e22122c8191ac404137c0514300) in de ChatGPT-plugindirectory. Dezelfde plugin werkt in de browser en de desktopapp.
2. Klik op **Install**.
3. Wanneer ChatGPT vraagt om uw account te verbinden, meldt u zich aan bij Macaly en keurt u de toegang goed in het venster dat opent.
1. Open de [Macaly Cloud-plugin](https://cursor.com/marketplace/macaly) in de Cursor Marketplace en voeg hem toe. U kunt ook `/add-plugin macaly-code` uitvoeren in de Cursor-chat.
2. Wanneer Cursor uw browser opent, meldt u zich aan bij Macaly en keurt u de toegang goed.
1. Selecteer in Grok Bot **Plugins** in de zijbalk. Tik in de mobiele app op uw avatar en selecteer **Plugins**.
2. Zoek **Macaly Cloud** en voeg hem toe.
3. Wanneer Grok Bot om **Authorize** vraagt, meldt u zich aan bij Macaly en keurt u de toegang goed in uw browser.
4. Controleer of de plugin onder **Installed** staat. Daarna is hij beschikbaar voor elke Bot die u uitvoert.
Voer uit in uw terminal:
```bash theme={null}
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](/docs/nl/api/authentication) authenticeren - handig voor headless agents en automatisering. Geef de sleutel mee als 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-sleutels horen bij één workspace, dus tools met een `teamId` vullen die zelf in.
## Bouw een app van begin tot eind
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.
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.
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.
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.
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.
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
Controleer of uw client externe MCP-servers met OAuth ondersteunt en of u de volledige URL inclusief het pad `/api/cloud/mcp` hebt ingevoerd.
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.
Previews worden geserveerd vanuit een voltooide build. Controleer `previewBuildStatus` met `get_project` en lees bij een mislukking `get_logs` met `log_type: "build"`.
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](/docs/nl/welcome/faq).