Verbinden met onze MCP-server
CloudPress draait een Model Context Protocol (MCP)-server zodat een AI-assistent — zoals Claude of OpenAI Codex — namens jou met je sites, domeinen, DNS, CDN en Shield kan werken, rechtstreeks vanuit een chat. Je voegt hem één keer toe in je client, logt in op CloudPress in je browser om hem te autoriseren, en vanaf dan kun je de assistent vragen om dingen te doen zoals "lijst mijn sites op" of "voeg een DNS-record toe." Voor de volledige technische referentie, zie MCP-server.
Voordat je begint
- Een betaalde CloudPress-workspace. Proefworkspaces kunnen geen AI-clients of andere apps — je moet eerst upgraden of een betaalde workspace aanmaken.
- Een AI-client die remote MCP-servers ondersteunt (bijvoorbeeld Claude of OpenAI Codex).
- Je CloudPress-merkhost. De meeste mensen gebruiken
my.cloudpress.com. Als je inlogt op een white-label-adres (bijvoorbeeldbrand.example.com), gebruik dan die host in plaats daarvan.
Hoe het werkt
De CloudPress MCP-server staat op één URL — https://my.cloudpress.com/mcp — en je
client verbindt er rechtstreeks mee via internet. Er is niets te downloaden en je plakt
geen token of wachtwoord: wanneer je de server toevoegt, stuurt je client je naar
CloudPress in je browser om één keer in te loggen en toegang goed te keuren.
Gebruik je eigen merkhost
Vervang my.cloudpress.com door de host waarop je daadwerkelijk inlogt. White-label-
merken hebben elk hun eigen adres. De /mcp-URL moet overeenkomen met het merk waarop je inlogt
om te autoriseren — toegang is vergrendeld aan het merk waaronder die is verleend.
Stappen
1. Voeg de server toe in je AI-client
Voeg CloudPress toe als remote MCP-server met de bovenstaande URL. De exacte menubewoording hangt af van je client.
Claude ondersteunt CloudPress als custom connector.
- Open Claude's connectorinstellingen en voeg een custom connector toe (in huidige desktopbuilds, Customize → Connectors → Add custom connector).
- Geef hem een Name, bijvoorbeeld
CloudPress. - Stel de Remote MCP server URL in op
https://my.cloudpress.com/mcp. - Klik op Add.
- Open Codex' MCP-serverinstellingen en voeg een nieuwe server toe (in huidige desktopbuilds, Settings → MCP Servers → Add Server).
- Voer de server-URL
https://my.cloudpress.com/mcpin. Er zijn geen andere velden nodig. - Sla op.
Nadat je hem hebt toegevoegd, vraagt de client je om te authenticeren met je CloudPress- account om de verbinding af te ronden.
Oudere clients
Een paar oudere clients kunnen niet rechtstreeks met een remote MCP-server praten en hebben in plaats daarvan een kleine lokale bridge nodig. Als die van jou er een is, volg dan Geavanceerd: handmatige installatie in de MCP-serverreferentie.
2. Log in op CloudPress
Je client opent een CloudPress-pagina in je browser. Log in met je gewone CloudPress- e-mailadres en wachtwoord als je nog niet bent ingelogd.
Dit is de standaard beveiligde OAuth-aanmelding: je AI-client ziet nooit je wachtwoord, alleen de beperkte toegang die je in de volgende stap goedkeurt. Zie OAuth 2.1 voor details.
3. Kies een workspace
CloudPress toont een autorisatiescherm met de titel (de naam van je client) autoriseren, met de prompt "Kies een workspace en bekijk de machtigingen die deze applicatie aanvraagt."
- Open onder Workspace de kiezer (gelabeld Choose a workspace…) en selecteer de CloudPress-workspace waarop de assistent moet handelen. De opmerking onder de kiezer bevestigt dat de app toegang krijgt tot die ene workspace alleen.
Alleen betaalde workspaces verschijnen hier
Als je in plaats daarvan een pagina Geen geschikte workspace ziet, heb je nog geen betaalde workspace op deze site — upgrade je proefperiode of maak een betaalde workspace aan en probeer het opnieuw.
4. Bekijk de rechten en autoriseer
Onder de workspacekiezer toont de lijst Machtigingen precies wat je verleent. Het scherm toont alleen de rechten waar je client om heeft gevraagd, elk met een selectievakje dat aangevinkt begint — vink alles uit wat je de assistent niet wilt geven. Over alle clients heen zijn de rechten die kunnen verschijnen:
| Recht | Wat het de assistent laat doen |
|---|---|
| Sites bekijken | Je sites opsommen en hun configuratie en statistieken lezen |
| Sites beheren | Sites aanmaken, wijzigen en verwijderen |
| Domeinen bekijken | Domeinen opsommen en registratiegegevens lezen |
| Domeinen beheren | Domeinen registreren, wijzigen en verwijderen |
| DNS bekijken | DNS-zones en -records opsommen |
| DNS beheren | DNS-zones en -records aanmaken, wijzigen en verwijderen |
| Facturering bekijken | Abonnementen en orders lezen — geen betalingswijzigingen |
Als je tevreden bent met de selectie, klik je op Autoriseren. Om eruit te stappen zonder iets te verlenen, klik je op Annuleren.
Nadat je autoriseert, geeft de browser de controle terug aan je AI-client en is de verbinding live. Je kunt het tabblad sluiten.
Wat de assistent nu kan doen
Eenmaal verbonden kun je de assistent in gewone taal iets vragen en gebruikt hij de rechten die je hebt verleend. Een paar voorbeelden:
- "Lijst mijn sites op en welke krijgt het meeste verkeer."
- "Voeg een
A-record toe datblog.example.comnaar203.0.113.10verwijst." - "Hernoem site abc naar Marketing Blog en herstart hem."
- "Toon mijn CDN cache hit rate deze week, en leeg daarna de cache."
- "Wat zit er in mijn laatste bestelling?"
De assistent heeft brede leestoegang, plus schrijfacties voor het hernoemen en herstarten van een site, DNS-records en -zones, CDN-caching en cache legen, edge rules en Shield-instellingen. Het volgende kan hij nooit doen, ongeacht wat je verleent: een site aanmaken, verwijderen of van formaat wijzigen; orders en facturatie plaatsen of wijzigen; back-ups en restores uitvoeren; of gebruikers, accounts of API-sleutels beheren. Gebruik daarvoor het dashboard of de REST API. De volledige lijst met beschikbare tools staat in de MCP-serverreferentie.
Als er iets misgaat
Veelvoorkomende problemen
- De kiezer toont "Geen geschikte workspace." Alleen betaalde workspaces op het merk waarop je hebt ingelogd, komen in aanmerking. Upgrade of wissel van merk en probeer opnieuw.
- De assistent zegt dat hij iets niet kan doen. Waarschijnlijk heb je dat recht niet verleend, of de actie is helemaal niet beschikbaar voor AI-clients (zie de lijst hierboven). Verbind opnieuw en verleen het bijbehorende recht, of gebruik het dashboard.
- Verbinden vanaf het verkeerde adres. Toegang is vergrendeld aan de merkhost waartegen je
hebt geautoriseerd. Als je
https://my.cloudpress.com/mcphebt toegevoegd maar elders inlogt, gebruik dan de host van je eigen merk in de URL.
Volgende stappen
- Probeer eerst een alleen-lezen verzoek, zoals "lijst mijn sites op", om de verbinding te bevestigen
- Bekijk de MCP-serverreferentie voor de volledige lijst met tools
- Leer hoe autorisatie achter de schermen werkt in OAuth 2.1
- Liever zelf scripten? Begin met het API-overzicht