Keep/mcp-server/N8N-SETUP.md

Guide d'Installation Rapide - Workflows N8N

🚀 Installation en 5 minutes

Prérequis

• ✅ N8N installé et en cours d'exécution (http://localhost:5678)
• ✅ Keep Notes en cours d'exécution (http://localhost:3000)
• ✅ Clé API OpenAI (optionnel mais recommandé)

---

📥 Étape 1: Importer les Workflows

Option A: Import individuel (recommandé pour commencer)

1. Ouvrez N8N dans votre navigateur: http://localhost:5678
2. Cliquez sur "Import from File" dans le menu supérieur
3. Sélectionnez un des fichiers JSON:
   • n8n-workflow-create-note.json
   • n8n-workflow-search-summary.json
   • n8n-workflow-notebook-management.json
   • n8n-workflow-reminder-notifications.json
   • n8n-workflow-label-management.json
   • n8n-workflow-email-integration.json
4. Le workflow apparaîtra dans l'éditeur

Option B: Import en masse (avancé)

Utilisez le script PowerShell fourni:

.\import-workflows.ps1

---

⚙️ Étape 2: Configurer les Variables d'Environnement

Dans N8N, allez dans Settings → Variables et ajoutez:

KEEP_NOTES_API_URL=http://localhost:3000
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/XXX
EMAIL_ADDRESS=votre_email@gmail.com
EMAIL_PASSWORD=votre_app_password
OPENAI_API_KEY=sk-proj-XXX

---

🔌 Étape 3: Configurer les Connexions

3.1 Connexion Keep Notes API

Les workflows utilisent déjà l'URL http://localhost:3000/api par défaut.

Si Keep Notes est sur une autre URL:

1. Ouvrez un workflow
2. Cherchez les noeuds "Keep Notes - Create Note", "Get All Notes", etc.
3. Modifiez l'URL dans le champ "URL"

3.2 Connexion Slack

Pour les notifications Slack:

1. Créez un Incoming Webhook sur Slack
2. Copiez l'URL du webhook
3. Dans le workflow "Reminder Notifications", modifiez le noeud "Send Notification"
4. Remplacez l'URL du webhook

3.3 Connexion Email (IMAP)

Pour le workflow "Email to Note":

1. Activez l'accès IMAP pour votre email (ex: Gmail)
2. Si 2FA activé, générez un "App Password"
3. Configurez le noeud "Email Trigger":
   • Host: imap.gmail.com (pour Gmail)
   • Email: votre adresse
   • Password: votre mot de passe/app password

3.4 Connexion OpenAI (Optionnel)

Pour la classification et les résumés:

1. Allez dans Credentials → Add Credential
2. Sélectionnez OpenAI API
3. Entrez votre clé API
4. Dans chaque workflow avec noeud "AI Classifier", "AI Summarizer" ou "AI Suggest Labels":
   • Sélectionnez les crédtentiels OpenAI créés

---

▶️ Étape 4: Activer les Workflows

Pour chaque workflow importé:

1. Cliquez sur le bouton "Activate" (icône play en haut à droite)
2. Le workflow deviendra actif et s'exécutera selon son déclencheur

---

🧪 Étape 5: Tester

Tester "Create Note with Classification"

1. Activez le workflow
2. Utilisez le MCP Trigger ou envoyez une requête POST
3. Vérifiez qu'une note est créée dans Keep Notes

curl -X POST http://localhost:5678/webhook/keep-notes-create \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Meeting with client next week to discuss project timeline",
    "color": "blue"
  }'

Tester "Reminder Notifications"

1. Activez le workflow
2. Créez une note avec un rappel dans les 30 prochaines minutes
3. Attendez le déclenchement automatique
4. Vérifiez les notifications Slack/Email

---

🎯 Workflows par ordre de priorité

Débutant (Commencez par ceux-ci)

1. Notebook Manager - Plus simple, aucune dépendance externe
2. Label Manager - Gestion de base avec option IA
3. Create Note with Classification - Fonctionnalité principale

Intermédiaire

4. Search & Summary - Requiert OpenAI pour les résumés
5. Reminder Notifications - Requiert Slack/Email configuré

Avancé

6. Email to Note - Plus complexe, requiert configuration IMAP

---

📊 Vue d'ensemble des Dépendances

Workflow	Keep Notes	OpenAI	Slack	Email (IMAP)
Create Note	✅	⭐	-	-
Search & Summary	✅	✅	-	-
Notebook Manager	✅	-	-	-
Reminder Notifications	✅	-	✅	⭐
Label Manager	✅	⭐	-	-
Email to Note	✅	✅	⭐	✅

Légende:

• ✅ = Requis
• ⭐ = Optionnel (pour fonctionnalités avancées)
• • = Non requis

---

🔧 Personnalisation Rapide

Modifier l'URL de l'API Keep Notes

Dans tous les fichiers JSON, recherchez:

"url": "http://localhost:3000/api/..."

Remplacez par votre URL réelle:

"url": "https://votre-domaine.com/api/..."

Désactiver les notifications d'un workflow

1. Ouvrez le workflow
2. Supprimez ou désactivez les noeuds de notification
3. Sauvegardez et réactivez

---

📈 Monitoring

Voir les exécutions

1. Allez dans Executions dans le menu latéral
2. Filtrez par workflow
3. Cliquez sur une exécution pour voir les détails
4. Les données d'entrée/sortie sont visibles pour chaque noeud

Activer les logs détaillés

Dans Settings → Executions, cochez:

• ✅ Save data for failed executions
• ✅ Save data for successful executions

---

🆘 Support et Dépannage

Erreurs courantes

"Connection refused to localhost:3000"

• → Vérifiez que Keep Notes est démarré

"AI classification failed"

• → Vérifiez votre clé OpenAI API

"Email trigger not working"

• → Activez l'accès IMAP ou utilisez un App Password

"Slack notification failed"

• → Vérifiez l'URL du webhook Slack

Obtenir de l'aide

1. Consultez N8N-WORKFLOWS.md pour la documentation détaillée
2. Vérifiez les logs d'exécution dans N8N
3. Testez chaque workflow individuellement

---

🎉 Prochaines étapes

Une fois les workflows configurés:

1. ✅ Explorez les workflows en mode test
2. ✅ Adaptez les prompts IA selon vos besoins
3. ✅ Créez des workflows personnalisés basés sur les exemples
4. ✅ Intégrez avec d'autres services (Notion, Google Drive, etc.)

---

📚 Ressources utiles

• Documentation N8N
• Guide MCP Protocol
• Documentation Keep Notes
• Documentation complète des workflows

---

Temps estimé: 5-10 minutes par workflow

Difficulté: Variable de ⭐ à ⭐⭐⭐

Support: Issues GitHub