Ga naar inhoud

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 (bijvoorbeeld brand.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.

  1. Open Claude's connectorinstellingen en voeg een custom connector toe (in huidige desktopbuilds, Customize → Connectors → Add custom connector).
  2. Geef hem een Name, bijvoorbeeld CloudPress.
  3. Stel de Remote MCP server URL in op https://my.cloudpress.com/mcp.
  4. Klik op Add.
  1. Open Codex' MCP-serverinstellingen en voeg een nieuwe server toe (in huidige desktopbuilds, Settings → MCP Servers → Add Server).
  2. Voer de server-URL https://my.cloudpress.com/mcp in. Er zijn geen andere velden nodig.
  3. 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."

  1. 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 dat blog.example.com naar 203.0.113.10 verwijst."
  • "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/mcp hebt 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