# Serveur MCP

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

# Serveur MCP

Le serveur MCP officiel `webgune-mcp` expose votre compte webgune comme outils [Model Context Protocol](https://modelcontextprotocol.io) : vous pouvez lister vos services, consulter des logs, relancer un déploiement ou vérifier vos factures directement depuis Claude (Desktop, Code) ou tout autre client MCP.

## Installation

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

## Authentification

Comme le [CLI](/docs/cli), le serveur MCP s'authentifie avec une **clé API** (préfixe `wgk_`), à créer depuis le dashboard : **Paramètres → Clés API**. La clé est passée via la variable d'environnement `WEBGUNE_API_KEY`.

Conseil : créez une clé dédiée avec des scopes limités. Pour un usage en lecture seule, `projects:read` + `services:read` + `billing:read` suffisent.

## Configuration

### Claude Desktop / Claude Code

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

Avec Claude Code :

```bash
claude mcp add webgune --env WEBGUNE_API_KEY=wgk_xxxxxxxx -- webgune-mcp
```

## Outils disponibles

| Outil | Description | Lecture seule |
|---|---|:---:|
| `list_projects` | Liste vos projets | ✓ |
| `list_services` | Liste vos services (filtre par projet possible) | ✓ |
| `get_service` | Détails d'un service | ✓ |
| `get_service_logs` | Logs d'exécution | ✓ |
| `list_deployments` | Historique des déploiements | ✓ |
| `redeploy_service` | Rebuild + redéploiement | Non |
| `restart_service` | Redémarrage | Non |
| `rollback_deployment` | Retour à un déploiement antérieur | Non |
| `list_plans` | Grille tarifaire | ✓ |
| `get_subscription` | Abonnement + état du mandat SEPA | ✓ |
| `list_invoices` | Factures | ✓ |
| `list_domains` | Noms de domaine | ✓ |

Les outils d'écriture (`redeploy_service`, `restart_service`, `rollback_deployment`) nécessitent le scope `services:write` sur la clé API. Sans lui, l'API répond 403 et l'action échoue.

## Exemple d'usage

Une fois configuré, demandez à Claude :

> « Liste mes services webgune et montre-moi les logs du service qui a le statut error. »

> « Rollback le service api-prod vers le déploiement précédent. »

## Voir aussi

- [CLI Webgune](/docs/cli) : les mêmes opérations depuis le terminal.
- [Référence API](/docs/reference-api) : l'API HTTP sous-jacente.