MCP-GUIDE.md# 📘 CloudZIR MCP Server - Guide Complet
## Table des Matières
1. [Qu'est-ce que MCP ?](#quest-ce-que-mcp)
2. [Pourquoi CloudZIR a besoin d'un MCP ?](#pourquoi-cloudzir-a-besoin-dun-mcp)
3. [Architecture du Serveur](#architecture-du-serveur)
4. [Fonctionnalités Principales](#fonctionnalités-principales)
5. [Cas d'Usage Pratiques](#cas-dusage-pratiques)
6. [System Prompts CloudZIR](#system-prompts-cloudzir)
7. [Utilisation avec Claude Desktop](#utilisation-avec-claude-desktop)
8. [FAQ](#faq)
---
## 🤔 Qu'est-ce que MCP ?
**MCP = Model Context Protocol**
C'est un **protocole ouvert** créé par Anthropic qui permet aux modèles d'IA (Claude, etc.) de se connecter à des **serveurs externes** pour accéder à :
- Des données en temps réel
- Des contextes spécifiques
- Des instructions système personnalisées
- Des ressources et outils personnalisés
### Analogie simple :
```
Sans MCP: IA = Cerveau isolé, sans accès au monde réel
Avec MCP: IA = Cerveau connecté à des outils, des données, du contexte
(comme un expert qui peut consulter des manuels, des bases de données)
```
---
## 🎯 Pourquoi CloudZIR a besoin d'un MCP ?
### Le Problème
Quand vous demandez à une IA (Claude, ChatGPT) de travailler sur CloudZIR :
- ❌ L'IA n'a pas les **system prompts CloudZIR**
- ❌ L'IA ne connaît pas les **règles métier** de CloudZIR
- ❌ L'IA ne peut pas respecter les **standards de qualité** CloudZIR
- ❌ L'IA peut produire du code **incohérent** avec votre plateforme
- ❌ Chaque IA agit **différemment**, pas de cohérence
### La Solution : MCP CloudZIR
```
IA + MCP CloudZIR = IA qui comprend CloudZIR
= Code de même qualité
= Respect des règles CloudZIR
= Cohérence garantie
```
---
## 🏗️ Architecture du Serveur
### Structure du Projet
```
cloudzir-mcp-server/
├── src/
│ ├── index.ts # Point d'entrée MCP
│ └── prompts/
│ ├── system-prompts.ts # Tous les system prompts
│ └── cloudzir-context.ts # Contexte CloudZIR complet
├── dist/ # Code compilé
├── vercel.json # Config Vercel
├── package.json # Dépendances
├── tsconfig.json # Config TypeScript
└── README.md # Documentation
```
### Flux de Données
```
┌─────────────────┐
│ Claude Desktop │
│ ou autre IA │
└────────┬────────┘
│
│ Connexion MCP
▼
┌─────────────────────────┐
│ CloudZIR MCP Server │
│ (sur Vercel) │
├─────────────────────────┤
│ ✓ System Prompts │
│ ✓ CloudZIR Context │
│ ✓ Rules & Standards │
│ ✓ Technical Stack Info │
└────────┬────────────────┘
│
▼
IA Alignée
avec CloudZIR
```
---
## ⚙️ Fonctionnalités Principales
### 1. **Master System Prompt**
Le cerveau de CloudZIR transmis à chaque IA :
```typescript
// Régit le comportement de l'IA
- Zero approximation
- Production-ready par défaut
- Cohérence et logique strictes
- Sécurité intégrée
- Validation stricte des entrées
- Gestion d'erreurs obligatoire
- Pas d'incomplete responses
- Pas de placeholders vides
```
### 2. **Development Prompt**
Context spécifique pour développement :
- Standards de code
- Architecture composants
- Error handling
- Performance optimization
- Testing requirements
### 3. **Infrastructure Prompt**
Guidance pour cloud & deployment :
- Security-first approach
- Scalability planning
- Monitoring & observability
- Disaster recovery
- Infrastructure as Code
### 4. **CloudZIR Global Context**
Toutes les informations sur CloudZIR :
- Capabilities (applications, modules, websites, etc.)
- Core values & philosophy
- Technical stack (React, Node.js, TypeScript, etc.)
- Feature flags
- Business constraints
- Entity validation rules
---
## 💡 Cas d'Usage Pratiques
### ✅ Cas 1 : Développement avec IA assistante
**Avant (sans MCP):**
```
Vous: "Crée un composant React pour CloudZIR"
IA: ❌ Crée du code aléatoire, pas aux standards
```
**Après (avec MCP):**
```
Vous: "Crée un composant React pour CloudZIR"
IA: ✅ Crée un composant:
- Mobile-first responsive
- TypeScript avec types stricts
- Accessible (a11y)
- Performant (< 100ms)
- Cohérent avec CloudZIR
```
### ✅ Cas 2 : Code Review par IA
```
Code soumis → MCP Server → IA reçoit system prompts
IA: ✅ Valide contre standards CloudZIR:
- Architecture ok?
- Performance ok?
- Security ok?
- Error handling ok?
- Tests ok?
```
### ✅ Cas 3 : Architecture Decisions
```
Problème: "Comment scaler la base de données?"
IA: ✅ Résout en respectant CloudZIR:
- Évalue PostgreSQL vs MongoDB vs Supabase
- Considère la scalabilité
- Propose la sécurité
- Respecte les contraintes
```
### ✅ Cas 4 : Bug Fixing
```
Bug: "Pourquoi ce endpoint répond 500?"
IA: ✅ Debug en suivant CloudZIR rules:
- Validation stricte
- Error handling
- Logging
- Recovery plan
```
---
## 🧠 System Prompts CloudZIR
### Master Prompt (Extrait)
```
You are CloudZIR, the central AI intelligence of CloudZIR.
CloudZIR is a professional SaaS platform for creation,
configuration, management, and deployment of applications,
modules, websites, cloud services, and complex business systems.
CORE DNA:
- Premium Enterprise-ready SaaS positioning
- Vision: Intelligent automation with zero approximation
- Philosophy: Everything must have logic, utility, and purpose
- Standard: Production-ready by default
STRICT RULES:
1. Prohibition of incomplete responses
2. Prohibition of empty fields or unexplained placeholders
3. Prohibition of disconnected logic
4. Prohibition of orphaned modules
5. Prohibition of technical decisions without justification
```
### Request Handling Logic
```
When a request is:
✓ Vague → Restructure it
✓ Incomplete → Complete it
✓ Incoherent → Correct it
✗ Dangerous → Refuse with viable alternative
```
---
## 💻 Utilisation avec Claude Desktop
### Installation & Configuration
#### Step 1: Installer Claude Desktop
Télécharger depuis [claude.ai/desktop](https://claude.ai/desktop)
#### Step 2: Déployer CloudZIR MCP sur Vercel
```bash
# Le repo est déjà prêt!
git clone https://github.com/SourireConcept/cloudzir-mcp-server.git
cd cloudzir-mcp-server
# Déployer sur Vercel
vercel --prod
```
#### Step 3: Configurer Claude Desktop
Editer `~/.claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"cloudzir": {
"url": "https://YOUR_VERCEL_URL.vercel.app",
"command": "node",
"args": ["dist/index.js"]
}
}
}
```
#### Step 4: Redémarrer Claude Desktop
- Fermer l'app
- Rouvrir
- L'onglet "CloudZIR" apparaît dans le chat
### Utilisation
```
Claude: "Je suis connecté au serveur CloudZIR MCP"
Vous: "Crée un composant form CloudZIR"
Claude (avec system prompts CloudZIR):
✓ Crée le composant TypeScript
✓ Respecte mobile-first
✓ Inclut validation stricte
✓ Gère les erreurs
✓ Suivre les standards
```
---
## ❓ FAQ
### Q1: Qu'est-ce qui se passe si l'IA ignore les system prompts?
R: L'IA reçoit continuellement les prompts. Si elle viole, vous pouvez:
- Lui rappeler les règles CloudZIR
- La rediriger
- Rafraîchir la connexion MCP
### Q2: Puis-je utiliser MCP avec ChatGPT?
R: MCP est créé par Anthropic, optimisé pour Claude. ChatGPT a son propre système (GPTs). Mais vous pouvez créer une intégration similaire pour ChatGPT.
### Q3: Le serveur MCP rajoute de la latence?
R: Minimal:
- Server sur Vercel = très rapide (<100ms)
- Cache des prompts
- Connexion directe IA ↔ Server
### Q4: Puis-je ajouter mes propres prompts?
R: Oui! Éditez `src/prompts/system-prompts.ts`:
```typescript
export const SYSTEM_PROMPTS = {
master: "...",
custom: "Votre prompt custom ici",
// ...
}
```
### Q5: Comment tester le serveur localement?
R:
```bash
npm install
npm run dev
# Teste localhost:3000
```
### Q6: Puis-je versioner les prompts?
R: Oui! Git track tous les changements:
```bash
git log src/prompts/system-prompts.ts
```
---
## 🚀 Prochaines Étapes
### Immediate
1. ✅ Déployer sur Vercel
2. ✅ Configurer Claude Desktop
3. ✅ Tester avec une tâche simple
### Court Terme
1. Ajouter des tools personnalisés (database queries, etc.)
2. Ajouter des ressources (documentation, schemas, etc.)
3. Implémenter des logging & monitoring
### Moyen Terme
1. Créer des prompts spécialisés par rôle (Dev, DevOps, PM, etc.)
2. Intégrer avec vos APIs CloudZIR
3. Ajouter du versioning intelligent des prompts
### Long Terme
1. Créer des MCP servers spécialisés pour chaque module CloudZIR
2. Federation entre serveurs MCP
3. Dashboard de gestion centralisée
---
## 📚 Ressources
- [Model Context Protocol - Anthropic](https://modelcontextprotocol.io/)
- [Claude Desktop Setup](https://claude.ai/desktop)
- [Vercel Deployment Docs](https://vercel.com/docs)
- [CloudZIR Documentation](https://cloudzir.dev) - Coming soon!
---
## 🔗 Liens Rapides
- **Repository**: https://github.com/SourireConcept/cloudzir-mcp-server
- **Issues**: https://github.com/SourireConcept/cloudzir-mcp-server/issues
- **Discussions**: https://github.com/SourireConcept/cloudzir-mcp-server/discussions
---
**Créé avec ❤️ par Sourire Concept**
_Version: 1.0.0 | Dernière mise à jour: January 14, 2026_
