Aller au contenu principal

Guide d'Utilisation

Ce guide fournit des instructions détaillées sur la manière d'installer, de configurer et d'utiliser le serveur MCP de CWCloud.

Prérequis​

Installation​

Option 1 : Cloner et Compiler​

# Cloner le dépôt
git clone https://github.com/cwloudtech/cwcloud-mcp.git
cd cwcloud-mcp

# Compiler le serveur
go build -o cwcloud-mcp ./cmd/server

# Rendre le fichier exécutable
chmod +x cwcloud-mcp

Option 2 : Installation Directe​

# Installer directement depuis la source
go install github.com/cwloudtech/cwcloud-mcp/cmd/server@latest

Configuration​

Configuration de l'Environnement​

Créez un fichier .env à la racine du projet :

# Copier la configuration d'exemple
cp .env.example .env

Modifiez .env avec vos informations d'identification CWCloud :

# Configuration de l'API CWCloud
COMWORK_API_URL=https://api.cwcloud.tech
COMWORK_ACCESS_KEY=votre_cle_d_acces_ici
COMWORK_SECRET_KEY=votre_cle_secrete_ici

# Configuration du Serveur (optionnel)
SERVER_PORT=8080
LOG_LEVEL=info

Obtenir Vos Clés API​

  1. Connectez-vous à votre Tableau de Bord CWCloud
  2. Naviguez vers Informations d'identification → Clés API
  3. Générez une nouvelle paire de clés API
  4. Copiez la clé d'accès et la clé secrète dans votre fichier .env

Démarrage Rapide​

Guide d'Intégration Github Copilot (Recommandé)​

La manière la plus rapide de démarrer avec le serveur MCP de CWCloud et GitHub Copilot :

# Cloner et naviguer vers le projet
git clone https://github.com/cwloudtech/cwcloud-mcp.git
cd cwcloud-mcp

# Exécuter la configuration automatisée
./setup-github-copilot.sh

Cela va :

  • Compiler le serveur
  • Configurer vos informations d'identification API CWCloud
  • Mettre en place l'intégration MCP de VS Code
  • Tester la connexion

Consultez le Guide d'Intégration Github Copilot pour un guide d'installation détaillé

Test Manuel​

# Exécuter des tests interactifs avec la fonctionnalité IA
./test-interactive.sh

Se Connecter avec les Clients MCP​

GitHub Copilot​

Après avoir exécuté ./setup-github-copilot.sh, redémarrez VS Code et utilisez :

  • #generate_ai_prompt - Générer des réponses IA
  • #list_conversations - Lister l'historique des conversations
  • #list_adapters - Lister les adaptateurs IA disponibles

Utilisation de Docker​

Construire l'Image Docker​

# Construire l'image Docker
docker build -t cwcloud-mcp .

Exécuter avec des Variables d'Environnement​

# Méthode 1 : Utiliser des variables d'environnement individuelles
docker run -i --rm \
  -e COMWORK_API_URL=https://api.cwcloud.tech \
  -e COMWORK_ACCESS_KEY=votre_cle_d_acces \
  -e COMWORK_SECRET_KEY=votre_cle_secrete \
  -e LOG_LEVEL=info \
  cwcloud-mcp

# Méthode 2 : Utiliser un fichier d'environnement
docker run -i --rm --env-file .env.docker cwcloud-mcp

Tester le Conteneur Docker​

# Tester le protocole MCP (fonctionnalité de base)
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {"tools": {}}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | \
docker run -i --rm --env-file .env.docker cwcloud-mcp

# Tester la génération IA
echo '{"jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": {"name": "generate_ai_prompt", "arguments": {"adapter": "gpt4o", "message": "Bonjour le monde!"}}}' | \
docker run -i --rm --env-file .env.docker cwcloud-mcp

# Tester le listage des conversations
echo '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "list_conversations", "arguments": {}}}' | \
docker run -i --rm --env-file .env.docker cwcloud-mcp

Outils Disponibles​

  • #generate_ai_prompt: Générer des réponses IA en utilisant divers modèles (GPT-4, Claude, Gemini).
  • #list_conversations: Lister et gérer votre historique de conversations IA.
  • #list_adapters: Lister tous les adaptateurs IA disponibles et leur statut actuel.

Modèles d'IA Supportés:

  • gpt4o, gpt4o-mini - Variantes OpenAI GPT-4
  • claude3sonnet, claude3haiku - Anthropic Claude 3
  • gemini, gemini-pro - Google Gemini
  • openmistral - OpenMistral

Pour des exemples d'utilisation détaillés, consultez le Guide d'Intégration Github Copilot