Vimonto Deploy heeft een ingebouwde MCP-server, zodat AI-assistenten zoals Claude Code, Claude Desktop, Cursor en VS Code met je organisaties kunnen werken: servers en sites opvragen, een site deployen en die deploy volgen, de uitvoer van een mislukte taak lezen, een database maken, en back-ups en recepten uitvoeren. MCP, het Model Context Protocol, is de open standaard waarmee deze assistenten tools in andere applicaties aanroepen.
De MCP-server is de API in een andere vorm. Hij logt in met een persoonlijk API-token, en de assistent kan precies doen wat dat token en jouw rol toestaan, op de servers waartoe je toegang hebt. Er kan niets mee worden verwijderd.
Hoe koppel je een assistent?
- Open het accountmenu rechtsboven en kies Accountinstellingen → API-tokens.
- Klik op Nieuw token, geef het een Naam zoals "Claude Code" en kies de Scopes (zie scopes). Voor een assistent die alleen rondkijkt is Lezen genoeg.
- Klik op Token maken.
- Het venster Je nieuwe token toont het token en, onder Een AI-assistent koppelen, een Prompt met je token en adres al ingevuld. Klik op Kopiëren en plak hem in Claude Code, Cursor, VS Code of Claude Desktop: de assistent voegt de koppeling toe aan zijn eigen configuratie, laat de servers die je al hebt staan, zegt of je hem opnieuw moet starten en controleert of de verbinding werkt.
Liever zelf instellen? De tabs Claude Code, Claude Desktop, Cursor en VS Code naast Prompt tonen de opdracht of configuratie voor elk, ook met je token en adres al ingevuld, zoals hieronder beschreven.
Het token wordt één keer getoond. Sluit je het venster, dan is ook de configuratie met het token weg; maak een nieuw token als je het opnieuw nodig hebt. De sectie AI-assistenten op dezelfde pagina toont het adres van de MCP-server altijd.
Het serveradres is /mcp op het adres waar je Vimonto Deploy gebruikt, zoals https://deploy.example.com/mcp. Hij spreekt het Streamable HTTP-transport en verwacht het token als bearer token in de Authorization-header. Vervang in de voorbeelden hieronder deploy.example.com door je eigen adres en YOUR_TOKEN door het token.
Claude Code
Voer dit uit in je terminal:
claude mcp add --transport http vimonto-deploy https://deploy.example.com/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Voeg --scope user toe om het in elk project te gebruiken, niet alleen in het huidige. Controleer het met claude mcp list, of /mcp binnen Claude Code.
Cursor
Voeg dit toe aan ~/.cursor/mcp.json (elk project) of .cursor/mcp.json in een project:
{
"mcpServers": {
"vimonto-deploy": {
"url": "https://deploy.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
VS Code
Voeg dit toe aan .vscode/mcp.json in een project, of voer MCP: Open User Configuration uit in het opdrachtenpalet voor elk project:
{
"servers": {
"vimonto-deploy": {
"type": "http",
"url": "https://deploy.example.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Claude Desktop en andere assistenten die alleen lokale servers starten
Het configuratiebestand van Claude Desktop start alleen lokale MCP-servers. mcp-remote verbindt zo'n assistent met een externe server; je hebt Node.js nodig. Open in Claude Desktop Settings → Developer → Edit Config, voeg dit toe aan claude_desktop_config.json en start Claude opnieuw:
{
"mcpServers": {
"vimonto-deploy": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://deploy.example.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
"env": {
"AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}
Het token staat in env in plaats van in args, omdat sommige systemen argumenten bij spaties splitsen. Dezelfde configuratie werkt in elke assistent die alleen een commando kan starten.
Wat kan de assistent doen?
De scopes van het token bepalen welke tools de assistent überhaupt ziet. Een tool waarvoor het token geen scope heeft, staat niet in de lijst en kan niet worden aangeroepen.
| Scope | Tools |
|---|---|
| Lezen | Alles wat leest: organisaties, servers, sites, deployments, taken, databases, back-ups en recepten. |
| Deploy | list_organizations, list_sites (één site, op domein of ID), list_deployments, get_deployment, deploy_site en get_task. |
| Schrijven | Alles wat Lezen toestaat, plus deploy_site, create_database, run_backup en run_recipe. |
Daar bovenop wordt je rol gecontroleerd, precies zoals in de app en de API: deployen vraagt een rol die sites mag beheren, een database maken een rol die servers mag beheren, enzovoort. Het token van een kijker kan lezen, maar elke wijziging wordt geweigerd. Met teamtoegang bestaan servers buiten je teams en hun sites niet voor de assistent.
De tools
| Tool | Scopes | Wat hij doet |
|---|---|---|
list_organizations |
elke | Van wie het token is, zijn scopes, en je organisaties met je rol in elk. |
list_servers |
lezen, schrijven | De servers van de organisatie waartoe je toegang hebt. |
get_server |
lezen, schrijven | Eén server: type, status, provider, IP-adressen, PHP-versie, database. |
list_sites |
lezen, deploy, schrijven | Sites op je servers, gefilterd op domein, site-ID of server. Met alleen Deploy is een domein of site-ID verplicht. |
get_site |
lezen, schrijven | Eén site, op ID of domein. |
list_deployments |
lezen, deploy, schrijven | De deployments van een site, nieuwste eerst, 25 per pagina. |
get_deployment |
lezen, deploy, schrijven | Eén deployment met zijn commit en taak. |
deploy_site |
deploy, schrijven | Deployt de branch van de site, zoals Deployen. |
get_task |
lezen, deploy, schrijven | De status, stap, voortgang, fout en laatste regels uitvoer van een taak. |
list_databases |
lezen, schrijven | De databases van een server. |
create_database |
schrijven | Maakt een lege database op een server. |
list_backups |
lezen, schrijven | De back-upconfiguraties van een server met hun laatste back-ups. |
run_backup |
schrijven | Voert een back-upconfiguratie nu uit. |
list_recipes |
lezen, schrijven | De recepten van de organisatie met hun scripts. |
run_recipe |
schrijven | Voert een recept uit op een of meer servers. |
Elke tool neemt een organization (de slug); de assistent mag hem weglaten als je maar bij één organisatie hoort. Sites kunnen bij hun domein worden genoemd, dus je kunt gewoon vragen: "Deploy shop.example.com en laat het me weten als hij live is."
Deploys, databases, back-ups en recepten draaien als achtergrondtaken. De tool antwoordt meteen met een taak-ID, en de assistent volgt de taak met get_task tot hij is geslaagd of mislukt. Mislukt een deploy, dan leest hij de fout en het einde van de uitvoer, wat meestal genoeg is om je te vertellen waarom.
Wat niet kan
Er zijn geen tools die iets verwijderen: geen databases, sites of servers verwijderen. Ook servers en sites maken, omgevingsbestanden wijzigen en domeinen beheren is niet mogelijk; gebruik daarvoor de app.
Is het veilig?
- Alleen tokens. Ingelogd zijn in de app in je browser opent de MCP-server niet; elk verzoek heeft een geldig, niet-verlopen API-token nodig. Het token intrekken onder API-tokens koppelt de assistent meteen los.
- Nooit meer dan jij. De assistent handelt als jij, beperkt door de scopes van het token, je huidige rol en je servertoegang. Verandert je rol, dan verandert het bereik van de assistent mee.
- Geen geheimen. Wachtwoorden, SSH-sleutels,
.env-bestanden, deploy-URL's en tokens zijn nooit onderdeel van een antwoord. Taakuitvoer en receptscripts worden getoond zoals in de app, dus print geen geheimen in deployscripts. - Alles wordt gelogd. Wijzigingen door een assistent verschijnen in het auditlog onder jouw naam, met de naam van het token ("API token Claude Code").
- Met een limiet. Elk token mag 120 verzoeken per minuut doen, gedeeld met de API.
- Je assistent vraagt eerst. Tools die iets wijzigen zijn als zodanig gemarkeerd, zodat assistenten om je goedkeuring vragen voordat ze deployen of een recept uitvoeren. Deployen en recepten uitvoeren zijn als destructief gemarkeerd, omdat ze veranderen wat er op je servers draait.
Veelgestelde vragen
Welke assistenten werken?
Elke assistent die externe MCP-servers via Streamable HTTP met een eigen header ondersteunt, zoals Claude Code, Cursor en VS Code. Assistenten die alleen lokale servers starten, zoals Claude Desktop via het configuratiebestand, verbinden via mcp-remote.
Waarom zegt de assistent dat een server of site niet bestaat?
Hij bestaat niet in die organisatie, of je hebt er geen toegang toe: je teamtoegang verbergt servers buiten je teams. Controleer ook of de assistent de juiste organisatie gebruikt; list_organizations toont ze.
Waarom ziet de assistent een tool niet?
Het token heeft er geen scope voor. Een Lezen-token kan bijvoorbeeld niet deployen. Maak een nieuw token met de scope die je nodig hebt en vervang het token in de configuratie van de assistent.
Kan ik hetzelfde token voor de API, de CLI en een assistent gebruiken?
Ja, maar aparte tokens zijn veiliger: je kunt er een intrekken zonder de andere te breken, en het auditlog toont welk token een wijziging maakte.