Ga naar inhoud

Verbinden met onze MCP-server

Wat dit is

SuperSpace 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. Deze pagina leidt een nieuwkomer door het toevoegen van de server, één keer inloggen, en wat de assistent daarna kan doen.

De MCP-server is hetzelfde als wat je AI-client aanroept wanneer die "SuperSpace gebruikt." Je voegt hem één keer toe in je client, logt in op SuperSpace 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 SuperSpace-workspace. Proefworkspaces kunnen geen AI-clients of andere apps autoriseren — je moet eerst upgraden of een betaalde workspace aanmaken.1
  • Een AI-client die remote MCP-servers ondersteunt (bijvoorbeeld Claude of OpenAI Codex).
  • Je SuperSpace-merkhost. De meeste mensen gebruiken control.superspace.nl. Als je inlogt op een white-label-adres (bijvoorbeeld brand.example.com), gebruik dan die host in plaats daarvan.

Hoe het werkt

De SuperSpace MCP-server staat op één URL — https://control.superspace.nl/mcp — en je client verbindt er rechtstreeks mee via internet. Er is niets te downloaden en geen configuratiebestand om te bewerken voor moderne clients. Je plakt geen token of wachtwoord: wanneer je de server toevoegt, stuurt je client je naar SuperSpace in je browser om in te loggen en toegang goed te keuren, en de verleende toegang wordt automatisch voor je opgeslagen.
Server-URL https://control.superspace.nl/mcp
Wat je invoert Alleen de URL — vooraf geen tokens, headers of wachtwoorden
Hoe je autoriseert Een keer inloggen en goedkeuren in de browser, nadat je de server hebt toegevoegd

Gebruik je eigen merkhost

Vervang control.superspace.nl 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 SuperSpace toe als remote MCP-server met de bovenstaande URL. De exacte menubewoording hangt af van je client.

Claude ondersteunt SuperSpace 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 SuperSpace.
  3. Stel de Remote MCP server URL in op https://control.superspace.nl/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://control.superspace.nl/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 SuperSpace- 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 SuperSpace

Je client opent een SuperSpace-pagina in je browser. Log in met je gewone SuperSpace- e-mailadres en wachtwoord als je nog niet bent ingelogd.

Dit is de standaard beveiligde OAuth-aanmelding — hetzelfde soort "Log in om deze app te autoriseren"-flow die je elders hebt gezien. Je AI-client ziet nooit je wachtwoord; hij ontvangt alleen beperkte toegang die je in de volgende stap goedkeurt. Voor de onderliggende details, zie OAuth 2.1.

3. Kies een workspace

SuperSpace toont een autorisatiescherm met de titel Authorize (de naam van je client), met de prompt "Choose a workspace and review the permissions this application is requesting."

  1. Open onder Workspace de kiezer (gelabeld Choose a workspace…) en selecteer de SuperSpace-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

Alleen je betaalde (niet-proef) workspaces op het huidige merk verschijnen in de kiezer. Als je in plaats daarvan een pagina No eligible 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 Permissions 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
View sites Je sites opsommen en hun configuratie en statistieken lezen
Manage sites Sites aanmaken, wijzigen en verwijderen
View domains Domeinen opsommen en registratiegegevens lezen
Manage domains Domeinen registreren, wijzigen en verwijderen
View DNS DNS-zones en -records opsommen
Manage DNS DNS-zones en -records aanmaken, wijzigen en verwijderen
View billing Abonnementen en orders lezen — geen betalingswijzigingen

Als je tevreden bent met de selectie, klik je op Authorize. Om eruit te stappen zonder iets te verlenen, klik je op Cancel.2

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 een zorgvuldig samengestelde set veilige schrijfacties — site hernoemen en herstarten, DNS-records en -zones, CDN-caching en cache legen, edge rules en Shield-instellingen. Een handvol gevoelige acties zijn opzettelijk verboden voor AI-clients, ongeacht wat je verleent: een site aanmaken, verwijderen of van formaat wijzigen; orders en facturatie plaatsen of wijzigen; back-ups en restores; en het beheren van gebruikers, accounts of API-sleutels. Gebruik daarvoor het dashboard of de REST API. De volledige, gezaghebbende lijst met beschikbare tools staat in de MCP-serverreferentie.

Schrijfacties zijn beschermd tegen onbedoelde herhalingen

Elke wijziging die de assistent maakt, wordt getagd zodat een automatische herhaling niet per ongeluk hetzelfde twee keer kan doen (bijvoorbeeld een record twee keer aanmaken). Je hoeft niets te doen — het wordt voor je geregeld.

Als er iets misgaat

Veelvoorkomende problemen

  • De kiezer accepteert je workspace niet, of toont "No eligible workspace." Alleen betaalde workspaces op het merk waarop je hebt ingelogd, komen in aanmerking. Proefworkspaces en workspaces op een ander merk zijn uitgesloten. 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://control.superspace.nl/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

  1. Proefworkspaces zijn geblokkeerd voor het autoriseren van apps en verschijnen niet in de workspacekiezer. Dit is een bewuste beveiliging, geen bug. ↩

  2. Op het autorisatiescherm is de uitstapknop gelabeld Cancel; erop klikken weigert het verzoek en verleent niets. ↩