Serveur MCP
Serveur MCP
Le serveur MCP officiel webgune-mcp expose votre compte webgune comme outils Model Context Protocol (nouvelle fenêtre) : 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
bun add -g webgune-mcp
# ou
npm install -g webgune-mcp
Authentification
Comme le 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
{
"mcpServers": {
"webgune": {
"command": "webgune-mcp",
"env": {
"WEBGUNE_API_KEY": "wgk_xxxxxxxx"
}
}
}
}
Avec Claude Code :
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 : les mêmes opérations depuis le terminal.
- Référence API : l'API HTTP sous-jacente.