MCP-Server
MCP-Server
Der offizielle MCP-Server webgune-mcp exponiert Ihr webgune-Konto als Model Context Protocol (neues Fenster)-Tools: Sie können Ihre Dienste auflisten, Logs einsehen, ein Deployment neu starten oder Ihre Rechnungen prüfen, direkt von Claude (Desktop, Code) oder jedem anderen MCP-Client aus.
Installation
bun add -g webgune-mcp
# oder
npm install -g webgune-mcp
Authentifizierung
Wie das CLI authentifiziert sich der MCP-Server mit einem API-Schlüssel (Präfix wgk_), zu erstellen vom Dashboard aus: Einstellungen → API-Schlüssel. Der Schlüssel wird über die Umgebungsvariable WEBGUNE_API_KEY übergeben.
Tipp: erstellen Sie einen dedizierten Schlüssel mit eingeschränkten Scopes. Für einen reinen Lesezugriff genügen projects:read + services:read + billing:read.
Konfiguration
Claude Desktop / Claude Code
{
"mcpServers": {
"webgune": {
"command": "webgune-mcp",
"env": {
"WEBGUNE_API_KEY": "wgk_xxxxxxxx"
}
}
}
}
Mit Claude Code:
claude mcp add webgune --env WEBGUNE_API_KEY=wgk_xxxxxxxx -- webgune-mcp
Verfügbare Tools
| Tool | Beschreibung | Nur Lesen |
|---|---|---|
list_projects | Listet Ihre Projekte auf | ✓ |
list_services | Listet Ihre Dienste auf (Filter nach Projekt möglich) | ✓ |
get_service | Details eines Dienstes | ✓ |
get_service_logs | Ausführungslogs | ✓ |
list_deployments | Deployment-Historie | ✓ |
redeploy_service | Rebuild + Redeployment | Nein |
restart_service | Neustart | Nein |
rollback_deployment | Rückkehr zu einem früheren Deployment | Nein |
list_plans | Preisübersicht | ✓ |
get_subscription | Abonnement + SEPA-Mandatsstatus | ✓ |
list_invoices | Rechnungen | ✓ |
list_domains | Domainnamen | ✓ |
Die Schreib-Tools (redeploy_service, restart_service, rollback_deployment) erfordern den Scope services:write auf dem API-Schlüssel. Ohne ihn antwortet die API mit 403, und die Aktion schlägt fehl.
Anwendungsbeispiel
Nach der Konfiguration fragen Sie Claude einfach:
„Liste meine webgune-Dienste auf und zeig mir die Logs des Dienstes mit dem Status error."
„Rollback den Dienst api-prod zum vorherigen Deployment."
Siehe auch
- Webgune CLI: dieselben Operationen vom Terminal aus.
- API-Referenz: die zugrunde liegende HTTP-API.