# MCP-Server

Source : https://webgune.cloud/de-de/docs/mcp · Mis à jour le 2026-10-27

# MCP-Server

Der offizielle MCP-Server `webgune-mcp` exponiert Ihr webgune-Konto als [Model Context Protocol](https://modelcontextprotocol.io)-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

```bash
bun add -g webgune-mcp
# oder
npm install -g webgune-mcp
```

## Authentifizierung

Wie das [CLI](/docs/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

```json
{
  "mcpServers": {
    "webgune": {
      "command": "webgune-mcp",
      "env": {
        "WEBGUNE_API_KEY": "wgk_xxxxxxxx"
      }
    }
  }
}
```

Mit Claude Code:

```bash
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](/docs/cli): dieselben Operationen vom Terminal aus.
- [API-Referenz](/docs/reference-api): die zugrunde liegende HTTP-API.