Intégration des clients AI (IDE Integration)

ServBay permet d'intégrer en un clic le serveur MCP inclus à vos clients AI habituels, en configurant automatiquement les paramètres MCP requis sans intervention manuelle. Ce guide explique comment intégrer ServBay, quels clients sont pris en charge et les méthodes d’intégration propres à chaque client.

Prérequis

• ServBay doit être installé et en cours d’exécution.
• Le client AI cible doit être installé (ServBay vérifie la possibilité d’intégration selon la configuration du client).

Intégration en un clic

Accédez à Paramètres ServBay → Intégration de clients AI (IDE Integrations), repérez le client cible dans la liste et cliquez sur Intégrer (Integrate). ServBay effectuera alors les étapes suivantes :

1. Localise l’exécutable servbay-mcp inclus avec la distribution (pas besoin d’installation séparée).
2. Met à jour la configuration MCP du client ciblé selon ses spécifications (ajoute/modifie uniquement le nœud servbay, préserve vos autres configurations MCP).
3. Affiche l’état d’intégration.

Pour annuler l’intégration, cliquez simplement sur Supprimer (Remove).

État d’intégration

Chaque client affiche son état d’intégration par rapport à « cette instance locale de ServBay » :

État	Signification
Intégré	Le client pointe vers le servbay-mcp de cette machine
Intégré (autre chemin)	Le client utilise un nœud servbay mais pointe vers un autre chemin (par exemple une autre instance de ServBay)
Non intégré	Le client a été détecté mais n’est pas encore intégré
Non détecté	Aucun client correspondant trouvé sur cette machine

Clients pris en charge et méthodes d’intégration

Client	Méthode d’intégration	Emplacement de la configuration
Claude Code	CLI officiel : claude mcp add --scope user --transport stdio servbay -- <bin>	Configuration MCP utilisateur Claude Code
Codex	CLI officiel : codex mcp add (si la CLI n’est pas disponible, écrit dans ~/.codex/config.toml)	Configuration Codex
Cursor	Édite ~/.cursor/mcp.json (mcpServers au niveau racine)	~/.cursor/mcp.json
VS Code / GitHub Copilot	Ajoute dans le mcp.json utilisateur (servers au niveau racine, type: stdio)	mcp.json utilisateur VS Code
Claude Desktop	Écrit dans claude_desktop_config.json (mcpServers au niveau racine)	claude_desktop_config.json

Différences de schéma de configuration

Les clés de configuration MCP diffèrent selon le client : VS Code utilise servers, tandis que Cursor/Claude Desktop utilisent mcpServers. ServBay écrit automatiquement la bonne clé pour chaque client selon les spécifications ; vous n'avez pas à vous en préoccuper.

Vérification de l’intégration

Après intégration, lancez une requête liée à l’environnement depuis le client AI (par exemple « lister les services en cours sur ServBay »). Si l’AI retourne la liste réelle des services, l’intégration est réussie.

Foire aux questions (FAQ)

• Q : L’intégration va-t-elle écraser mes configurations MCP existantes ?
  • R : Non. ServBay ajoute ou met simplement à jour le nœud servbay et préserve tous les autres serveurs MCP déjà configurés.
• Q : Le client apparaît comme « Non détecté » ?
  • R : Cela signifie que le client n’est pas installé sur cette machine. Veuillez l’installer et le lancer au moins une fois avant d’intégrer.
• Q : Appel AI échoue après intégration ?
  • R : Assurez-vous que ServBay est bien lancé. Pour Claude Code et Codex en mode CLI, vérifiez que leur CLI officiel est disponible. Essayez de supprimer puis de réintégrer si nécessaire.
• Q : Que recommandez-vous après intégration ?
  • R : Nous recommandons d’installer les règles AI pour encourager l’AI à utiliser en priorité et correctement le MCP de ServBay.

Résumé

Grâce à l’intégration AI, il est possible de connecter ServBay MCP en un clic aux principaux outils AI, sans modification manuelle ni impact sur vos réglages existants. Une fois l’intégration terminée, en adoptant aussi les règles AI, vous permettez à l’AI de gérer parfaitement votre environnement de développement local.